如何在5分钟内搭建个人影视资源管理平台：YYeTsBot容器化部署指南

YYeTsBot是一款集成人人影视全部资源和网友网盘分享的智能机器人，通过Docker容器化部署可实现环境隔离、快速安装和便捷运维。本文将从项目价值、环境准备、部署流程到性能优化，全方位指导你搭建属于自己的影视资源管理系统，让资源搜索和管理变得高效简单。

为什么选择YYeTsBot？项目核心价值解析

YYeTsBot作为开源影视资源管理解决方案，具有三大核心优势：

• 资源聚合：整合人人影视官方资源与网友分享的网盘链接，提供一站式影视搜索服务
• 多端支持：通过Telegram机器人和Web界面双端访问，满足不同场景使用需求
• 容器化部署：采用Docker技术实现环境隔离，避免依赖冲突，简化安装维护流程

图1：YYeTsBot Telegram聊天界面展示，用户可直接通过对话获取影视资源

环境准备清单：部署前的必要检查

在开始部署前，请确保你的系统满足以下要求：

硬件要求

• 至少2GB可用内存
• 10GB以上可用磁盘空间
• 互联网连接（用于拉取镜像和资源）

软件要求

• Docker Engine 20.10或更高版本
• Docker Compose 2.0或更高版本
• Git工具（用于克隆项目代码）

必备文件

项目中已包含所有必要配置文件，无需额外下载：

• Dockerfile：定义容器构建规则
• docker-compose.yml：编排多服务部署
• requirements.txt：Python依赖列表
• conf/yyets.env：环境变量配置文件

分阶段部署流程：从克隆到启动的完整步骤

阶段1：获取项目代码

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

git clone https://gitcode.com/gh_mirrors/yy/YYeTsBot
cd YYeTsBot

阶段2：配置环境变量

编辑环境变量配置文件，设置必要参数：

# 使用文本编辑器打开配置文件
nano conf/yyets.env

关键配置项说明：

# 数据库配置
DB_HOST=db           # 使用docker-compose中的服务名
DB_PORT=5432         # 默认数据库端口
DB_NAME=yyets        # 数据库名称
DB_USER=postgres     # 数据库用户名
DB_PASSWORD=yourpassword  # 设置安全密码

# 机器人配置
BOT_TOKEN=your_telegram_bot_token  # 从BotFather获取的Telegram机器人令牌

保存文件并退出编辑器（nano中按Ctrl+O保存，Ctrl+X退出）。

阶段3：启动Docker容器

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

docker-compose up -d

该命令会自动执行以下操作：

1. 构建YYeTsBot应用镜像
2. 拉取并启动PostgreSQL数据库
3. 配置服务间网络连接
4. 启动应用并后台运行

阶段4：验证部署状态

检查容器运行状态：

docker-compose ps

正常情况下，你应该看到类似以下输出：

      Name                    Command               State           Ports         
----------------------------------------------------------------------------------
yyetsbot_db_1        docker-entrypoint.sh postgres    Up      5432/tcp              
yyetsbot_yyetsbot_1  python yyetsbot/yyetsbot.py      Up                            

查看应用日志确认服务正常启动：

docker-compose logs -f yyetsbot

当看到类似"Bot started successfully"的日志信息，说明部署成功。

配置深度解析：核心文件功能与自定义

Docker Compose配置详解

docker-compose.yml是部署的核心配置文件，定义了两个主要服务：

services:
  yyetsbot:
    build: .
    depends_on:
      - db
    env_file:
      - conf/yyets.env
    restart: always
    
  db:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=yyets
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=yourpassword

volumes:
  postgres_data:

关键配置说明：

• depends_on: 确保数据库先于应用启动
• restart: always: 服务异常时自动重启
• volumes: 持久化数据库数据，防止容器重启数据丢失

机器人功能配置

机器人的核心配置位于yyetsbot/config.py，可根据需求调整：

• 搜索结果数量限制
• 资源缓存时间
• 日志级别设置
• 命令前缀自定义

性能优化指南：让系统运行更流畅

资源限制配置

为避免容器过度占用系统资源，可在docker-compose.yml中添加资源限制：

services:
  yyetsbot:
    # 其他配置...
    deploy:
      resources:
        limits:
          cpus: '1'      # 限制CPU使用为1核
          memory: 1G     # 限制内存使用为1GB

数据库优化

PostgreSQL性能优化可通过修改conf/yyets.env添加数据库连接池配置：

DB_POOL_SIZE=10        # 数据库连接池大小
DB_MAX_OVERFLOW=20     # 最大溢出连接数

缓存策略调整

编辑yyetsbot/utils.py调整资源缓存时间：

# 修改缓存过期时间为24小时
CACHE_EXPIRE = 86400  # 单位：秒

图2：YYeTsBot资源管理界面，展示影视资源列表和下载链接

问题排查手册：常见故障解决方案

容器启动失败

症状：执行docker-compose ps显示yyetsbot状态为Exited

解决方案：

1. 查看详细错误日志：docker-compose logs yyetsbot
2. 检查环境变量配置是否正确：cat conf/yyets.env
3. 确认数据库服务是否正常启动：docker-compose logs db

机器人无响应

症状：Telegram发送命令后无回应

解决方案：

1. 验证BOT_TOKEN是否正确配置
2. 检查网络连接是否正常
3. 确认容器内能否访问Telegram API：

   docker-compose exec yyetsbot curl https://api.telegram.org
   

数据库连接错误

症状：日志中出现"Could not connect to database"

解决方案：

1. 确认数据库服务是否正常运行
2. 检查DB_HOST是否设置为"db"（docker-compose服务名）
3. 验证数据库用户名和密码是否正确

部署成功验证与后续使用建议

验证标准

当满足以下条件时，说明YYeTsBot部署成功：

1. 所有容器状态为"Up"：docker-compose ps
2. 机器人响应命令：在Telegram发送/start能收到回复
3. 资源搜索功能正常：发送电影名称能返回搜索结果
4. Web界面可访问：打开浏览器访问服务器IP:端口能看到资源页面

后续使用建议

1. 数据备份：定期备份数据库数据

   docker-compose exec db pg_dump yyets > backup_$(date +%Y%m%d).sql
   

2. 定期更新：保持项目代码最新

   git pull
   docker-compose down
   docker-compose up -d --build
   

3. 安全加固：

   • 修改默认数据库密码
   • 限制Web界面访问IP
   • 定期更新Docker镜像

4. 功能扩展：

   • 探索yyetsweb/commands/目录下的扩展命令
   • 自定义yyetsweb/templates/修改Web界面样式

图3：YYeTsBot个人中心界面，展示收藏的影视资源

通过本指南，你已成功部署YYeTsBot并了解其核心功能和优化方法。随着使用深入，可根据个人需求进一步探索高级配置和功能扩展，打造更符合个人习惯的影视资源管理系统。