Arcane – Công cụ quản lý Docker dễ sử dụng

Arcane là một giao diện quản lý Docker mã nguồn mở, tự host, được thiết kế để đơn giản hóa việc quản lý container, image, volume và network. Với hơn 1.600 sao trên GitHub và cộng đồng đang phát triển, Arcane nổi bật nhờ giao diện hiện đại, tốc độ nhanh và tính năng mạnh mẽ, phù hợp cho người dùng homelab, developer hoặc admin hệ thống. Đây là lựa chọn thay thế nhẹ nhàng cho Portainer hay Dockge, tập trung vào sự đơn giản mà không mất đi chức năng cốt lõi.

Chức năng chính của Arcane

Arcane cung cấp giao diện trực quan để quản lý toàn bộ hệ sinh thái Docker, với các tính năng nổi bật sau:

Quản lý Container

• Xem tổng quan container với cập nhật trạng thái thời gian thực, sử dụng tài nguyên và hành động nhanh (start/stop/restart).
• Chi tiết sâu: Kiểm tra cấu hình, xem logs, quản lý port và chỉnh sửa container dễ dàng.

Quản lý Image

• Duyệt image cục bộ, pull từ registry và dọn dẹp image không dùng để giải phóng dung lượng.
• Theo dõi “image maturity” để đảm bảo độ sẵn sàng cho production, với xác thực tự động.

Quản lý Network và Volume

• Tạo và quản lý Docker network/volume qua giao diện thân thiện.
• Hỗ trợ mount volume, quản lý port và tổ chức dự án qua Compose Projects.

Theo dõi hiệu suất

• Giám sát CPU, memory, network và disk usage thời gian thực, kèm dữ liệu lịch sử.
• Dark mode tích hợp, chỉ báo trạng thái và layout linh hoạt.

Tính năng nâng cao

• Hỗ trợ đa ngôn ngữ qua Crowdin.
• Quản lý project Compose để tổ chức file YAML.
• Tích hợp tốt với Docker/OCI, chạy mượt mà trên Linux, Windows và macOS.

Arcane được xây dựng bằng SvelteKit (frontend) và Go (backend), đảm bảo hiệu suất cao và nhẹ nhàng.

Hướng dẫn cài đặt chi tiết

Arcane dễ cài đặt qua Docker Compose, yêu cầu Docker Engine và Docker Compose đã cài sẵn. Dưới đây là hướng dẫn từng bước cho Ubuntu 24.04 (có thể áp dụng tương tự cho hệ thống khác).

Yêu cầu hệ thống

• Docker Engine và Docker Compose plugin.
• Máy chủ với ít nhất 2GB RAM.
• Port 3000 (hoặc tùy chỉnh) mở cho truy cập web.
• Người dùng với quyền sudo.

Cài Docker trên Ubuntu 24.04 (nếu chưa có)

(1). Xóa phiên bản cũ:

sudo apt remove docker docker-engine docker.io containerd runc

(2). Cài dependencies và key:

sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo \"$VERSION_CODENAME\") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

(3). Cài Docker:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

(4). Thêm user vào group Docker (không cần sudo):

sudo usermod -aG docker $USER
newgrp docker

Cài đặt Arcane qua Docker Compose

(1). Tạo thư mục dự án:

mkdir -p ~/arcane && cd ~/arcane

(2). Tạo file compose.yml:

nano compose.yml

Dán nội dung sau (thay port nếu cần):

version: '3.9'
services:
  arcane:
    image: ghcr.io/ofkm/arcane:latest
    container_name: arcane
    ports:
      - '3000:3000'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./arcane-data:/app/data
    environment:
      - APP_ENV=production
      - PUBLIC_SESSION_SECRET=your_super_strong_random_secret_here  # Tạo bằng: openssl rand -base64 32
      - PUID=1000  # Optional: UID của user host
      - PGID=1000  # Optional: GID của user host
      # - DOCKER_GID=998  # Nếu gặp lỗi Docker access
      # - PUBLIC_ALLOW_INSECURE_COOKIES=true  # Chỉ cho test HTTP local
    restart: unless-stopped

(3). Khởi động:

nano compose.yml

(4). Kiểm tra:

docker ps  # Xem container arcane đang chạy

Arcane sẽ chạy tại http://your_ip:3000.

Cập nhật Arcane

• Pull image mới và restart:

docker compose pull docker compose up -d

Backup và Restore

• Backup dữ liệu: Sao chép thư mục ./arcane-data.
• Restore: Dừng container, thay thế thư mục và khởi động lại.

Lỗi thường gặp

• Permission denied: Đảm bảo volume Docker sock được mount đúng và user thuộc group Docker.
• Queue full: Kiểm tra tài nguyên máy chủ.
• Insecure cookies: Chỉ dùng cho test local, không khuyến khích production.

Hướng dẫn sử dụng chi tiết

Truy cập Dashboard

• Mở trình duyệt: http://your_ip:3000.
• Đăng nhập lần đầu: Username arcane, Password arcane-admin (thay đổi ngay sau khi login).

Quản lý Container

• Dashboard: Xem tổng quan container, click để start/stop/restart.
• Chi tiết: Chọn container > Inspect > Xem logs, stats thời gian thực.
• Chỉnh sửa: Chỉnh port, volume hoặc rebuild container.

Quản lý Image và Project

• Images: Pull image mới, xóa image cũ.
• Compose Projects: Upload/Tạo file YAML để deploy stack.
• Tương thích Dockge: Có thể dùng với stack Dockge, nhưng cẩn thận tránh xung đột (không khuyến khích mix).

Quản lý Network/Volume

• Tạo network mới, kết nối container.
• Quản lý volume: Tạo, mount và xóa.

Theo dõi và Cài đặt

• Stats: Xem biểu đồ CPU/memory/network.
• Settings: Thay đổi theme (dark mode), ngôn ngữ và secret.
• Deploy Stack: Từ tab Projects, upload compose.yml và deploy.

Ví dụ deploy một stack đơn giản (ví dụ Nginx):

• Tạo file YAML với nội dung cơ bản.
• Upload vào Projects > Deploy > Theo dõi tiến trình.

Lợi ích và lưu ý

Arcane tiết kiệm thời gian với giao diện sạch sẽ, nhanh chóng và không yêu cầu cấu hình phức tạp. Nó lý tưởng cho self-hosting, hỗ trợ remote Docker (sắp tới). Tuy nhiên, vẫn đang phát triển (v1.2.1 mới nhất ngày 23/09/2025), nên theo dõi updates trên GitHub.

Nếu bạn cần hỗ trợ, tham gia Crowdin để dịch hoặc contribute code. Arcane miễn phí dưới license BSD-3-Clause, giúp bạn kiểm soát Docker mà không phụ thuộc dịch vụ bên thứ ba.