总览 · Free / Go
导航页
把已经部署的 Web 服务整理成统一入口，减少记忆端口和地址的负担。
可以做什么
- 自动发现可导航的容器服务
- 维护内网、外网地址与显示规则
- 按分类整理应用入口和图标
这个页面解决什么问题
导航页把“记不住的 IP 和端口”变成一个统一的入口页：它会自动发现正在运行的容器 Web 服务并生成入口卡片，也允许你手工维护任意内外网地址。它管理的只是入口记录，不管理容器本身——所以在这里删除一条导航，容器照常运行。
页面的核心规则是“手工优先”：你手工填写的 URL、地址中的显式端口、名称、分类和图标不会被自动发现或 AI 识别覆盖；一条自动发现的条目一旦被你编辑过，就转为手工维护。显示名称按“容器备注 → Compose 项目备注 → 自动识别名称”的顺序取值，因此给容器写一条备注，往往就能让入口名更可读。
自动条目与手工条目的隐藏逻辑不同：容器停止、暂停、删除或端口移除时，自动条目会被自动隐藏并在恢复运行后重新出现；你自己手动隐藏的条目不会被自动恢复。自动隐藏的条目默认保留 7 天，保留期可在设置的服务分类里调整。
开始前准备
- AI 识别与补全需要在「设置 → AI」中保存可用的模型连接；不配置时，自动发现与手工维护不受影响。
如何操作
手动添加应用入口
有一个自动发现识别不到、或部署在面板之外的服务，需要固定加入导航。
- 点击工具栏的新建按钮，打开新建导航弹窗。
- 填写名称；地址支持内网与外网 URL，且只允许 http:// 与 https:// 开头。
- 选择或新建分类；如需自定义外观，可上传图标（按文件内容识别格式，SVG 会去除脚本等危险内容）。
- 保存后卡片立即出现在对应分类下；点击卡片即可跳转访问。
结果检查：入口出现在对应分类中，名称、地址与图标按你填写的内容展示；手工内容不会被后续的自动发现或 AI 识别改动。
理解并管理自动发现的入口
想让导航页跟随容器的运行状态自动增减，同时保留自己想要的控制权。
- 部署新容器后回到导航页，自动发现会为暴露端口的 Web 服务生成入口；host 网络容器通过镜像 EXPOSE 端口识别，未声明 EXPOSE 时可用容器标签 tradis.navigation.port 显式指定端口。
- 对自动条目做任何编辑（改名、改地址、换图标），它会转为手工维护，之后不再随容器生命周期自动隐藏。
- 只想暂时收起某条自动入口时使用手动隐藏：它不会被自动恢复，需要自己恢复显示；而因容器停止被自动隐藏的条目，容器恢复运行后会自动回来。
- 在「设置 → 服务 → 导航自动维护」中调整自动隐藏条目的保留期（1–365 天），到期后系统在读取或发现时清理它们。
结果检查：导航列表能跟随容器状态自动变化，同时你手工处理过的条目保持稳定；「显示隐藏」偏好会永久保存，刷新后仍生效。
按分类整理与批量清理
入口越来越多，需要按用途分组、批量删掉已经废弃的服务。
- 打开分类管理：在输入框回车新增分类，悬停在分类行上可改名或删除；改名与删除会和该分类下所有导航的归类在同一事务中完成。
- 使用搜索快速定位入口；分类可折叠，折叠状态随会话保留。
- 批量选择：从空白处或卡片拖拽框选，Ctrl／Cmd／Shift 可累加选择，也可使用卡片复选框；选中后工具栏显示数量、全选当前、取消选择和删除导航。
- 确认删除前核对范围——批量删除只覆盖当前搜索、隐藏偏好和折叠状态下实际可见的导航，不可见条目会被自动剔除出选择。
结果检查：分类结构与应用归类同时更新，不会出现半完成状态；被删除的入口从列表消失，但容器不受任何影响。
使用 AI 识别补全入口信息
自动发现只拿到端口，名称和分类不够直观，想批量整理。
- 对单个入口使用 AI 补全，让模型根据服务特征建议名称等信息。
- 需要整体重建时使用批量重新识别；这是一次破坏性重建操作，页面会先要求确认。
- 确认后等待识别完成；识别结果不能覆盖你手工维护过的内容，手工条目会被跳过或保留原值。
- 对识别结果不满意的条目，直接编辑修正——编辑过的条目从此转为手工维护。
结果检查：入口信息变得可读；已合并的历史重复记录会标记为“已合并”并隐藏，旧记录保留 ID 供查看与彻底删除。
弹窗与高级功能
新建／编辑导航
打开入口：工具栏新建按钮，或卡片上的编辑操作。
维护单条导航的名称、内外网地址、分类与图标。
- 地址规则：内网与外网 URL 只接受 http:// 与 https://；显式写出的端口优先于自动发现。
- 来源转换：编辑一条自动发现的条目并保存后，它转为手工维护，之后不再被自动覆盖或自动隐藏。
- 图标：可上传图片，系统按文件内容识别格式并做安全处理；未配置时按项目图标 → 通用 Docker 图标回退。
提交或关闭后：保存后卡片立即按新内容展示；编辑自动条目会同时把它纳入手工保护范围。
注意：自动发现无法覆盖此弹窗中手工维护的任何字段；反过来，手工地址占用的端口也不会再被自动发现重复占用。
分类管理
打开入口：导航页的分类管理入口。
维护导航的分组结构。
- 操作方式：输入框回车新增，悬停分类行内改名或删除。
- 事务保证：分类改名或删除与该分类下所有导航的归类调整在同一事务完成，失败会整体回滚。
- 空分类不会创建假应用；“未分类”是虚拟分组，不提供组级改名或删除。
提交或关闭后：分类结构立即更新，原有导航的名称、地址与 AI 标记保留。
删除与彻底删除确认
打开入口：卡片删除操作，或批量选择后的删除导航。
区分软删除与彻底清除导航记录。
- 普通删除是软删除，记录仍保留在系统中。
- 彻底删除调用独立的清除接口，需要二次确认。
- 批量删除一次确认即可，最多并行 4 项，失败项保留选择供重试。
提交或关闭后：只移除导航记录，不操作容器；若该服务的自动发现来源仍然有效，之后的容器发现可能重新生成入口。
注意：已合并的历史副本（标记“已合并”）不提供恢复，只能查看或彻底删除。
重新识别确认
打开入口：批量重新识别操作。
在执行破坏性重建前获得明确确认。
- 重新识别会按当前容器状态重建识别结果，属于破坏性重建操作。
- 确认前请确认手工条目无需变动——手工维护的内容会被保留，不会被识别结果覆盖。
提交或关闭后：确认后开始重建；取消则不做任何改动。
注意：重建后的识别结果取决于模型与服务特征，识别质量依赖自配模型的可用性。
注意事项
- 导航与容器生命周期解耦：删除导航不影响容器，停止容器也不会删除你的手工入口。
- 入口的 HTTP 探测只把 401／403 或登录跳转视为“有响应”的证据，登录要由目标应用自己完成，入口能打开不代表应用业务健康。
- 未声明 EXPOSE 的 host 网络镜像可用容器标签 tradis.navigation.port 显式指定识别端口。