FastEmby 常见问题
安装相关问题
Q: 容器启动失败怎么办？
A: 检查以下几点：
- 确认 Docker 和 Docker Compose 已正确安装
- 查看容器日志：
docker compose -f compose-fastemby.yml logs fastemby - 确认配置文件目录权限正确
- 检查
compose-fastemby.yml文件格式是否正确
Q: 如何更新 FastEmby？
A: 执行以下命令：
docker compose -f compose-fastemby.yml pull
docker compose -f compose-fastemby.yml up -d
Q: 如何修改网络模式？
A: FastEmby 默认使用 host 网络模式，这是必需的配置，不建议修改。
配置相关问题
Q: 如何修改时区？
A: 在 compose-fastemby.yml 的 environment 中修改：
environment:
- TZ=Asia/Shanghai # 修改为您所在的时区
Q: 许可证验证失败怎么办？
A: 检查以下几点：
- 确认
LICENSE_KEY环境变量配置正确 - 验证许可证是否过期
- 确认许可证格式正确（使用 Symedia 密钥）
- 检查容器日志查看详细错误信息
Q: 如何修改存储目录？
A: 修改 compose-fastemby.yml 中的 volumes 配置：
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- /your/custom/path:/app/config # 修改为您想要的路径
Q: 如何备份配置？
A: 备份 config 目录：
tar -czf fastemby-backup-$(date +%Y%m%d).tar.gz ./config/
使用相关问题
Q: 如何查看 FastEmby 状态？
A:
- 查看容器状态：
docker ps | grep FastEmby - 查看日志：
docker compose -f compose-fastemby.yml logs -f fastemby - 检查配置文件：
ls -la ./config/
Q: 如何与 Emby 服务器集成？
A: 在 FastEmby 的 Web 界面中配置 Emby 服务器地址和认证信息，FastEmby 会自动连接到 Emby 服务器。
许可证相关问题
Q: 如何获取许可证？
A: 从 TG机器人 获取许可证密钥（Symedia密钥），然后配置到 LICENSE_KEY 环境变量中。
Q: 许可证在哪里配置？
A: 在 compose-fastemby.yml 文件中的 environment 部分添加：
environment:
- LICENSE_KEY=your_license_key_here
Q: 许可证设备绑定限制是什么？
A:
- 每个许可证可以绑定多个设备
- 设备数量由许可证的配置决定
- 具体限制请参考文档或联系客服
Q: 为什么使用 Symedia 密钥？
A: FastEmby 使用 Symedia 的许可证系统，因此需要使用 Symedia 密钥作为许可证。
故障排查
Q: 容器一直重启怎么办？
A:
- 查看详细日志：
docker compose -f compose-fastemby.yml logs fastemby - 检查
compose-fastemby.yml文件格式是否正确 - 确认环境变量格式正确
- 验证配置文件目录是否存在
Q: 如何重置 FastEmby？
A:
- 停止容器：
docker compose -f compose-fastemby.yml down - 删除配置目录：
rm -rf ./config/ - 重新启动：
docker compose -f compose-fastemby.yml up -d
Q: 网络连接问题？
A:
- 检查宿主机网络配置
- 确认防火墙规则
- 验证 DNS 解析
- 检查 Docker 网络设置
Q: 配置文件目录权限问题？
A:
- 确认目录存在：
ls -la /vol1/1000/appdata/fastemby/ - 检查目录权限：
chmod -R 755 ./config - 确认目录所有者正确
获取帮助
如果以上问题无法解决，可以：
- 查看容器日志获取详细错误信息：
docker compose -f compose-fastemby.yml logs fastemby - 从 TG机器人 联系客服