主题
常见问题
应用市场是空的 / 分类没有更新
应用数据来自管理端同步：
- 点击顶部栏的同步按钮手动触发一次，查看提示中的失败原因
- 确认容器能访问
MANAGE_BASE_URL（不能填容器内的localhost） - 检查
.env中MANAGE_BASE_URL是否被覆盖成了错误地址，修改后重启 - 若主机需要代理出网，在「系统设置 → 基础配置 → 代理配置」启用并检测代理
管理端不可达时不会清空本地已缓存的应用，恢复后再次同步即可。多个管理端地址可以用逗号分隔，平台会按顺序故障转移。
部署时提示「未配置应用数据目录」
首次使用必须先在「系统设置 → 存储配置」新增一条目录并勾选「应用数据目录」。平台会按 <实例名>/<应用名>/<子目录> 生成子目录，例如 /appdata/movie/moviepilot/config。
部署失败怎么排查
- 顶部「任务中」入口查看部署日志，先看第一条报错
- 端口被占用：到「系统设置 → 服务端口」查看占用表，修改实例端口后重新部署。平台从「服务起始端口」（默认 10000）开始顺序分配并自动跳过占用端口
- 镜像拉取失败：到「Docker → 镜像 → 镜像加速」切换或测试加速地址；需要代理时在基础配置中启用代理
- 路径不存在或权限不足：检查宿主机目录是否已创建、是否按相同路径挂载进
app容器，以及存储目录是否显示「可见」
修改了配置什么时候生效
| 修改内容 | 生效方式 |
|---|---|
.env | docker compose up -d 重建容器 |
| 管理端的应用/组合模板 | 同步后生效，无需重启 |
| 系统设置中的配置 | 保存即生效 |
| 已部署的单应用 | 不会被模板更新自动覆盖；在应用详情手动升级 |
| 自动化实例组 | 使用「升级方案」；授权版可开启自动更新 |
页面里看不到已部署的应用
服务概览只展示通过平台部署、自动化组合部署或导入、且容器真实存在的服务。如果容器被手动删除、改名或移出 Compose 项目，概览会自动过滤这些记录；可在「Docker → 容器管理」确认容器实际状态。
部署后访问地址打不开
- 在服务概览的应用详情中确认容器运行状态与端口映射
- 确认访问的是「本地端口」而不是容器端口
- 检查 NAS 防火墙是否放行该端口
- 部分应用首次启动需要初始化，稍等片刻或查看容器日志
自动化组合需要授权吗
不需要。自动化组合的部署、升级、修复、导入、恢复都只要求管理员权限。授权影响的是后台定时任务：自动更新、音乐自动整理和 Reader 自动同步的定时执行会检查授权；手动点击「立即整理」「立即同步」不受影响。
单应用和自动化组合的升级有什么区别
- 单应用：服务概览 → 应用详情 →「立即升级」，只替换镜像，配置与数据保持不变
- 自动化实例组：组合页面 →「升级方案」，可查看版本变化与每个应用的镜像变化；升级只更新镜像，挂载、端口和环境变量保持当前配置
- 授权版开启自动更新后，符合条件的实例会自动升级；模板新增应用的实例组会跳过自动更新
如何卸载应用
应用市场没有单独的卸载按钮。到「Docker → 容器编排」找到对应 Compose 项目并删除项目。
- 删除会停止并移除容器与网络、删除项目工作目录，并清理平台实例记录
- 单应用删除不会备份应用数据目录，需要保留时请先手动备份
- 自动化实例组请在组合页面删除，它会把各应用数据目录移入
_backups，之后可通过「恢复」找回
注册、密码与账号
- 首个注册用户自动成为管理员，密码至少 8 位；注册成功后注册功能自动关闭
- 需要继续注册时由管理员通过
REGISTRATION_OPEN重新开启，之后注册的用户均为普通用户 - 当前没有用户管理、角色编辑和密码重置页面；忘记密码请联系管理员，在数据库中重置
- 「记住我」勾选时令牌保存在浏览器本地存储，不勾选时只在当前标签页会话内有效
容器终端无法连接
终端依赖 docker exec。确认：
- 容器处于运行状态
- 镜像内存在
/bin/sh或/bin/bash；后端会自动选择可用 shell - 当前账号是管理员
如何反馈 bug 或提出建议
到问题反馈新建一条反馈，选择分类并描述复现步骤、部署方式与版本；官方处理进度会更新在状态里，你也可以在详情页继续评论补充信息。