应用商店规范
应用商店的仓库与应用通过 TOML 描述文件约定,仓库内示例: store/index.toml。
完整规范见仓库文档
docs/store/spec.md。
核心约定
- 应用不允许携带脚本:
app.toml中不得声明安装 / 卸载脚本 - 安装由面板原生执行:编排文件与
.env落盘后,面板执行docker compose up -d - 卸载由面板原生执行:面板执行
docker compose -f compose.yaml down- 数据卷默认保留,勾选「删除数据卷」时追加
-v - 绑定挂载的宿主机目录不受影响
- 缺少
compose.yaml时返回明确提示
- 数据卷默认保留,勾选「删除数据卷」时追加
- 环境变量统一:编排项目根目录的
.env为唯一明文来源,保存时同步刷新.env.example
环境变量规范
见 环境变量统一规范:
- 同名键覆盖
- 注释与自定义键保留
- 手动添加的服务与商店安装的服务共用同一套规范
