trydirect/stacker

Stacker — 构建、部署和管理容器化应用

https://img.shields.io/***/578119430391988232?label=***&logo=***&color=5865F2]([***] https://img.shields.io/badge/version-0.2.4-blue](https://github.com/trydirect/stacker/releases) https://img.shields.io/badge/license-MIT-green](https://github.com/trydirect/stacker/blob/main/LICENSE) https://img.shields.io/badge/source-GitHub-***?logo=github](https://github.com/trydirect/stacker)

Stacker 是一个开源平台，通过单个 stacker.yml 配置文件将任何项目转换为可部署的 Docker 栈。它自动生成 Dockerfile、docker-compose 定义、反向代理配置，并支持本地或云提供商部署——可选 AI 辅助功能。

架构

┌──────────────┐         ┌──────────────────┐         ┌─────────────────────┐
│  Stacker CLI │────────▶│  Stacker Server  │────────▶│  Status Panel Agent │
│              │  REST   │                  │  queue  │  (目标服务器上)      │
│  stacker.yml │  API    │  Stack Builder UI│  pull   │                     │
│  init/deploy │         │  48+ MCP 工具     │◀────────│  健康/日志/重启/执行/ │
│  status/logs │         │  Vault · AMQP    │  HMAC   │  应用部署/代理       │
└──────────────┘         └──────────────────┘         └─────────────────────┘
                                │                    
                                ▼                    
                    Terraform + Ansible ──▶ 云服务     
                    (Hetzner, DO, AWS, Linode)        

快速启动

运行 Stacker Server

bash
docker pull docker.xuanyuan.run/trydirect/stacker:latest

docker run -d \
  --name stacker \
  -p 8000:8000 \
  -e DATABASE_URL=postgres://postgres:postgres@db:5432/stacker \
  -e RUST_LOG=info \
  docker.xuanyuan.run/trydirect/stacker:latest

使用 Docker Compose（推荐）

yaml
version: "3.8"

services:
  stacker:
    image: docker.xuanyuan.run/trydirect/stacker:latest
    container_name: stacker
    restart: always
    ports:
      - "8000:8000"
    volumes:
      - ./files:/app/files
      - ./configuration.yaml:/app/configuration.yaml
      - ./access_control.conf:/app/access_control.conf
      - ./migrations:/app/migrations
    environment:
      - RUST_LOG=info
    depends_on:
      db:
        condition: service_healthy

  db:
    image: docker.xuanyuan.run/postgres:16
    restart: always
    environment:
      POSTGRES_DB: stacker
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    volumes:
      - stackerdb:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

  redis:
    image: docker.xuanyuan.run/redis:7
    restart: always

  rabbitmq:
    image: docker.xuanyuan.run/rabbitmq:3-management
    restart: always

volumes:
  stackerdb:

安装 CLI

bash
curl -fsSL https://raw.githubusercontent.com/trydirect/stacker/main/install.sh | bash

bash
cd my-project
stacker init              # 自动检测项目类型，生成 stacker.yml
stacker deploy            # 通过 docker compose 在本地构建和运行
stacker status            # 检查运行中的容器

镜像内容

trydirect/stacker 镜像包含 Stacker Server——一个 Rust 构建的后端，提供以下功能：

REST API 与 Stack Builder UI

• 创建、更新和管理部署项目
• 应用、服务、环境变量、端口映射和域名的完整 CRUD 操作
• 基于角色的访问控制（Cas***）

MCP 服务器（模型上下文协议）

通过 WebSocket 公开 48+ 工具，使 AI 代理（Claude、GPT 等）能够以编程方式管理基础设施：

• 项目和部署管理
• 容器操作（启动、停止、重启、执行）
• 日志分析和错误摘要
• Vault 配置读写
• 代理配置
• 服务器资源监控
• Docker Compose 生成和预览

部署编排

• 本地——在主机上执行 docker compose up
• 云服务——使用 Terraform + Ansible 部署到 Hetzner、DigitalOcean、AWS、Linode
• 服务器——通过 SSH 部署到任何现有服务器

集成

• HashiCorp Vault——密钥和配置存储，同步到部署
• RabbitMQ (AMQP)——事件驱动的部署状态更新
• PostgreSQL——项目、部署和配置的持久存储
• Redis——DockerHub 元数据和会话的缓存层
• TryDirect User Service——OAuth、市场模板

Stacker CLI 亮点

CLI (stacker-cli) 是独立二进制文件——本地部署无需服务器：

AI 驱动的初始化

bash
stacker init --with-ai                          # 本地 AI（Ollama，免费且私有）
stacker init --with-ai --ai-provider openai     # OpenAI
stacker init --with-ai --ai-provider anthropic  # Anthropic

扫描项目文件，检测栈类型，并使用 LLM 生成定制的 stacker.yml，包含服务、代理、监控和钩子。

服务目录（20+ 模板）

bash
stacker service list
stacker service add postgres redis nginx

内置模板：postgres、mysql、mongodb、redis、memcached、rabbitmq、traefik、nginx、nginx_proxy_manager、wordpress、elasticsearch、kibana、qdrant、telegraf、phpmyadmin、mailhog、minio、portainer 等。

stacker.yml 示例

yaml
name: my-app
app:
  type: node
  path: ./src
  ports:
    - "8080:3000"
  environment:
    NODE_ENV: production

services:
  - name: postgres
    image: docker.xuanyuan.run/postgres:16
    environment:
      POSTGRES_DB: myapp
      POSTGRES_PASSWORD: ${DB_PASSWORD}

proxy:
  type: nginx
  auto_detect: true
  domains:
    - domain: app.example.com
      ssl: auto
      upstream: app:3000

deploy:
  target: local

ai:
  enabled: true
  provider: ollama
  model: llama3

monitoring:
  status_panel: true
  healthcheck:
    endpoint: /health
    interval: 30s

支持的项目类型

Stacker 自动检测并生成优化的多阶段 Dockerfile，支持以下类型：

环境变量

暴露端口

卷

标签

链接

• 源代码：https://github.com/trydirect/stacker
• 文档：https://github.com/trydirect/stacker/blob/main/docs/STACKER_YML_REFERENCE.md
• 变更日志：https://github.com/trydirect/stacker/blob/main/CHANGELOG.md
• *******：加入社区
• 网站：stacker.my
• 问题：https://github.com/trydirect/stacker/issues

许可证

MIT — 详见 https://github.com/trydirect/stacker/blob/main/LICENSE%E3%80%82