Dockhand 开源 Docker 可视化管理面板:群晖 NAS 一键部署实战
还在用命令行 docker ps 一个个查容器状态?Portainer 用久了觉得功能跟不上?今天介绍一款新面孔——Dockhand:开源免费的 Docker 可视化管理平台,家庭实验室永久免费,自带中文界面,群晖 NAS 上一条命令就能跑起来。
Dockhand 是什么?
Dockhand(dockhand.pro)是一个现代化的 Docker 管理平台,定位和 Portainer 类似:给你一个网页管理界面,容器的启停、日志、终端、Compose 编排都能点鼠标完成,不用再记命令。
几个关键特点,先说结论:
- 家庭实验室永久免费:核心功能(容器管理、Compose、Git 部署、漏洞扫描、备份)免费版全有,不按功能阉割;
- 部署极轻:默认 SQLite,不用额外装数据库,树莓派 4 都能跑,群晖 NAS 更不在话下;
- 中文界面:支持简体中文,浏览器语言自动识别;
- 零遥测:不回传任何使用数据,数据只留在你自己的机器上;
- 源码开放:BSL 1.1 协议开源,每个版本四年后自动转为 Apache 2.0。
功能亮点速览
| 功能 | 说明 |
|---|---|
| 容器管理 | 启停、重启、删除、批量操作,CPU/内存实时指标 |
| 可视化 Compose | 可视化编辑 Compose,还有依赖关系图,不用死磕 YAML |
| 网页终端 | 直接进容器执行命令,不用 SSH |
| 实时日志 | 日志流式查看,支持 ANSI 颜色、时间范围和关键字过滤 |
| Git 部署 | 从 Git 仓库部署 Stack,支持 Webhook 自动部署 |
| 定时任务 | 镜像自动更新、定时同步,带安全拉取保护(先扫描再更新) |
| 备份恢复 | 基于 restic 的加密备份,可备份数据卷和 Stack 文件,支持 S3 等 |
| 漏洞扫描 | 集成 Grype/Trivy 扫描镜像 CVE 漏洞 |
| 通知推送 | 支持 Bark、Telegram、ntfy 等,容器崩了第一时间知道 |
| 多环境管理 | 一台 Dockhand 管多台 Docker 主机,还有穿透 NAT 的 Hawser Agent |
| OIDC/SSO | 免费版就带单点登录和双因素认证 |
对 NAS 用户来说,最实用的就是前四项:容器状态一目了然,日志和终端点开即用,Compose 项目可视化管理。
部署:一分钟跑起来
Dockhand 官方给出了一键命令,数据只用一个 volume,配置极简:
docker run -d \
--name dockhand \
--restart unless-stopped \
-p 3000:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v dockhand_data:/app/data \
fnsys/dockhand:latest更推荐用 Compose,方便以后升级维护:
services:
dockhand:
image: fnsys/dockhand:latest
container_name: dockhand
restart: unless-stopped
ports:
- 3000:3000
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- dockhand_data:/app/data
volumes:
dockhand_data:安全提醒:挂载 docker.sock 意味着 Dockhand 拥有操作宿主机 Docker 的最高权限,这是所有 Docker 管理面板的通用做法。务必给 Dockhand 设置强密码,不要把 3000 端口直接暴露到公网,需要远程访问请走反代 + HTTPS。群晖 NAS(Container Manager)部署步骤
- 打开 Container Manager → 项目 → 新增,项目名称填
dockhand,路径选一个顺手的共享文件夹; - 在
docker-compose.yml编辑框粘贴上面的 Compose 内容; - 点下一步完成,等待镜像拉取完成、容器状态变为运行中;
- 浏览器打开
http://群晖IP:3000,看到登录页即部署成功。

