玩 NAS 最头疼的就是找资源和手动改名。为了解决“乱码文件名导致刮削失败”的痛点，我开发了 [ZongziBay(粽子湾)]—— 集聚合搜索、下载、智能保种移动文件与智能重命名于一体的工具。
本文以飞牛OS (FNOS) 为例，手把手教你通过 Docker 快速部署，实现影视资源的自动化入库。
⚠️ 注意： 项目尚处于 Beta 阶段，可能存在 Bug。若遇到问题，欢迎前往 GitHub Issues 提交反馈，我会尽快优化！
一、 拉取镜像
在飞牛OS的 Docker 管理器中，搜索并拉取以下镜像：
polarws/zongzibay:latest
然后创建此镜像容器
二、 创建与配置容器
在创建容器时，请务必重点检查以下关键设置：
- 端口设置：填写宿主机与容器的对应端口。
- 路径挂载：
- 配置文件：将 /app/config 映射到本地目录。
- 下载与转存路径：设置下载文件的临时路径和最终转存路径。
- 注意：这两个路径必须与你的 qBittorrent (qB) 挂载路径保持一致，否则无法正常移动文件。
三、 初始登录与系统设置
容器启动后，在浏览器中输入 IP:端口 进入登录页。
默认账号：admin
默认密码：password123
然后我们进入设置页面
- 基础安全设置
进入 【设置】 页面，首要任务是修改账号密码和 JWT 密钥（用于加密账号信息）。
- 获取 TMDB 和 ASSRT 的API Key
请参考《API Key 获取指南（TMDB / Assrt）》
- 服务对接依次填写以下配置：
- qBittorrent：填写地址及登录凭据。
- TMDB / ASSRT：分别获取并填入对应的 API Key。
- 测试连接：完成填写后，点击顶部的 全部测试 。确保所有项目均显示通过后，再进行下一步。
- 保存配置
点击保存按钮，或直接使用快捷键 Ctrl + S。
四、 搜索、下载与智能重命名
回到主页，让我们以搜索《怪奇物语》为例演示流程：
来到搜索结果页面我们可以选择右上角的网站
- 海盗湾适用于综合种子
- 动漫花园专注二次元
- ASSRT 则用于匹配字幕。
来到搜索详情页随便点一个试试
进入结果详情页面，确认选择的文件去向路径
然后我们点击智能重命名按钮他就能自动识别并且重命名
然后我们可以看见他自动识别并且重命名了文件，我们点击确认
他就会回到首页并且开始下载任务啦
五、 常见问题 (Q&A)
Q： 为什么解析不到文件？
A： ZongziBay 虽然内置了部分 Tracker，但在某些环境下可能不够。建议在设置页面或 qB 中手动添加更多优质的 Tracker 列表。
Q： 为什么无法访问 TMDB 等服务？
A： TMDB 在国内部分地区访问不稳定，建议确保容器所在环境具备通畅的网络访问能力。
Q： ASSRT连接失败怎么办？
A： 尝试将域名修改为备用接口：https://api.makedie.me。若遇到 SSL 证书（443 错误），可尝试切换为 http://api.makedie.me。
Q： 为什么要填写密钥，而不是开发自带？
A： 因为TMDB和ASSRT对每个密钥都有QPS限制。
