跳至主要内容

Arcane：Docker 與 GitOps 管理平台

Arcane 是一款採用 Go 後端與 SvelteKit 前端架構的新世代 Docker 管理工具。它專為熟悉 Docker Compose 且希望進一步引入 GitOps 自動化 與多使用者權限控管的使用者打造。

主要特色​

  1. 原生 GitOps 自動同步：連接 GitHub、Forgejo 或 GitLab 儲存庫，當 Git 倉庫中的 compose.yaml 有更新時，Arcane 會自動拉取並重啟容器。
  2. 完整的容器資源管理：在單一介面視覺化檢視 Containers、Images、Volumes、Networks 與 Stacks。
  3. 多用戶與 OIDC 支援：內建精細的 RBAC 角色權限管理，並支援與 Pocket ID 或 Authentik 整合單一登入。
  4. 安全檢測與即時監控：提供映像檔安全漏洞掃描、即時 CPU/RAM 資源監控與 Web 終端機 (Web Shell)。

部署步驟 (Docker Compose)​

在 Ubuntu Server 終端機中執行：

1. 建立目錄​

sudo mkdir -p /opt/stacks/arcane/data
cd /opt/stacks/arcane

2. 建立 compose.yaml​

services:
  arcane:
    image: ghcr.io/getarcaneapp/arcane:latest
    container_name: arcane
    restart: unless-stopped
    ports:
      - "3001:3000"
    volumes:
      # 掛載 Docker Socket 以便管理主機容器
      - /var/run/docker.sock:/var/run/docker.sock
      # 掛載持久化資料庫與設定檔
      - ./data:/app/data
    environment:
      - APP_URL=http://localhost:3001
      - TZ=Asia/Taipei

3. 啟動服務​

sudo docker compose up -d

初始設定與 GitOps 串接​

  1. 建立管理員：瀏覽器前往 http://<VM_IP>:3001，完成管理員帳號註冊。
  2. 建立 GitOps 專案 (Project)：
    • 在左側選單點擊 Projects -> Add Project。
    • 選擇 Git Repository，輸入你的 Forgejo 或 GitHub 倉庫網址與 Access Token。
    • 指定倉庫內的 compose.yaml 路徑與分支 (Branch)。
    • 開啟 Auto Sync，日後只要在電腦上 git push，Arcane 即會自動部署最新架構。

Dockge 與 Arcane 選型對比​

比較維度DockgeArcane
底層哲學純檔案目錄讀寫，無額外資料庫具備專用資料庫與專案管理系統
Git 整合需手動執行 git 指令或寫排程原生支援 Git 倉庫自動輪詢與 Webhook 同步
權限控管單一管理員密碼完整多用戶 RBAC 與 OIDC 支援
適合場景單機極簡維運、新手首選多伺服器、團隊協同或 GitOps 自動化

相關連結​