服务 · Free / Go
AppStore
通过应用模板浏览、配置并部署常用服务,保留清晰的高级配置入口。
可以做什么
- 浏览、搜索和筛选应用模板
- 使用基础或高级 YAML / 环境变量配置
- 查看后台部署过程与结果
这个页面解决什么问题
AppStore 把常用服务的部署做成“选模板 → 填参数 → 后台部署”的确定流程,不依赖 AI:模板由官方源站(Full)或你配置的 GitHub/CDN 源(Community)提供,参数按模板声明的输入项呈现,部署由后台任务执行并输出日志。
模板缓存是只读基线:你填写的变量值、密钥和高级编辑只写入本次项目目录,不修改官方模板;同一个 ${VAR} 无论被多少服务引用,都只在“全局配置”里维护一个部署值。项目名称由模板和后端自动确定,同名目录已存在时自动分配 _1、_2 等后缀,不会覆盖已有项目。
目录会按当前目标 Docker 的实际架构过滤已明确不兼容的模板;未声明架构的模板保留展示,由目标 Docker 在拉取镜像时给出真实结果。
开始前准备
- 部署前目标 Docker 需在线;页面按当前选中设备的架构过滤模板。
- 使用高级 YAML 编辑需要在「设置 → 常规」开启高级模式(允许编辑高风险 YAML)。
如何操作
浏览并筛选模板
想找一个常用服务的一键部署模板,先确认它适不适合自己的设备。
- 使用顶部分类、搜索和排序定位模板;工具栏状态灯反映模板源状态:正常为绿色,仅缓存或降级为警告,连接失败为危险色。
- 查看卡片信息:分类、版本、架构标签与部署计数;已证实与当前目标架构不兼容的模板不会出现在目录里。
- 点击卡片的 YAML 查看入口,弹窗完整显示只读 Compose YAML 原文,保留缩进与变量,确认端口、卷和镜像是否符合预期。
- 同一型号多配置的服务在卡片上以配置选项切换,确认参数后再进入部署。
结果检查:选定模板并了解其真实配置;卡片信息与 YAML 一致,不会以列表摘要代替完整配置。
配置并部署一个应用
首次部署一个模板应用,希望按表单填参数而不用手写 Compose。
- 从卡片进入部署页,按分组填写基础参数;同一变量在多个服务中引用时只填一次。
- 使用结构化控件调整端口、宿主机路径、容器目标与设备映射;named volume 保持 Docker 卷语义只读展示。
- 需要为单个服务追加端口、路径、设备或环境变量时,在该服务的配置区新增;新增项只作为本次部署的覆盖,不修改官方模板缓存。
- 点击部署;系统写入项目文件后先执行 docker compose config --quiet 校验,校验失败会删除本次新建目录且不启动任何容器。
- 在日志中跟随部署进度;需要离开时点击「后台运行并关闭」。
结果检查:部署任务在后台完成,成功结果包含容器核验;之后到 Compose 或容器页可以看到并管理这个项目。
使用高级 YAML 部署
模板参数满足不了需求,需要在受控范围内直接改 Compose。
- 在设置中开启高级模式后,部署页提供与 Compose 页面一致的代码编辑器查看和编辑 YAML。
- 编辑时保留 ${VAR} 表达式——你改的是本次部署值对应的源码,官方基线仍可追溯。
- 点击部署后系统分别校验官方基线摘要和本地编辑摘要,两者不匹配时不会写入项目目录。
- 同样经过静默配置校验后才创建容器;失败保留完整错误信息供修正。
结果检查:编辑过的模板按本地版本部署;未编辑的模板仍走标准校验路径,两者都不会把临时改动写回模板缓存。
跟踪与恢复部署任务
部署耗时较长,需要关掉弹窗先做别的事,稍后回来看结果。
- 部署中点击「后台运行并关闭」关闭日志弹窗,后端任务继续执行。
- 回到 AppStore 页面时,进度弹窗会自动恢复;也可以从页面重新打开任务进度。
- 日志按窗格独立跟随:上翻后新输出保留阅读位置,「最新」入口提示有新内容,回到底部恢复跟随。
- 同一部署使用幂等键:同键同参数返回既有任务,避免重复提交。
结果检查:任务状态以后端为事实,刷新或返回页面都能恢复观察;启动后的失败或取消会限时清理 Docker 资源,但保留项目配置与已生成数据供你在 Compose 页检查。
弹窗与高级功能
模板 Compose YAML
打开入口:应用卡片上的 YAML 查看入口。
在部署前完整阅读模板的 Compose 原文。
- 内容:只读展示完整 Compose 原文,保留缩进与变量占位符。
- 状态:加载、缺失、失败均明确展示,不以列表摘要代替。
- 用途:核对镜像、端口、卷与环境变量后,再决定是否进入部署。
提交或关闭后:纯只读查看,不产生任何请求副作用或部署动作。
部署进度与日志
打开入口:点击部署后自动打开;也可从页面重新打开。
跟随后台部署任务并查看结果。
- 日志流:后台任务通过 SSE 输出日志,可跟随、回看并定位新内容。
- 后台运行:点击「后台运行并关闭」后任务继续,任务线索保留在本地,返回页面自动恢复进度弹窗。
- 校验:项目文件写入后先做静默配置校验,失败不启动容器并删除本次新建目录。
提交或关闭后:成功结果包含容器核验信息;失败或取消保留项目配置与已生成数据,转交 Compose 页面处理。
注意:关闭日志弹窗不会取消任务;任务状态是后端事实,浏览器只是恢复观察。
注意事项
- 官方模板的部署计数统计的是部署成功次数,不是浏览或查看 YAML 的次数。
- AppStore 部署不继承 AI 部署的自动修复或重试策略;失败处理与普通 Compose 一致。
- 模板参数必须按 Manifest 声明的输入与映射转换,不能靠字符串替换改 YAML;高级编辑的双摘要校验正是为了防止误覆盖。