浏览文档目录 +

服务 · Free / Go

AppStore

通过应用模板浏览、配置并部署常用服务,保留清晰的高级配置入口。

AppStore真实界面,敏感信息已打码
真实产品界面 · 敏感信息已打码

可以做什么

  • 浏览、搜索和筛选应用模板
  • 使用基础或高级 YAML / 环境变量配置
  • 查看后台部署过程与结果

这个页面解决什么问题

AppStore 把常用服务的部署做成“选模板 → 填参数 → 后台部署”的确定流程,不依赖 AI:模板由官方源站(Full)或你配置的 GitHub/CDN 源(Community)提供,参数按模板声明的输入项呈现,部署由后台任务执行并输出日志。

模板缓存是只读基线:你填写的变量值、密钥和高级编辑只写入本次项目目录,不修改官方模板;同一个 ${VAR} 无论被多少服务引用,都只在“全局配置”里维护一个部署值。项目名称由模板和后端自动确定,同名目录已存在时自动分配 _1、_2 等后缀,不会覆盖已有项目。

目录会按当前目标 Docker 的实际架构过滤已明确不兼容的模板;未声明架构的模板保留展示,由目标 Docker 在拉取镜像时给出真实结果。

开始前准备

  • 部署前目标 Docker 需在线;页面按当前选中设备的架构过滤模板。
  • 使用高级 YAML 编辑需要在「设置 → 常规」开启高级模式(允许编辑高风险 YAML)。

如何操作

浏览并筛选模板

想找一个常用服务的一键部署模板,先确认它适不适合自己的设备。

  1. 使用顶部分类、搜索和排序定位模板;工具栏状态灯反映模板源状态:正常为绿色,仅缓存或降级为警告,连接失败为危险色。
  2. 查看卡片信息:分类、版本、架构标签与部署计数;已证实与当前目标架构不兼容的模板不会出现在目录里。
  3. 点击卡片的 YAML 查看入口,弹窗完整显示只读 Compose YAML 原文,保留缩进与变量,确认端口、卷和镜像是否符合预期。
  4. 同一型号多配置的服务在卡片上以配置选项切换,确认参数后再进入部署。

结果检查:选定模板并了解其真实配置;卡片信息与 YAML 一致,不会以列表摘要代替完整配置。

配置并部署一个应用

首次部署一个模板应用,希望按表单填参数而不用手写 Compose。

  1. 从卡片进入部署页,按分组填写基础参数;同一变量在多个服务中引用时只填一次。
  2. 使用结构化控件调整端口、宿主机路径、容器目标与设备映射;named volume 保持 Docker 卷语义只读展示。
  3. 需要为单个服务追加端口、路径、设备或环境变量时,在该服务的配置区新增;新增项只作为本次部署的覆盖,不修改官方模板缓存。
  4. 点击部署;系统写入项目文件后先执行 docker compose config --quiet 校验,校验失败会删除本次新建目录且不启动任何容器。
  5. 在日志中跟随部署进度;需要离开时点击「后台运行并关闭」。

结果检查:部署任务在后台完成,成功结果包含容器核验;之后到 Compose 或容器页可以看到并管理这个项目。

使用高级 YAML 部署

模板参数满足不了需求,需要在受控范围内直接改 Compose。

  1. 在设置中开启高级模式后,部署页提供与 Compose 页面一致的代码编辑器查看和编辑 YAML。
  2. 编辑时保留 ${VAR} 表达式——你改的是本次部署值对应的源码,官方基线仍可追溯。
  3. 点击部署后系统分别校验官方基线摘要和本地编辑摘要,两者不匹配时不会写入项目目录。
  4. 同样经过静默配置校验后才创建容器;失败保留完整错误信息供修正。

结果检查:编辑过的模板按本地版本部署;未编辑的模板仍走标准校验路径,两者都不会把临时改动写回模板缓存。

跟踪与恢复部署任务

部署耗时较长,需要关掉弹窗先做别的事,稍后回来看结果。

  1. 部署中点击「后台运行并关闭」关闭日志弹窗,后端任务继续执行。
  2. 回到 AppStore 页面时,进度弹窗会自动恢复;也可以从页面重新打开任务进度。
  3. 日志按窗格独立跟随:上翻后新输出保留阅读位置,「最新」入口提示有新内容,回到底部恢复跟随。
  4. 同一部署使用幂等键:同键同参数返回既有任务,避免重复提交。

结果检查:任务状态以后端为事实,刷新或返回页面都能恢复观察;启动后的失败或取消会限时清理 Docker 资源,但保留项目配置与已生成数据供你在 Compose 页检查。

弹窗与高级功能

模板 Compose YAML

打开入口:应用卡片上的 YAML 查看入口。

在部署前完整阅读模板的 Compose 原文。

  • 内容:只读展示完整 Compose 原文,保留缩进与变量占位符。
  • 状态:加载、缺失、失败均明确展示,不以列表摘要代替。
  • 用途:核对镜像、端口、卷与环境变量后,再决定是否进入部署。

提交或关闭后:纯只读查看,不产生任何请求副作用或部署动作。

部署进度与日志

打开入口:点击部署后自动打开;也可从页面重新打开。

跟随后台部署任务并查看结果。

  • 日志流:后台任务通过 SSE 输出日志,可跟随、回看并定位新内容。
  • 后台运行:点击「后台运行并关闭」后任务继续,任务线索保留在本地,返回页面自动恢复进度弹窗。
  • 校验:项目文件写入后先做静默配置校验,失败不启动容器并删除本次新建目录。

提交或关闭后:成功结果包含容器核验信息;失败或取消保留项目配置与已生成数据,转交 Compose 页面处理。

注意:关闭日志弹窗不会取消任务;任务状态是后端事实,浏览器只是恢复观察。

注意事项

  • 官方模板的部署计数统计的是部署成功次数,不是浏览或查看 YAML 的次数。
  • AppStore 部署不继承 AI 部署的自动修复或重试策略;失败处理与普通 Compose 一致。
  • 模板参数必须按 Manifest 声明的输入与映射转换,不能靠字符串替换改 YAML;高级编辑的双摘要校验正是为了防止误覆盖。