Skip to content

应用商店规范 ​

应用商店的仓库与应用通过 TOML 描述文件约定,仓库内示例: store/index.toml。

完整规范见仓库文档 docs/store/spec.md。

核心约定 ​

  1. 应用不允许携带脚本:app.toml 中不得声明安装 / 卸载脚本
  2. 安装由面板原生执行:编排文件与 .env 落盘后,面板执行 docker compose up -d
  3. 卸载由面板原生执行:面板执行 docker compose -f compose.yaml down
    • 数据卷默认保留,勾选「删除数据卷」时追加 -v
    • 绑定挂载的宿主机目录不受影响
    • 缺少 compose.yaml 时返回明确提示
  4. 环境变量统一:编排项目根目录的 .env 为唯一明文来源,保存时同步刷新 .env.example

环境变量规范 ​

见 环境变量统一规范:

  • 同名键覆盖
  • 注释与自定义键保留
  • 手动添加的服务与商店安装的服务共用同一套规范

相关 ​

基于 AGPL-3.0 协议发布