1Panel 应用商店技能

本文档介绍如何使用 1panel-appstore-skills，将已经支持 Docker 部署的应用转换为符合 1Panel 应用商店格式的应用安装包。项目仓库地址：1Panel-dev/1Panel-appstore-skills

1 功能概述⚓︎

1panel-appstore-skills 可以根据应用官方仓库、官方文档、Docker 镜像、Compose 文件或中间 spec，整理应用元数据和容器部署参数，并生成 1Panel 应用包目录。

该 Skill 主要处理以下内容：

1Panel-skills 主要用于将 1Panel 运维查询能力接入智能体平台；1panel-appstore-skills 用于生成应用安装包，两者用途不同。

可以通过以下命令获取仓库：

git clone https://github.com/1Panel-dev/1Panel-appstore-skills.git

不同智能体平台的 Skill 安装目录和加载方式可能不同，应以对应平台的说明为准。

适合使用该 Skill 的场景包括：

以下场景不适合直接使用：

输入类型	说明
应用名称	Skill 会查找并确认应用官方仓库，再核对 Docker 部署方式
官方仓库地址	以指定仓库作为主要信息来源
Docker 镜像	需要同时提供或从官方来源确认端口、环境变量和数据目录等参数
`docker-compose.yml` / `compose.yml`	根据官方 Compose 配置整理服务拓扑和 1Panel 表单字段
中间 spec	使用符合 `references/appspec.md` 的 JSON 文件直接生成应用包

信息来源

Docker 安装方式必须来自应用官方仓库或官方文档。优先使用官方镜像；只有官方没有公开镜像或仅提供源码构建方式，并且用户明确接受时，才可以使用来源清晰的第三方镜像。无法确认可靠容器化方案时，应停止生成应用包。

提供官方仓库地址：

使用 1panel-appstore-skills，把 https://github.com/example/myapp 封装成 1Panel 应用商店应用。

提供镜像和端口：

使用 1panel-appstore-skills，把 ghcr.io/example/myapp:1.0.0 封装成 1Panel 应用商店应用。
主机端口为 8080，容器端口为 3000。

使用当前目录中的 Compose 文件：

使用 1panel-appstore-skills，把当前目录的 docker-compose.yml 转成 1Panel 应用商店应用包。

已经准备好中间 spec 时，可以直接运行生成脚本：

python3 scripts/generate_app_package.py \
  --spec assets/sample-appspec.json \
  --output apps

默认生成目录结构如下：

apps/<app-key>/
  logo.png
  README.md
  README_en.md
  data.yml
  <version>/
    data.yml
    docker-compose.yml
    data/
    scripts/

scripts/ 为可选目录。只有官方来源能够证明持久化目录需要调整权限或存在必要的安装前操作时，才会生成 scripts/init.sh。

生成后可以执行基础校验：

python3 scripts/validate_app_package.py apps/<app-key>

校验范围

校验脚本只检查应用包目录和基础字段，不能替代 docker compose config、镜像可用性检查以及真实安装、启动、停止、重启和卸载测试。

将生成的应用目录复制到 1Panel 本地应用目录：

/opt/1panel/resource/apps/local/<app-key>

进入 应用商店 -> 本地应用，刷新应用列表后进行安装测试。至少需要验证：

敏感信息

不要把真实密码、Token、API Key 或私有仓库凭据写入 spec、README、docker-compose.yml 或示例文件。敏感参数应通过 data.yml 的密码字段由用户在安装时填写。