Docker项目实战：轻松部署你的Arcane容器管理平台

原创

江湖有缘

修改于 2025-09-12 15:53:47

470

文章被收录于专栏：Docker项目实战Docker项目实战

一、Arcane介绍

1.1 Arcane简介

Arcane是一个现代化的、基于 Web 的 Docker 管理面板，使用 SvelteKit 构建。它提供了一个简洁直观的界面和强大的管理工具，帮助用户集中管理容器、镜像、数据卷和网络等 Docker 资源。

1.2 Arcane主要特点

现代 Web 界面：采用 SvelteKit 构建，界面清爽、响应迅速，操作体验良好。
容器全面管理：支持对运行中的容器进行启动、停止、重启、日志查看等操作。
镜像管理功能：可浏览本地镜像列表，并支持构建、拉取与删除操作。
网络与数据卷可视化：清晰展示 Docker 网络和数据卷信息，便于管理和调试。
Stack 配置支持：支持通过 Compose 文件定义并部署应用栈，便于服务编排。
配置数据持久化：用户设置和 Stack 定义保存在挂载的数据卷中，保障配置不丢失。
轻量高效：资源占用低，部署简单，适合本地开发与小型部署环境。
安全提示机制：明确提醒用户挂载 Docker Socket 的安全风险，提升安全意识。
持续开发更新：项目处于活跃开发阶段，不断引入新特性与改进。

注意：由于 Arcane 需要挂载 Docker Socket，因此应谨慎评估其在生产环境中的安全性。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Ubuntu 22.04.1。

hostname	IP地址	操作系统版本	Docker版本	部署项目
jeven01	192.168.3.88	Ubuntu 22.04.1 LTS	27.1.1	Arcane

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎； 2.在Docker环境下部署的Arcane容器管理平台。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~#  systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2025-07-02 14:16:57 UTC; 21h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 878 (dockerd)
      Tasks: 28
     Memory: 1.2G
        CPU: 1min 50.356s
     CGroup: /system.slice/docker.service
             ├─  878 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、拉取Arcane镜像

拉取Arcane容器镜像，如下所示：

docker pull ghcr.io/ofkm/arcane:latest

五、部署Arcane服务

5.1 创建部署目录

mkdir -p /data/arcane   &&  cd /data/arcane

5.2 编辑部署文件

在部署目录下，创建docker-compose.yaml文件。

vim docker-compose.yaml

services:
  arcane:
    image: ghcr.io/ofkm/arcane:latest
    container_name: arcane
    ports:
      - '3000:3000' # Exposes Arcane's web interface on port 3000 of the host.
    volumes:
      # Mount the Docker socket to allow Arcane to manage Docker.
      - /var/run/docker.sock:/var/run/docker.sock
      # Mount a volume for Arcane's persistent data (stacks, settings, etc.).
      # Replace './arcane-data' with your preferred host path.
      - /data/arcane/data:/app/data
      # This is where you existing stack files are located if you want to import them, when arcane tries
      # to import it it will need to read from the path the compose file is at, hence why onl read only is needed.
      - /data/arcane/stacks:/opt/my-docker-stacks:ro # Host path : Container path
    environment:
      - APP_ENV=production # Sets the application environment to production.

      # --- User and Group ID Configuration (Optional but Recommended for Volume Permissions) ---
      # These variables control the user and group Arcane runs as inside the container.
      # Matching these to your host user's UID/GID can help avoid permission issues
      # with the mounted /app/data volume.
      - PUID=1000 # User ID for the 'arcane' user inside the container. Defaults to 1000.
      - PGID=1000 # Group ID for the 'arcane' group inside the container. Defaults to 1000.

      # --- Docker Group ID (Usually Handled Automatically) ---
      # - DOCKER_GID=998 # GID for the 'docker' group inside the container.
                         # The entrypoint script typically auto-detects and sets this based on the
                         # GID of the mounted /var/run/docker.sock.
                         # Only set this if you have a specific need or the auto-detection fails.

      # --- Session Configuration ---
      # Generate a strong secret using: openssl rand -base64 32
      - PUBLIC_SESSION_SECRET=MpqbFH7NPbft68HbsjTDZL1mGvtN//FIkFzO1AgOJhE=

      # --- Advanced/Debugging (Uncomment if needed) ---
      # - PUBLIC_ALLOW_INSECURE_COOKIES=true # Uncomment only for local HTTP testing without SSL/TLS.
      # - NODE_ENV=development # For development-specific behaviors (not recommended for production).

    restart: unless-stopped # Ensures the container restarts automatically unless manually stopped.

# Optional: Define the volume if you want Docker to manage it explicitly.
# This allows for easier management with `docker volume` commands.
# volumes:
#   arcane-data:
#     driver: local # Or your preferred volume driver

5.3 创建Arcane容器

执行以下命令，创建Arcane容器。

docker compose up -d

5.4 查看Arcane容器状态

检查Arcane容器运行状态，确保Arcane容器正常启动。

root@jeven01:/data/arcane# docker ps
CONTAINER ID   IMAGE                        COMMAND                  CREATED         STATUS         PORTS                                         NAMES
7f896f1c5621   ghcr.io/ofkm/arcane:latest   "/usr/local/bin/entr…"   3 minutes ago   Up 3 minutes   0.0.0.0:3000->3000/tcp, [::]:3000->3000/tcp   arcane