30分钟搞定YYeTsBot部署与运维:从新手到高手的完整指南
YYeTsBot是一个集机器人和网站于一体的开源项目,提供影视资源及网友网盘分享。本文将详细介绍如何部署、配置和维护YYeTsBot,帮助你快速搭建属于自己的影视资源平台。
项目概述
YYeTsBot包含机器人和网站两部分,支持资源搜索、分享和收藏等功能。项目结构清晰,主要分为配置文件、源代码和静态资源三大部分。
核心功能模块包括:
- 资源搜索系统:支持多字幕组资源查询
- 网页前端:提供用户友好的资源浏览界面
- 数据存储:使用MongoDB存储资源信息
- 机器人服务:提供第三方交互接口
部署准备
环境要求
部署YYeTsBot需要以下环境支持:
- Docker及Docker Compose
- Git
- 至少2GB内存
- 10GB以上存储空间
资源获取
通过GitCode仓库获取项目源代码:
git clone https://gitcode.com/gh_mirrors/yy/YYeTsBot.git
cd YYeTsBot
项目主要配置文件包括:
- Dockerfile:容器构建配置
- docker-compose.yml:服务编排配置
- conf/yyets.env:环境变量配置
快速部署
一键脚本部署
对于Linux/macOS系统,可使用项目提供的一键安装脚本:
bash -c "$(curl -fsSL https://gitcode.com/gh_mirrors/yy/YYeTsBot/raw/master/scripts/install.sh)"
Windows用户需先安装Git for Windows,然后在Git Bash中执行上述命令。
注意:一键脚本默认将服务绑定到127.0.0.1,如需外部访问,请修改docker-compose.yml中的端口映射配置。
Docker Compose手动部署
手动部署步骤如下:
- 启动MongoDB数据库:
docker-compose up -d mongo
- 导入初始数据:
# 从项目获取数据库备份(具体方法参见[yyetsweb/README.md](https://link.gitcode.com/i/654087d846728b76cbba4d1ee23992a5))
docker cp yyets_mongo.gz yyets_mongo_1:/tmp
docker-compose exec mongo bash
mongorestore --gzip --archive=/tmp/yyets_mongo.gz --nsFrom "share.*" --nsTo "zimuzu.*"
exit
- 启动所有服务:
docker-compose up -d
部署完成后,可通过访问http://localhost:8080查看网站界面,效果如下:
配置详解
机器人配置
机器人配置文件位于yyetsbot/config.py,主要配置项包括:
- TOKEN:第三方机器人令牌
- USERNAME/PASSWORD:资源网站登录凭据
- REDIS/MONGODB:数据库连接信息
修改配置后需重启机器人服务:
docker-compose restart yyetsbot
网站配置
网站前端代码位于yyets/worker/public/目录,主要页面包括:
- index.html:首页
- search.html:搜索页面
- resource.html:资源详情页
自定义网站样式可修改yyets/worker/public/css/aYin.css文件。
日常运维
服务管理
常用Docker Compose命令:
# 启动所有服务
docker-compose up -d
# 查看服务状态
docker-compose ps
# 查看日志
docker-compose logs -f
# 重启服务
docker-compose restart
# 停止服务
docker-compose down
数据备份
定期备份MongoDB数据:
docker-compose exec mongo mongodump --gzip --archive > yyets_mongo_$(date +%Y%m%d).gz
升级维护
升级项目到最新版本:
git pull
docker-compose down
docker-compose up -d --build
功能使用
基本搜索
通过机器人发送剧集名称即可搜索资源,支持模糊匹配。例如发送"逃避可耻"将返回相关结果:
指定字幕组搜索
目前支持YYeTsOffline、ZimuxiaOnline和NewzmzOnline三个字幕组,使用方法如下:
/yyets_offline 关键词:搜索人人影视离线数据/zimuxia_online 关键词:搜索字幕侠在线数据/newzmz_online 关键词:搜索New字幕组在线数据
收藏功能
网站支持资源收藏功能,登录后点击资源旁的收藏按钮即可,收藏内容将跨设备同步:
常见问题
无法下载资源
部分资源可能因版权问题被下载工具屏蔽,可尝试以下解决方案:
-
电驴资源:使用eMule下载,并添加以下服务器列表:
-
种子链接:使用百度网盘、115等离线下载工具,或更新BT Tracker列表:
https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_all.txt
服务无法访问
如遇到服务无法访问,请检查:
- Docker容器是否正常运行:
docker-compose ps - 端口映射是否正确配置:docker-compose.yml
- 防火墙设置是否允许对应端口访问
高级配置
高可用部署
对于生产环境,可配置MongoDB副本集提高可用性:
ln -s docker-compose-replica.yml docker-compose.override.yml
docker-compose up -d
然后进入MongoDB容器配置副本集:
docker-compose exec mongo bash
mongo
rs.initiate({
_id: "rs0",
members: [
{_id: 0, host: "localhost:27017"},
{_id: 1, host: "mongo2:27017"}
]
})
添加新资源网站
要添加新的资源网站,只需实现BaseFansub类的search_preview和search_result方法,并将新类添加到FANSUB_ORDER列表中。
总结
通过本文介绍的方法,你已经掌握了YYeTsBot的部署与运维技巧。项目提供了灵活的部署选项,无论是新手还是有经验的开发者都能快速上手。
如需进一步了解API使用方法,请参考API.md文档。开发相关问题可查阅DEVELOPMENT.md。
最后,欢迎通过项目GitHub提交issue或贡献代码,让YYeTsBot变得更好!
相关资源
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考









