告别容器黑盒Arcane Docker 管理平台从零上手实战指南【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcane手动敲docker ps、docker logs、再逐个容器exec进去排查的日子想必每位运维都深有体会。当主机上的容器超过十个镜像堆积到几十个靠命令行拼凑出全局视角几乎是一种奢望。这正是我寻找Docker 管理平台的初衷而 Arcane——一个号称为所有人设计的开源项目——最终留在了我的工具箱里。这篇文章不讲官方文档的复述只分享我从部署到跑通第一个项目的完整实战过程以及那些文档里没明说的坑。一、为什么我不选 Portainer而选了 Arcane选型之前我列了三道硬性考题能不能管多台主机、界面能不能看得懂、以及最关键的——部署成本是否低到一键级别。与同类工具的差异点在哪里多数面板要么只盯着单机 Docker要么把 Swarm 集群功能塞得又重又深。Arcane 的切入点不同它把管理器 边缘代理拆成了两个角色——主控端负责 Web 界面与编排Agent 负责在远端主机上执行操作二者通过加密隧道通信。这意味着我可以用一个管理界面统一调度多台机器而不是每台主机各装一套面板。一眼看懂的技术底座后端是 Go前端是 SvelteKit整个界面默认深色主题。仪表盘把环境、容器、镜像、存储用量直接铺在卡片上CPU、内存、磁盘占用一屏尽收上图就是 Arcane 的控制台首页左侧导航把管理、资源、集群、设置分得清清楚楚顶部还能一键在全部与当前环境之间切换。对我这种习惯先看概览再钻细节的人这种布局比一上来就是密密麻麻的容器列表友好得多。二、三步完成 Docker 环境初始化Arcane 的部署方式走的是容器管容器路线用 Docker 跑一个管理 Docker 的容器主程序镜像自带前后端和数据库SQLite连外部依赖都不需要额外装。第一步拉取源码与镜像先把仓库克隆到服务器上仅当需要研究源码或自编译时才必须纯部署可以跳过这一步直接走下面的 Compose 文件git clone https://gitcode.com/gh_mirrors/arcane2/arcane实际部署只需要两个镜像ghcr.io/getarcaneapp/manager主控端和ghcr.io/getarcaneapp/agent远端代理。仓库里docker/examples/目录提供了现成的 Compose 模板省去手搓配置的麻烦。第二步填写两个关键密钥打开docker/examples/compose.basic.yaml最值得注意的不是端口映射默认 3552而是两个环境变量ENCRYPTION_KEY用来加密数据库中的敏感数据必须换成随机 32 位字符串JWT_SECRET登录令牌的签名密钥同样建议随机生成。 实战提醒我第一遍部署时偷懒用了默认值虽然服务能起来但一旦换机器迁移数据密钥不一致会导致加密数据无法解密。建议用openssl rand -hex 16生成两个不同密钥分别填入别图省事。第三步挂载 Docker 套接字并启动compose.basic.yaml的核心是把宿主机的/var/run/docker.sock挂进容器这是 Arcane 操控 Docker 的通道同时把PROJECTS_DIRECTORY指向一个宿主机目录用于存放项目文件。配置里的cgroup: host是点睛之笔——它让容器能更准确地识别自身 ID避免把自己误当成普通业务容器管理。保存后启动并观察健康状态docker compose -f docker/examples/compose.basic.yaml up -d docker compose -f docker/examples/compose.basic.yaml ps镜像内部自带arcane health健康检查命令Compose 里已经写好了探针启动十几秒后状态变为 healthy 就说明一切正常。三、一条命令拉起全部服务组件然后登录后台首次登录默认管理员账户服务起来后浏览器访问http://服务器IP:3552。首次登录用的内置管理员账号是项目值用户名arcane初始密码arcane-admin登录后第一件事就是进设置页修改密码——这一点和所有管理类系统一样默认凭据不改等于把钥匙挂在门口。界面里能做什么登录后的核心区域按资源组织容器、镜像、更新、网络、卷。以容器为例列表支持按名称搜索、按状态过滤点进去就能看日志、进终端、看实时资源占用常见的启停、重建、删除操作都不需要再回到命令行。镜像页还会显示使用中/未使用占比配合一键清理未使用镜像直接帮我找回了 600MB 磁盘空间。多主机加一个 Agent 即可覆盖如果你和我一样还有第二台服务器不需要在那边装整套面板只需要跑一个 Agent 容器services: arcane-agent: image: ghcr.io/getarcaneapp/agent:latest environment: - AGENT_MODEtrue - AGENT_TOKENarc_你的随机令牌 - MANAGER_API_URLhttp://主控端IP:3552 volumes: - /var/run/docker.sock:/var/run/docker.sock主控端通过这个令牌与 Agent 建立连接之后就能在同一个界面里切换管理不同主机。我实际测下来局域网内切换环境基本无感知日志流和终端会话都走的是长连接不会有切换机器就掉线的割裂感。四、把第一个项目真正跑起来从创建到部署的完整链路Arcane 的 Projects 模块不只是记录项目它能把 Compose 文件解析、环境变量注入、镜像拉取、容器编排整合成一条流水线。我的做法是新建项目 → 关联到本地 Docker 环境 → 粘贴或上传 Compose 定义 → 点击部署。整个过程全部在界面内完成部署进度、日志输出、容器状态实时可见出错时能直接看到是哪一步失败。避坑提醒网络与权限两个我踩过的坑提前帮你避开挂载目录权限PROJECTS_DIRECTORY对应的宿主机目录要确保容器用户可写。如果不指定PUID/PGIDArcane 默认以容器内用户运行挂载目录权限不对会导致项目创建失败日志里只报一句含糊的permission denied。防火墙端口主控端 3552、Agent 3553 两个端口需要放行Agent 还要能主动访问主控端的 3552。我第一台机器就是漏了 3553 的入站规则导致 Agent 注册后一直离线。规模化之后的日常当主机和项目多起来Arcane 的价值才真正体现更新页集中展示所有镜像的新版本一键批量更新事件日志把容器启停、镜像拉取、用户操作全部留痕排查谁动过生产环境时不用再翻 shell history。对于需要团队协作的场合它内置的角色与权限体系也能做到只看容器的人碰不了设置。五、进阶路径从能用到玩透如果你被勾起了兴趣这几个方向值得继续深挖边缘 Agent 模式跨公网管理远端主机时可以启用 WebSocket 隧道传输配合 mTLS 双向认证安全性比裸 IP 直连高一个量级任务调度镜像更新检查、卷备份等可以按 cron 表达式自动执行属于配置一次、长期受益的功能源码级定制后端在backend/目录按领域模块垂直切片组织前端在frontend/想改界面文案或加自定义 API结构都足够清晰。官方文档入口就在仓库根目录的 README 里从环境变量总表到开发环境搭建一应俱全想深入底层backend/internal/config/config.go把全部可配置项列得明明白白读一遍基本等于把部署手册背下来了。从命令行硬扛到界面总览、多点管理、自动巡检Arcane 让我重新找回了运维的掌控感。如果你也受够了在终端里一个个容器翻找问题不妨照着上面的步骤花十分钟跑起来——相信我这个 Docker 管理平台值得你为它打开浏览器。【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 告别容器“黑盒“：Arcane Docker 管理平台从零上手实战指南
告别容器黑盒Arcane Docker 管理平台从零上手实战指南【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcane手动敲docker ps、docker logs、再逐个容器exec进去排查的日子想必每位运维都深有体会。当主机上的容器超过十个镜像堆积到几十个靠命令行拼凑出全局视角几乎是一种奢望。这正是我寻找Docker 管理平台的初衷而 Arcane——一个号称为所有人设计的开源项目——最终留在了我的工具箱里。这篇文章不讲官方文档的复述只分享我从部署到跑通第一个项目的完整实战过程以及那些文档里没明说的坑。一、为什么我不选 Portainer而选了 Arcane选型之前我列了三道硬性考题能不能管多台主机、界面能不能看得懂、以及最关键的——部署成本是否低到一键级别。与同类工具的差异点在哪里多数面板要么只盯着单机 Docker要么把 Swarm 集群功能塞得又重又深。Arcane 的切入点不同它把管理器 边缘代理拆成了两个角色——主控端负责 Web 界面与编排Agent 负责在远端主机上执行操作二者通过加密隧道通信。这意味着我可以用一个管理界面统一调度多台机器而不是每台主机各装一套面板。一眼看懂的技术底座后端是 Go前端是 SvelteKit整个界面默认深色主题。仪表盘把环境、容器、镜像、存储用量直接铺在卡片上CPU、内存、磁盘占用一屏尽收上图就是 Arcane 的控制台首页左侧导航把管理、资源、集群、设置分得清清楚楚顶部还能一键在全部与当前环境之间切换。对我这种习惯先看概览再钻细节的人这种布局比一上来就是密密麻麻的容器列表友好得多。二、三步完成 Docker 环境初始化Arcane 的部署方式走的是容器管容器路线用 Docker 跑一个管理 Docker 的容器主程序镜像自带前后端和数据库SQLite连外部依赖都不需要额外装。第一步拉取源码与镜像先把仓库克隆到服务器上仅当需要研究源码或自编译时才必须纯部署可以跳过这一步直接走下面的 Compose 文件git clone https://gitcode.com/gh_mirrors/arcane2/arcane实际部署只需要两个镜像ghcr.io/getarcaneapp/manager主控端和ghcr.io/getarcaneapp/agent远端代理。仓库里docker/examples/目录提供了现成的 Compose 模板省去手搓配置的麻烦。第二步填写两个关键密钥打开docker/examples/compose.basic.yaml最值得注意的不是端口映射默认 3552而是两个环境变量ENCRYPTION_KEY用来加密数据库中的敏感数据必须换成随机 32 位字符串JWT_SECRET登录令牌的签名密钥同样建议随机生成。 实战提醒我第一遍部署时偷懒用了默认值虽然服务能起来但一旦换机器迁移数据密钥不一致会导致加密数据无法解密。建议用openssl rand -hex 16生成两个不同密钥分别填入别图省事。第三步挂载 Docker 套接字并启动compose.basic.yaml的核心是把宿主机的/var/run/docker.sock挂进容器这是 Arcane 操控 Docker 的通道同时把PROJECTS_DIRECTORY指向一个宿主机目录用于存放项目文件。配置里的cgroup: host是点睛之笔——它让容器能更准确地识别自身 ID避免把自己误当成普通业务容器管理。保存后启动并观察健康状态docker compose -f docker/examples/compose.basic.yaml up -d docker compose -f docker/examples/compose.basic.yaml ps镜像内部自带arcane health健康检查命令Compose 里已经写好了探针启动十几秒后状态变为 healthy 就说明一切正常。三、一条命令拉起全部服务组件然后登录后台首次登录默认管理员账户服务起来后浏览器访问http://服务器IP:3552。首次登录用的内置管理员账号是项目值用户名arcane初始密码arcane-admin登录后第一件事就是进设置页修改密码——这一点和所有管理类系统一样默认凭据不改等于把钥匙挂在门口。界面里能做什么登录后的核心区域按资源组织容器、镜像、更新、网络、卷。以容器为例列表支持按名称搜索、按状态过滤点进去就能看日志、进终端、看实时资源占用常见的启停、重建、删除操作都不需要再回到命令行。镜像页还会显示使用中/未使用占比配合一键清理未使用镜像直接帮我找回了 600MB 磁盘空间。多主机加一个 Agent 即可覆盖如果你和我一样还有第二台服务器不需要在那边装整套面板只需要跑一个 Agent 容器services: arcane-agent: image: ghcr.io/getarcaneapp/agent:latest environment: - AGENT_MODEtrue - AGENT_TOKENarc_你的随机令牌 - MANAGER_API_URLhttp://主控端IP:3552 volumes: - /var/run/docker.sock:/var/run/docker.sock主控端通过这个令牌与 Agent 建立连接之后就能在同一个界面里切换管理不同主机。我实际测下来局域网内切换环境基本无感知日志流和终端会话都走的是长连接不会有切换机器就掉线的割裂感。四、把第一个项目真正跑起来从创建到部署的完整链路Arcane 的 Projects 模块不只是记录项目它能把 Compose 文件解析、环境变量注入、镜像拉取、容器编排整合成一条流水线。我的做法是新建项目 → 关联到本地 Docker 环境 → 粘贴或上传 Compose 定义 → 点击部署。整个过程全部在界面内完成部署进度、日志输出、容器状态实时可见出错时能直接看到是哪一步失败。避坑提醒网络与权限两个我踩过的坑提前帮你避开挂载目录权限PROJECTS_DIRECTORY对应的宿主机目录要确保容器用户可写。如果不指定PUID/PGIDArcane 默认以容器内用户运行挂载目录权限不对会导致项目创建失败日志里只报一句含糊的permission denied。防火墙端口主控端 3552、Agent 3553 两个端口需要放行Agent 还要能主动访问主控端的 3552。我第一台机器就是漏了 3553 的入站规则导致 Agent 注册后一直离线。规模化之后的日常当主机和项目多起来Arcane 的价值才真正体现更新页集中展示所有镜像的新版本一键批量更新事件日志把容器启停、镜像拉取、用户操作全部留痕排查谁动过生产环境时不用再翻 shell history。对于需要团队协作的场合它内置的角色与权限体系也能做到只看容器的人碰不了设置。五、进阶路径从能用到玩透如果你被勾起了兴趣这几个方向值得继续深挖边缘 Agent 模式跨公网管理远端主机时可以启用 WebSocket 隧道传输配合 mTLS 双向认证安全性比裸 IP 直连高一个量级任务调度镜像更新检查、卷备份等可以按 cron 表达式自动执行属于配置一次、长期受益的功能源码级定制后端在backend/目录按领域模块垂直切片组织前端在frontend/想改界面文案或加自定义 API结构都足够清晰。官方文档入口就在仓库根目录的 README 里从环境变量总表到开发环境搭建一应俱全想深入底层backend/internal/config/config.go把全部可配置项列得明明白白读一遍基本等于把部署手册背下来了。从命令行硬扛到界面总览、多点管理、自动巡检Arcane 让我重新找回了运维的掌控感。如果你也受够了在终端里一个个容器翻找问题不妨照着上面的步骤花十分钟跑起来——相信我这个 Docker 管理平台值得你为它打开浏览器。【免费下载链接】arcaneModern Docker Management, Designed for Everyone项目地址: https://gitcode.com/gh_mirrors/arcane2/arcane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考