Dockhand 开源 Docker 可视化管理面板:群晖 NAS 一键部署实战

Dockhand 开源 Docker 可视化管理面板:群晖 NAS 一键部署实战

夜影
2026-10-17 / 0 评论 / 3 阅读 / 正在检测是否收录...

Dockhand 开源 Docker 可视化管理面板:群晖 NAS 一键部署实战

还在用命令行 docker ps 一个个查容器状态?Portainer 用久了觉得功能跟不上?今天介绍一款新面孔——Dockhand:开源免费的 Docker 可视化管理平台,家庭实验室永久免费,自带中文界面,群晖 NAS 上一条命令就能跑起来。

Dockhand 封面

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)部署步骤

  1. 打开 Container Manager → 项目 → 新增,项目名称填 dockhand,路径选一个顺手的共享文件夹;
  2. 在 docker-compose.yml 编辑框粘贴上面的 Compose 内容;
  3. 点下一步完成,等待镜像拉取完成、容器状态变为运行中;
  4. 浏览器打开 http://群晖IP:3000,看到登录页即部署成功。

Dockhand 仪表盘

初始化:创建管理员并连接本地环境

首次打开会让你创建一个管理员账号,设置好用户名和强密码。登录后 Dockhand 会自动识别本机的 Docker 环境(通过挂载的 docker.sock),仪表盘上立刻能看到这台机器的容器数量、镜像数、CPU 内存状态。

如果你有多台机器(比如一台群晖 + 一台小主机),可以在“环境”里添加远程主机:支持 TCP + TLS 连接;内网穿透场景可以用官方的 Hawser Agent,Agent 主动向外连,不用开防火墙端口——思路和 FRP 内网穿透很像,适合没有公网 IP 的机器。

核心用法:日常用这几个就够了

容器管理:容器列表里能看到每个容器的实时 CPU/内存占用,批量选中可以一键重启、停止、删除;点进容器详情能看完整配置、挂载、环境变量,改 CPU/内存限制不需要重建容器。

网页终端:选中容器点 Shell,直接进容器执行命令,排查问题不用再 SSH 到 NAS 上敲 docker exec。下面是官方的终端界面实拍:

Dockhand 网页终端

日志查看:日志页面支持实时流式输出,带颜色高亮,可以按时间范围和关键字过滤。容器起不来的时候,先来这里看第一条报错——排查思路和之前写的 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 简单对比

对比项DockhandPortainer 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

评论 (0)

取消