4步实现YYeTsBot容器化部署：从环境诊断到性能优化

YYeTsBot作为集成人人影视资源和网友网盘分享的智能机器人，采用容器化部署可实现环境隔离、服务编排和快速交付。本文将通过"问题-方案-实践-优化"框架，帮助您在保证部署效率的同时，构建稳定可靠的机器人服务。

环境诊断：部署前的准备清单

在开始容器化部署前，让我们先确认您的环境是否满足基本要求。容器化部署需要Docker引擎提供运行时环境，Docker Compose进行服务编排，以及足够的系统资源保障服务稳定运行。

系统需求检查

您的服务器满足这些条件吗？

• Docker Engine 20.10+：提供容器运行环境
• Docker Compose 2.0+：用于多容器服务编排
• 至少2GB可用内存：保障应用顺畅运行
• 10GB可用磁盘空间：存储镜像和数据

必备文件确认

项目根目录下需要存在这些关键文件：

• Dockerfile：定义应用构建过程
• docker-compose.yml：编排服务组件
• requirements.txt：Python依赖列表
• conf/yyets.env：环境变量配置文件

部署实施：3步完成容器化部署

步骤1：获取项目代码

首先克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/yy/YYeTsBot
cd YYeTsBot  # 进入项目目录

步骤2：配置环境变量

🛠️ 配置核心环境变量，编辑conf/yyets.env文件：

# 数据库配置
DB_HOST=db  # 使用docker-compose中的服务名作为主机名
DB_PORT=5432
DB_NAME=yyets
DB_USER=postgres
DB_PASSWORD=your_secure_password

# 机器人配置
BOT_TOKEN=your_telegram_bot_token  # 替换为实际的Telegram机器人令牌

步骤3：启动服务栈

使用Docker Compose一键启动所有服务组件：

docker-compose up -d  # 后台启动服务栈

这条命令会自动完成：镜像构建、数据库初始化、网络配置和服务启动等一系列操作。

验证体系：确保部署成功的检查清单

部署完成后，需要从多个维度验证服务状态，确保系统正常运行。

容器状态检查

docker-compose ps  # 查看所有服务容器状态

正常情况下，所有服务状态应显示为"Up"。如果出现"Exit"状态，需要查看日志排查问题。

服务日志检查

docker-compose logs -f yyetsbot  # 实时查看机器人服务日志

确认日志中没有错误信息，且出现类似"Bot started successfully"的启动成功提示。

功能验证

通过Telegram发送命令测试机器人响应，或访问Web界面检查资源列表：

性能调优：从稳定运行到高效服务

容器资源动态调整

⚡ 优化容器资源配置，编辑docker-compose.yml文件：

services:
  yyetsbot:
    deploy:
      resources:
        limits:
          cpus: '1.0'  # CPU核心限制
          memory: 1G   # 内存限制
        reservations:
          cpus: '0.5'  # 保证CPU资源
          memory: 512M # 保证内存资源

根据实际运行情况调整这些参数，避免资源浪费或不足。

数据持久化策略

为防止数据丢失，确保关键数据目录已挂载为卷：

volumes:
  - ./data:/app/data        # 应用数据
  - ./logs:/app/logs        # 日志文件
  - postgres_data:/var/lib/postgresql/data  # 数据库数据

健康检查配置

📊 配置容器健康检查，及时发现并恢复异常服务：

services:
  yyetsbot:
    healthcheck:
      test: ["CMD", "python", "-m", "yyets.healthcheck.check"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s

跨平台部署兼容性

YYeTsBot容器化部署支持多种操作系统环境：

• Linux：原生支持，推荐生产环境使用
• Windows：通过WSL2运行Docker Desktop
• macOS：使用Docker Desktop for Mac

常见问题解决方案

容器启动失败

• 检查端口占用情况：netstat -tulpn
• 验证环境变量配置：cat conf/yyets.env
• 查看详细错误日志：docker-compose logs --tail=100 yyetsbot

数据库连接问题

• 确认数据库服务状态：docker-compose ps db
• 检查数据库初始化日志：docker-compose logs db
• 验证网络连通性：docker exec -it yyetsbot ping db

维护最佳实践

1. 定期备份数据：使用scripts/目录下的备份脚本
2. 监控系统状态：集成Prometheus和Grafana进行性能监控
3. 定期更新镜像：保持依赖库和基础镜像最新
4. 实施日志轮转：避免日志文件占用过多磁盘空间

通过本文介绍的容器化部署方案，您已经掌握了YYeTsBot从环境准备到性能优化的完整流程。容器化部署不仅解决了环境依赖问题，还通过服务编排实现了系统的可扩展性和可维护性。随着用户量增长，您可以根据实际需求调整资源配置，确保服务始终保持最佳状态。