5 步搞定 Arcane 部署：开源 Docker 管理平台的极简搭建指南

5 步搞定 Arcane 部署开源 Docker 管理平台的极简搭建指南【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcaneArcane 是一款面向所有人的现代化 Docker 管理平台它把容器、镜像、项目、环境与资源监控收进一个清爽的 Web 界面里让您不必再对着命令行逐条敲docker ps。这篇 Arcane 部署指南会带您从零起步用 Docker Compose 在十几分钟内把它跑起来并完成首次环境接入全程只依赖一个容器镜像干净利落。图Arcane 主界面仪表盘容器、镜像、存储与 CPU/内存占用一目了然先弄明白Arcane 到底解决什么问题管理 Docker 的痛点往往不在能不能跑而在看不看得清。机器一多容器一散谁在占资源、哪个镜像该清理、日志去哪里翻全凭记忆和命令轮换。Arcane 的思路很直白把整台机器的运行状态搬进浏览器支持环境切换、项目化部署、镜像更新、定时任务、系统级监控甚至能通过 Agent 把远程节点拉进同一张控制台。简单说它是给 Docker 装了一块仪表盘让新手也能看懂全局。检查环境并备好两把钥匙动手前先确认三件事Linux 系统Ubuntu 20.04 或 CentOS 8 均可、Docker 20.10 以上、Docker Compose v2。用下面两条命令快速体检docker --version docker compose version接下来克隆项目仓库模板配置都藏在docker/examples/目录里git clone https://gitcode.com/gh_mirrors/arcane2/arcane cd arcane cp docker/examples/compose.basic.yaml compose.yaml打开compose.yaml有两个环境变量必须替换ENCRYPTION_KEY和JWT_SECRET各填一段 32 位随机字符串比如openssl rand -hex 16生成的值它们分别负责数据加密与登录令牌签名。若想管理宿主机上指定目录里的项目文件再把PROJECTS_DIRECTORY改成真实路径并挂载进容器即可。这两把钥匙没配好服务也能起但安全性与持久化都会打折扣。一条命令启动 Arcane配置就绪后回到项目根目录执行docker compose -f compose.yaml up -dCompose 会拉取官方镜像ghcr.io/getarcaneapp/manager:latest挂载/var/run/docker.sock以便读取宿主机 Docker 信息并自动创建数据卷arcane-data存放配置与状态。稍等片刻用健康检查确认就绪docker compose -f compose.yaml ps看到healthy状态就说明服务已经站稳了。启动失败也别慌先翻日志定位原因方法见文末排障速查。登录后台并加固默认账户打开浏览器访问http://您的服务器IP:3552首次进入会看到欢迎页。默认管理员账号是adminlocalhost初始密码为arcane-admin——注意这套默认凭据仅用于首登请立刻在个人设置里改掉避免被扫描器盯上。改密完成后建议顺手开启两步验证MFA给管理入口再加一道锁。接入本地 Docker 环境创建第一个项目登录后先做两件核心操作。第一添加环境在左侧导航进入Environments点击Add Environment名称随意Docker API 地址填本地默认的unix:///var/run/docker.sock保存后仪表盘就会开始汇报本机容器、镜像与资源曲线。第二创建项目进入Projects→New Project填好名称与描述关联刚添加的环境并提交。之后就可以在这个项目下部署服务、追踪镜像更新所有操作都在网页上完成不用再 SSH 进服务器逐行敲命令。进阶玩法远程节点与安全代理单机只是起点。想让多台服务器共用同一控制台仓库里还提供了两套进阶模板远程节点参照docker/examples/compose.agent.yaml在目标机器上启动arcane-agent容器配置MANAGER_API_URL指向主控端地址、AGENT_TOKEN填入主控端生成的令牌远程主机即可经加密通道接入统一管理。安全代理docker/examples/compose.proxy.yaml在容器与 Docker socket 之间加了一层docker-socket-proxy按需开放 API 权限适合对安全敏感的部署场景将主机权限暴露面降到最低。建议先在本地环境把基本流程走顺再逐步扩展到多节点架构。排障速查日志、密码与常见坑症状处理方式容器反复重启docker compose -f compose.yaml logs -f查看启动日志多数与密钥格式或目录权限有关忘记管理员密码docker exec -it arcane ./arcane cli admin reset-password --username adminlocalhost按提示重置环境连不上 Docker确认宿主机 Docker 版本检查 socket 路径与挂载是否生效端口被占用修改compose.yaml中3552:3552的左侧宿主机端口后重新启动收个尾从跑起来到管得好走到这里您已经完成了 Arcane 的完整部署环境变量备齐、容器启动、默认账户加固、本地 Docker 环境接入并了解了远程节点与安全代理的扩展方向。下一步可以翻翻仓库里的docker/examples/目录琢磨多节点编排或研究backend/cli/admin/了解命令行管理能力——文档与示例都随项目代码一起维护随时可查。当那块实时跳动的仪表盘第一次在您浏览器里亮起时那种整台服务器尽在掌握的感觉值得您亲手体验一次。【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考