CMS 常见问题
安装相关问题
Q: 容器启动失败怎么办？
A: 检查以下几点：
- 确认 Docker 和 Docker Compose 已正确安装
- 检查端口是否被占用（9527, 9096）
- 查看容器日志：
docker compose logs cloud-media-sync - 确认数据卷目录权限正确
Q: 如何更新 CMS？
A: 执行以下命令：
docker compose pull
docker compose up -d
Q: 如何备份配置？
A: 备份 config 目录：
tar -czf cms-backup-$(date +%Y%m%d).tar.gz config/
配置相关问题
Q: 忘记管理员密码怎么办？
A: 可以通过环境变量重置：
- 修改
compose.yml中的ADMIN_PASSWORD - 重启容器：
docker compose restart cloud-media-sync
Q: Emby 连接不上怎么办？
A: 检查以下几点：
- 确认 Emby 服务正在运行
- 检查
EMBY_HOST_PORT配置是否正确 - 验证
EMBY_API_KEY是否有效 - 如果 Emby 在宿主机，使用
http://172.17.0.1:8096（Docker 默认网关） - 如果 Emby 在容器中，使用容器名称或 IP
Q: API Token 在哪里使用？
A: API Token 用于 API 请求认证，在调用 CMS API 时需要在请求头中包含：
X-API-Token: your_api_token
使用相关问题
Q: 如何查看同步状态？
A:
- 登录 Web 界面：
http://localhost:9527 - 查看日志：
docker compose logs -f cloud-media-sync - 检查日志文件：
tail -f logs/cms.log
Q: 同步速度慢怎么办？
A:
- 检查网络连接
- 调整并发数设置
- 检查磁盘 I/O 性能
- 考虑使用缓存加速
Q: 如何添加多个网盘？
A: 在 Web 界面中配置多个网盘账号，CMS 支持同时管理多个网盘。
捐赠码相关问题
Q: 如何获取捐赠码？
A: 从 TG机器人 获取捐赠码，然后配置到 DONATE_CODE 环境变量中。
Q: 捐赠码在哪里配置？
A: 在 compose.yml 文件中的 environment 部分添加：
environment:
- DONATE_CODE=your_donate_code
故障排查
Q: 容器一直重启怎么办？
A:
- 查看详细日志：
docker compose logs cloud-media-sync - 检查配置文件是否有语法错误
- 确认环境变量格式正确
- 检查数据卷挂载路径是否存在
Q: 如何重置 CMS？
A:
- 停止容器：
docker compose down - 删除配置目录：
rm -rf config/ - 重新启动：
docker compose up -d
Q: 性能优化建议？
A:
- 使用 SSD 存储
- 增加容器内存限制
- 优化网络配置
- 定期清理缓存
获取帮助
如果以上问题无法解决，可以：
- 查看容器日志获取详细错误信息
- 检查 GitHub Issues（如果有）
- 从 TG机器人 联系客服