工具部署｜Arcane：现代化 Docker / Compose 管理面板（替代 Portainer / Dockge 备选）

Arcane 是 2025 年新建、仍在高频迭代的自托管 Docker 管理面板：单容器挂载 Docker socket，即可管理容器／镜像／网络／卷，编辑并启停 Compose 项目，还支持远程 Agent、镜像更新提示等。UI 偏现代轻量，常被拿来对比 Portainer 与 Dockge。本文按官方文档钉死镜像 tag，用 Compose 一键部署，并附实机截图与验证清单。

项目信息

• 上游仓库：https://github.com/getarcaneapp/arcane
• 官网／文档：https://getarcane.app · https://getarcane.app/docs/get-started/installation
• 协议：BSD-3-Clause
• 推荐镜像：ghcr.io/getarcaneapp/manager:v2.17.2（勿用 :next 当生产）
• 默认端口：3552
• 默认登录：arcane / arcane-admin（首次登录会要求改密）

环境前提

• 已安装 Docker 与 Docker Compose v2
• 可访问 /var/run/docker.sock
• 准备一个绝对路径项目目录（示例 /opt/docker）
• 生成 32 字节十六进制 ENCRYPTION_KEY（不要用已弃用的 JWT_SECRET）

openssl rand -hex 32
# 或
docker run --rm ghcr.io/getarcaneapp/manager:v2.17.2 /app/arcane generate secret

一键部署

sudo mkdir -p /opt/arcane /opt/docker
cd /opt/arcane

compose.yaml 示例（密钥请换成你自己的，文中用占位符）：

services:
  arcane:
    image: ghcr.io/getarcaneapp/manager:v2.17.2
    container_name: arcane
    ports:
      - '3552:3552'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - arcane-data:/app/data
      - /opt/docker:/opt/docker
    environment:
      - APP_URL=http://本机IP或域名:3552
      - PUID=1000
      - PGID=1000
      - ENCRYPTION_KEY=<ENCRYPTION_KEY>
      - PROJECTS_DIRECTORY=/opt/docker
      - TZ=Asia/Shanghai
    cgroup: host
    healthcheck:
      test: ['CMD', './arcane', 'health', '--timeout', '2s']
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 15s
    restart: unless-stopped
    stop_grace_period: 15s
volumes:
  arcane-data:

要点：

1. PROJECTS_DIRECTORY 必须与挂载到容器内的同一绝对路径一致
2. APP_URL 写成实际访问地址；若走反代，需支持 WebSocket
3. 启动：

docker compose up -d
docker compose ps

浏览器打开 http://IP:3552，用默认账密登录后立刻改密。

可选：放一个 whoami 方便验证

在 /opt/docker/hello/compose.yaml：

services:
  whoami:
    image: traefik/whoami:v1.10
    container_name: hello-whoami
    ports:
      - '8089:80'
    restart: unless-stopped

在 Arcane 的 Projects 里导入／创建该项目并启动，确认面板能管到本机 Compose。

和 Dockge / Portainer

• vs Dockge：Dockge 更专注 Compose 堆栈；Arcane 额外覆盖容器／镜像／网络／卷与更新提示，更「全家桶」。
• vs Portainer：Portainer 生态更老更全；Arcane 更新更快、UI 更现代，家服圈常当尝鲜替代，成熟度仍以 Portainer 为参照。

风险提示

1. 挂载 docker.sock ≈ 本机 Docker root 权限，勿公网裸奔 3552。
2. 默认口令必须首登修改；ENCRYPTION_KEY 丢失可能导致已加密数据难恢复，备份 arcane-data 时一并保管密钥。
3. 版本迭代快，上线前再对一下官方安装文档。
4. 请遵守 BSD-3-Clause；本文仅供学习与自用部署参考。

验证清单

• 容器 healthy，能打开登录页
• 能登录并完成改密
• 能看到本机 Docker 容器／镜像
• 能部署测试 Compose（如 whoami）
• 镜像 tag 为 v2.17.2，compose 中无 JWT_SECRET
• 3552 未对公网裸奔（或已上反代＋鉴权／防火墙）