初始化:创建管理员并连接本地环境
首次打开会让你创建一个管理员账号,设置好用户名和强密码。登录后 Dockhand 会自动识别本机的 Docker 环境(通过挂载的 docker.sock),仪表盘上立刻能看到这台机器的容器数量、镜像数、CPU 内存状态。
如果你有多台机器(比如一台群晖 + 一台小主机),可以在“环境”里添加远程主机:支持 TCP + TLS 连接;内网穿透场景可以用官方的 Hawser Agent,Agent 主动向外连,不用开防火墙端口——思路和 FRP 内网穿透很像,适合没有公网 IP 的机器。
核心用法:日常用这几个就够了
容器管理:容器列表里能看到每个容器的实时 CPU/内存占用,批量选中可以一键重启、停止、删除;点进容器详情能看完整配置、挂载、环境变量,改 CPU/内存限制不需要重建容器。
网页终端:选中容器点 Shell,直接进容器执行命令,排查问题不用再 SSH 到 NAS 上敲 docker exec。下面是官方的终端界面实拍:

日志查看:日志页面支持实时流式输出,带颜色高亮,可以按时间范围和关键字过滤。容器起不来的时候,先来这里看第一条报错——排查思路和之前写的 Docker 升级排障指南是一样的:先看日志,再动手。
Stacks(Compose 项目):可以可视化创建和编辑 Compose 项目,还有只读的依赖关系图;已经用 Compose 跑起来的项目,Dockhand 能自动识别接管,不用重建。
Git 部署:把 Compose 文件放 Git 仓库,Dockhand 定时同步,配合 Webhook 实现改完代码自动部署,适合跑博客、图床这类自建服务。
通知推送:在设置里配好 Bark(iOS)或 Telegram,容器异常退出、备份完成都能收到推送。之前本站介绍过自建 Bark 服务器推送评论,Dockhand 的通知走 Apprise 协议,Bark 同样支持。
远程访问:建议走反代
不要把 3000 端口直接映射到公网。正确做法是在内网跑 Dockhand,外网访问走反向代理:
- 有公网 IP:用 Lucky 或 Nginx Proxy Manager 反代
http://群晖IP:3000,配好 HTTPS 证书; - 没公网 IP:内网穿透(FRP/Lucky)把 3000 端口穿透出去,同样建议套一层 HTTPS。
反代配置可以参考本站之前的 Lucky 反代教程和 FRP 内网穿透教程。
和 Portainer 简单对比
| 对比项 | Dockhand | Portainer CE |
|---|---|---|
| 费用 | 家庭实验室永久免费 | 社区版免费 |
| 数据库 | 默认 SQLite,极轻 | 需要外部数据库(较重) |
| 中文界面 | 原生支持简体中文 | 社区汉化 |
| 备份 | 内置 restic 加密备份 | 需手动/商业版 |
| 漏洞扫描 | 内置 Grype/Trivy | 商业版功能 |
| 通知推送 | 内置 Bark/Telegram 等 | 需 Webhook 自行对接 |
| 上手难度 | 界面更现代,学习成本低 | 生态成熟,教程多 |
如果你是 Portainer 老用户,Dockhand 值得一试;如果你还没用过任何面板,直接上 Dockhand 更省事。两者可以共存,不冲突。
注意事项
- 数据持久化:
dockhand_data这个 volume 一定要保留,删了配置和用户数据就没了;重要环境建议再用 Dockhand 自带的备份功能定期备份; - 升级:
fnsys/dockhand:latest拉新镜像重建即可,升级前按老规矩备份数据、记录版本; - 资源占用:官方称树莓派 4 可跑,群晖上实测内存占用很小,适合长期挂着;
- 安全:强密码 + 不直接暴露端口 + 定期更新,三件套做好。
总结
Dockhand 给我的整体感觉是“Portainer 的现代化重制版”:部署一条命令、界面清爽、中文原生、备份扫描通知全家桶免费。对群晖 NAS 用户来说,它是管理一堆 Docker 容器的好帮手——容器状态、日志、终端、Compose 项目,一个网页全搞定。
花十分钟部署上,你的 NAS 容器管理就从命令行时代进入面板时代了。
相关阅读:


评论 (0)