sacconazzo/dev-suite

Dev Suite

Dev Suite是一个即开即用的多提供商代理控制平面，提供Web仪表盘用于管理代码仓库和由Claude Code、Codex CLI、GitHub Copilot CLI或OpenCode驱动的持久化代理会话。该镜像可直接拉取运行，无需源码检出或本地镜像构建。

镜像信息

text
docker.io/sacconazzo/dev-suite

镜像支持linux/amd64和linux/arm64架构：

• latest：跟踪最新发布的构建版本
• x.y.z：指定稳定的发布版本（推荐用于生产环境）
• sha-<commit>：指定从特定提交构建的镜像

依赖要求

• Docker Engine和Docker Compose v2
• 至少一个支持的代理提供商账户
• 具有repo、read:org和workflow权限的GitHub个人访问令牌

快速启动

创建compose.yml文件：

yaml
name: ${INSTANCE_NAME:-dev-suite}

services:
  dev-suite:
    image: docker.xuanyuan.run/sacconazzo/dev-suite:${DEV_SUITE_TAG:-latest}
    restart: unless-stopped
    hostname: ${INSTANCE_NAME:-dev-suite}
    cap_add:
      - NET_ADMIN
      - NET_RAW
    ports:
      - "${DASHBOARD_PORT:-7007}:7007"
    environment:
      HOME: /home/node
      CLAUDE_CONFIG_DIR: /home/node/.claude
      DASHBOARD_PORT: "7007"
      INSTANCE_NAME: ${INSTANCE_NAME:-dev-suite}
      INSTANCE_DISPLAY_NAME: ${INSTANCE_DISPLAY_NAME:-}
      DASHBOARD_SECRET: ${DASHBOARD_SECRET:-}
      WEBHOOK_SECRET: ${WEBHOOK_SECRET:-}
      TS_AUTHKEY: ${TS_AUTHKEY:-}
    volumes:
      - dev-suite-home:/home/node
      - dev-suite-workspace:/workspace
    working_dir: /orchestrator
    command: sh -lc 'bash /orchestrator/entrypoint.sh'
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:7007/health"]
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 30s

volumes:
  dev-suite-home:
  dev-suite-workspace:

启动容器：

bash
docker compose up -d

打开http://localhost:7007，首次启动时仪表盘会引导你启用代理提供商、完成认证并连接GitHub。提供商凭据、配置和克隆的仓库会持久化在两个命名卷中。

仪表盘还包含预设（Presets）：可复用的、与提供商无关的指令块，可排序组合成新会话或定时消息；预设修订和调度器引用会保存在home卷中。

运行服务视图会发现活跃子会话启动的TCP服务器，每10秒刷新一次；卡片显示监听端口，当服务可通过Tailscale访问时会出现Open操作。

配置说明

在compose.yml旁创建可选的.env文件：

dotenv
DEV_SUITE_TAG=latest
INSTANCE_NAME=dev-suite
DASHBOARD_PORT=7007
# INSTANCE_DISPLAY_NAME=My Dev Suite
# DASHBOARD_SECRET=use-a-long-random-secret
# WEBHOOK_SECRET=use-a-different-long-random-secret
# TS_AUTHKEY=tskey-auth-...

注意：未设置DASHBOARD_SECRET或未通过其他认证层保护时，请勿将仪表盘暴露在不可信网络中。

操作指南

拉取并启动指定镜像：

bash
docker compose pull
docker compose up -d

查看日志或检查容器健康：

bash
docker compose logs -f dev-suite
docker compose ps

停止服务（不删除持久化数据）：

bash
docker compose down

命名卷会被docker compose down保留；删除卷会同时移除存储的凭据、配置和工作区数据。

许可证

DevSuite遵循MIT许可证。