系统设置

系统设置包含「基础配置」「服务端口」「存储配置」「Hosts 优选」四个标签页，修改类操作仅管理员可用。

基础配置

代理配置

为管理端同步、镜像信息查询等出网请求配置 HTTP 代理。填入代理地址后可点击「检测」验证连通性，检测结果会按站点显示延迟与成功/失败；不需要代理时保持关闭。

自动更新

授权版功能。开启后每 30 分钟同步一次应用市场与自动化方案，并自动升级 OneTap 管理的应用：

• 只替换镜像，不新建应用、不改挂载、端口和环境变量
• 跳过手动创建的 Compose 项目与导入容器
• 自动化实例组如果模板新增了应用，会跳过自动更新，保留手动升级提示
• 失败会记录失败版本，避免同一版本反复重试
• 更新结果会写入更新记录

免费版此处显示「授权版功能」，开关不可用。未授权时保存开启状态会被后端拒绝。

统一服务账号

自动化组合部署时，平台用这里的管理员用户名和密码自动初始化各应用账号：

• 管理员用户名：默认 admin
• 邮箱后缀：用于必须邮箱登录的应用（Komga、二毛读书），会拼成 admin@example.com 形式
• 管理员密码：留空则每次部署随机生成；建议部署完成后在应用内及时修改

该配置只对自动化组合部署生效，应用市场单应用部署不会自动配置账号。密码用于登录应用并写回实例配置，请妥善保管。

激活授权

显示当前授权状态：免费版、授权有效、已过期、已吊销、授权错误、离线有效。管理员可以：

• 输入授权码并「激活授权」
• 已激活时「刷新授权」或「解绑授权」
• 查看最近刷新时间、离线有效期与授权码（半隐藏，可复制）

普通用户只能查看状态，不能激活、刷新或解绑。

服务端口

• 服务起始端口：默认 10000。创建服务时从该端口开始按顺序分配，自动跳过已占用端口，避免手动记端口
• Docker 端口占用：列出宿主机端口、监听范围、容器端口、占用服务、镜像与容器状态，每 10 秒自动刷新
• IPv4 与 IPv6 合并显示，已停止容器的端口配置也会保留展示

部署前不确定某个端口是否被占用时，先看这张表。部分应用使用固定端口（如 Jellyfin 的 8096），模板会保留固定端口并检查冲突。

存储配置

存储目录描述「宿主机路径 ↔ 容器内路径」的映射关系，点击「新增目录」创建：

字段	说明
名称	目录的显示名
宿主机路径	NAS 上的真实目录，如 /mnt/disk1/media
容器内路径	该目录在 OneTap 后端容器内的路径
备注	可选说明
启用	是否允许在部署表单中选择该目录
应用数据目录	全局至多一条，用于存放应用配置等小数据

标记为「应用数据目录」的记录会自动按下面的规则生成子目录：

应用数据目录/<实例名>/<应用名>/<子目录>

列表中的「可见」表示该宿主机路径已挂载进后端容器，可以浏览和写入；「容器内不可见」表示路径存在但未挂载，部署表单无法浏览其中的子目录。

保存新的应用数据目录后，原应用数据目录会自动转为普通存储目录。删除存储记录不会删除宿主机文件，也不会改动已部署应用的挂载配置，但部署表单中将无法再选择该目录。

未配置应用数据目录会怎样？

部署应用时会提示「未配置应用数据目录，请前往系统设置-存储配置」。首次使用请先新增一条并勾选「应用数据目录」。

容器内外路径要一致

希望平台浏览或读写某个宿主机目录时，必须在 docker-compose.yml 的 app.volumes 中按相同路径挂载，例如：

volumes:
  - /mnt/disk1:/mnt/disk1

否则目录会显示为「不可见」，部署时会出现路径不存在或写入失败。

Hosts 优选

通过 AdGuard Home 的 DNS 重写，把指定域名解析到实测最快的 IP，常用于改善 TMDB 刮削、GitHub、PT 站点的连接质量。

1. 连接 AdGuard Home：填写管理地址（如 http://192.168.1.23:8081）、用户名与密码，点击「测试连接」；连接成功后可直接「打开管理」
2. 配置优选规则：
   • 运行模式：手动（点击「立即优选」时运行）或自动（按间隔后台运行，默认 360 分钟）
   • 每域名保留 IP 数：默认 2 个
   • 优选域名：每行一个或英文逗号分隔；默认包含 api.themoviedb.org、image.tmdb.org、github.com 等，保存时自动去重校验
3. 运行状态：查看最近一次运行结果、耗时、下次自动运行时间，以及每个域名的状态与优选 IP

只对使用 AdGuard DNS 的客户端生效

该功能不写宿主机 /etc/hosts。只有把 DNS 指向 AdGuard Home 的设备才会使用优选结果。从域名列表中移除域名不会删除 AdGuard 中已有的重写记录。

授权与功能对照

功能	免费版	授权版
服务概览、应用市场、Docker 管理	✓	✓
自动化组合部署、实例管理、应用集成	✓	✓
应用检测优化、手动执行音乐整理 / Reader 同步	✓	✓
自动更新应用与方案	—	✓
音乐自动整理、Reader 自动同步的后台定时任务	—	✓

自动化组合本身不再要求授权，但后台定时任务会检查授权状态；授权无效时只跳过定时执行，不影响手动操作。