Skip to content

arch3rPro/1Panel-Appstore / skills

1panel-app-builder

Verified

Use when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories, icons, README files, and 1Panel validation.

FileKindSize
README.mdmarkdown2.6 KB
SKILL.mdskill md5.1 KB
evals/evals.jsonconfig1.6 KB
examples/example-usage.mdmarkdown2.3 KB
references/1panel-examples.mdmarkdown9.1 KB
scripts/download-icon.shexecutablescript7.6 KB
scripts/generate-app.shexecutablescript27.0 KB
scripts/validate-app.shexecutablescript11.6 KB
templates/data.yml.tplother1.1 KB
templates/docker-compose.yml.tplother396 B
tests/run_all.shexecutablescript358 B
tests/test_skills_scripts.shexecutablescript13.4 KB

references/1panel-examples.md

View on GitHub
# 1Panel 应用商店参考示例

本文件包含从 1Panel-Appstore 和 appstore 官方仓库提取的实际应用配置示例。

## 目录

1. [简单单服务应用](#简单单服务应用)
2. [带数据库的应用](#带数据库的应用)
3. [多端口应用](#多端口应用)
4. [多服务应用](#多服务应用)
5. [常见标签分类](#常见标签分类)

---

## 简单单服务应用

### 示例:AList

**目录结构:**
```
alist/
├── logo.png
├── data.yml           # 顶层元数据
├── README.md
├── README_en.md
└── 3.45.0/            # 版本目录
    ├── data.yml       # 参数定义
    ├── docker-compose.yml
    └── data/          # 数据目录
```

**顶层 data.yml:**
```yaml
name: AList
tags:
    - 实用工具
    - 云存储
title: 支持多存储的文件列表程序和私人网盘
description: 支持多存储的文件列表程序和私人网盘
additionalProperties:
    key: alist
    name: AList
    tags:
        - Storage
        - Tool
    shortDescZh: 支持多存储的文件列表程序和私人网盘
    shortDescEn: Supporting multi-storage file listing program and private cloud storage
    description:
        en: Supporting multi-storage file listing program and private cloud storage
        ja: 複数ストレージのファイルリスト表示プログラムとプライベートクラウドストレージのサポート
        ms: Menyokong program senarai fail multi-penyimpanan dan penyimpanan awan peribadi
        pt-br: Suporte para programa de listagem de arquivos em múltiplos armazenamentos e armazenamento em nuvem privado
        ru: Поддержка программы отображения файлов в нескольких хранилищах и частного облачного хранилища
        ko: 다중 저장소 파일 목록 프로그램 및 개인 클라우드 저장소 지원
        zh-Hant: 支援多存儲檔案列出程序和私人雲端空間
        zh: 支持多存储文件列出程序和私有云存储
    type: website
    crossVersionUpdate: true
    limit: 0
    recommend: 65
    website: https://alist.nn.ci/
    github: https://github.com/alist-org/alist
    document: https://alist.nn.ci/zh/guide/
    architectures:
      - amd64
      - arm64
      - arm/v7
      - arm/v6
      - s390x
```

**版本 data.yml(参数定义):**
```yaml
additionalProperties:
    formFields:
        - default: 5244
          edit: true
          envKey: PANEL_APP_PORT_HTTP
          labelEn: WebUI Port
          labelZh: 网页端口
          required: true
          rule: paramPort
          type: number
          label:
            en: WebUI Port
            ja: WebUI ポート
            ms: Port WebUI
            pt-br: Porta WebUI
            ru: Порт WebUI
            ko: WebUI 포트
            zh-Hant: WebUI 埠
            zh: WebUI 端口
        - default: 5426
          edit: true
          envKey: PANEL_APP_PORT_S3
          labelEn: S3 Port
          labelZh: S3 端口
          required: true
          rule: paramPort
          type: number
          label:
            en: S3 Port
            ja: S3 ポート
            ms: Port S3
            pt-br: Porta S3
            ru: Порт S3
            ko: S3 포트
            zh-Hant: S3 埠
            zh: S3 端口
```

**docker-compose.yml:**
```yaml
services:
  alist:
    container_name: ${CONTAINER_NAME}
    restart: always
    networks:
      - 1panel-network
    ports:
      - "${PANEL_APP_PORT_HTTP}:5244"
      - "${PANEL_APP_PORT_S3}:5426"
    volumes:
      - ./data/data:/opt/alist/data
      - ./data/mnt:/mnt/data
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
    image: xhofe/alist:v3.45.0
    labels:  
      createdBy: "Apps"
networks:  
  1panel-network:  
    external: true
```

---

## 带数据库的应用

### 示例:NocoDB(PostgreSQL)

**docker-compose.yml:**
```yaml
services:
  nocodb:
    container_name: ${CONTAINER_NAME}
    restart: always
    networks:
      - 1panel-network
    ports:
      - "${PANEL_APP_PORT_HTTP}:8080"
    volumes:
      - ./data/nocodb:/usr/app/data
    environment:
      - NC_DB=pg://${DB_USER}:${DB_PASSWORD}@db:5432/${DB_NAME}
      - NC_AUTH_JWT_SECRET=${JWT_SECRET}
    depends_on:
      db:
        condition: service_healthy
    image: nocodb/nocodb:0.258.2
    labels:
      createdBy: "Apps"
  db:
    image: postgres:16-alpine
    restart: always
    networks:
      - 1panel-network
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=${DB_NAME}
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
      interval: 5s
      timeout: 5s
      retries: 5
networks:
  1panel-network:
    external: true
```

**参数定义:**
```yaml
- default: 8080
  edit: true
  envKey: PANEL_APP_PORT_HTTP
  labelEn: Web Port
  labelZh: Web端口
  required: true
  rule: paramPort
  type: number
- default: nocodb
  edit: true
  envKey: DB_NAME
  labelEn: Database Name
  labelZh: 数据库名称
  required: true
  rule: paramCommon
  type: text
- default: nocodb
  edit: true
  envKey: DB_USER
  labelEn: Database User
  labelZh: 数据库用户
  required: true
  rule: paramCommon
  type: text
- default: nocodb_password
  edit: true
  envKey: DB_PASSWORD
  labelEn: Database Password
  labelZh: 数据库密码
  required: true
  rule: paramCommon
  type: password
```

---

## 多端口应用

### 示例:Nginx Proxy Manager

**参数定义:**
```yaml
formFields:
  - default: 81
    edit: true
    envKey: PANEL_APP_PORT_HTTP
    labelEn: Admin Port
    labelZh: 管理端口
    required: true
    rule: paramPort
    type: number
  - default: 80
    edit: true
    envKey: PANEL_APP_PORT_NGINX_HTTP
    labelEn: HTTP Port
    labelZh: HTTP端口
    required: true
    rule: paramPort
    type: number
  - default: 443
    edit: true
    envKey: PANEL_APP_PORT_NGINX_HTTPS
    labelEn: HTTPS Port
    labelZh: HTTPS端口
    required: true
    rule: paramPort
    type: number
```

**docker-compose.yml:**
```yaml
services:
  app:
    container_name: ${CONTAINER_NAME}
    restart: always
    networks:
      - 1panel-network
    ports:
      - "${PANEL_APP_PORT_HTTP}:81"
      - "${PANEL_APP_PORT_NGINX_HTTP}:80"
      - "${PANEL_APP_PORT_NGINX_HTTPS}:443"
    volumes:
      - ./data/data:/data
      - ./data/letsencrypt:/etc/letsencrypt
    image: jc21/nginx-proxy-manager:latest
    labels:
      createdBy: "Apps"
networks:
  1panel-network:
    external: true
```

---

## 多服务应用

### 示例:Dify(完整栈)

**docker-compose.yml:**
```yaml
services:
  api:
    container_name: ${CONTAINER_NAME}
    restart: always
    networks:
      - 1panel-network
    ports:
      - "${PANEL_APP_PORT_HTTP}:80"
    volumes:
      - ./data/storage:/app/api/storage
    environment:
      - MODE=api
      - SECRET_KEY=${SECRET_KEY}
    depends_on:
      - db
      - redis
    image: langgenius/dify-api:latest
    labels:
      createdBy: "Apps"
  worker:
    restart: always
    networks:
      - 1panel-network
    environment:
      - MODE=worker
      - SECRET_KEY=${SECRET_KEY}
    depends_on:
      - db
      - redis
    image: langgenius/dify-api:latest
  db:
    image: postgres:15-alpine
    restart: always
    networks:
      - 1panel-network
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=${DB_NAME}
  redis:
    image: redis:7-alpine
    restart: always
    networks:
      - 1panel-network
    volumes:
      - ./data/redis:/data
networks:
  1panel-network:
    external: true
```

---

## 常见标签分类

### 中文标签(tags)

| 分类 | 标签 |
|------|------|
| 开发工具 | 开发工具 |
| 实用工具 | 实用工具 |
| 文档与笔记 | 文档与笔记 |
| 云存储 | 云存储 |
| 数据库 | 数据库 |
| 监控运维 | 监控运维 |
| 安全工具 | 安全工具 |
| 网络工具 | 网络工具 |
| 建站工具 | 建站工具 |
| AI/LLM | AI/LLM |
| 容器管理 | 容器管理 |

### 英文标签(additionalProperties.tags)

| 分类 | 标签 |
|------|------|
| 开发工具 | DevTool |
| 实用工具 | Utility |
| 文档与笔记 | Note |
| 云存储 | Storage |
| 数据库 | Database |
| 监控运维 | Monitor |
| 安全工具 | Security |
| 网络工具 | Network |
| 建站工具 | Website |
| AI/LLM | AI |
| 容器管理 | Container |

### 应用类型(type)

| 类型 | 说明 |
|------|------|
| website | Web应用(默认) |
| runtime | 运行时环境(数据库等) |
| tool | 命令行工具 |

---

## 最佳实践

1. **版本号**:使用实际的镜像标签版本,如 `v3.45.0`,而非 `latest`
2. **推荐值**:优质应用设置 recommend: 60-80,一般应用 30-50
3. **架构支持**:至少支持 amd64 和 arm64
4. **多语言**:至少提供中英文描述,推荐添加日韩俄等语言
5. **数据持久化**:使用 `./data/` 目录,避免绝对路径
6. **环境变量**:敏感信息使用 password 类型参数
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall