Docker容器管理面板Dockhand

简介

什么是 Dockhand ？

Dockhand 是一款现代化、高效的 Docker 管理应用程序，提供实时容器管理、Compose 堆栈编排和多环境支持。所有功能都集成在一个轻量级、安全且注重隐私的软件包中。它可以帮助用户通过 Web 界面直观地管理和监控 Docker 容器，简化了容器作、堆栈部署和可观察性。

主要特点

容器管理：实时启动、停止、重启和监控容器
Compose Stacks ：Docker Compose 部署的可视化编辑器
Git 集成 ：通过 Webhook 和自动同步从 Git 仓库部署堆栈
多环境管理 ：管理本地和远程 Docker 主机
终端和日志 ：交互式 shell 访问和实时日志流
文件浏览器：浏览、上传和下载容器中的文件
身份验证 ：通过 OIDC 实现 SSO、本地用户以及可选的 RBAC（企业级）
开源免费 ：基于 BSL 1.1 协议开源（个人免费使用，2029年转为 Apache 2.0）

应用场景

个人服务器管理 ：个人用户可以通过 Web 界面轻松管理 VPS 或家庭服务器上的 Docker 容器
开发者工具：开发人员可以快速查看容器状态、查看日志、管理堆栈，无需记忆命令行
家庭媒体服务器：管理媒体服务、下载工具等家庭常用容器的理想选择
小团队协作 ：支持多用户和 RBAC，适合小团队内部使用

Dockhand 是一个轻量级、安全且注重隐私的 Docker 管理工具，界面现代化，功能全面。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 dockhand，选择第一个 fnsys/dockhand，版本选择 latest。

本文写作时，latest 版本对应为 v1.0.25；

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

bash 复制代码

# 新建文件夹 dockhand 和 子目录
mkdir -p /volume1/docker/dockhand/data

# 进入 dockhand 目录
cd /volume1/docker/dockhand

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name dockhand \
   -p 3424:3000 \
   -v /var/run/docker.sock:/var/run/docker.sock \
   -v $(pwd)/data:/app/data \
   fnsys/dockhand:latest

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

yaml 复制代码

version: '3.8'

services:
  dockhand:
    image: fnsys/dockhand:latest
    container_name: dockhand
    restart: unless-stopped
    ports:
      - "3424:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # Docker 守护进程
      - ./data:/app/data  # 存放数据库和配置

执行以下命令启动：

bash 复制代码

# 新建文件夹 dockhand 和 子目录
mkdir -p /volume1/docker/dockhand/data

# 进入 dockhand 目录
cd /volume1/docker/dockhand

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:3424 即可进入 Web 界面

在左侧边栏，点击 Settings 。选择 Environments 标签，然后点击 Add environment

Name：主机的名称
Connection type：使用默认的 Unix socket
Socket path：使用默认的 /var/run/docker.sock
Public IP：就是主机的 IP，老苏的群晖主机 IP 是 192.168.0.197

如果测试没问题，就可以点 Add 添加了

如果不想使用默认的 UTC 时区，可以在 Settings 中切换

现在点开左侧边栏 Dashboard能看到资源情况

而进入 Containers 就能看到已经安装的容器

查个日志什么的，非常方便

进入 Stacks 可以粘贴 Compose file，如果用过 portainer，应该不会陌生

注意事项

Docker Socket 权限 ：需要确保运行 Dockhand 的用户有权限访问 /var/run/docker.sock，否则无法管理容器
数据持久化 ：数据存储在 /app/data 目录，升级前建议先备份数据卷
安全建议：首次使用后建议修改默认密码，并妥善保管管理员账号
端口冲突 ：如果 3424 端口被占用，请更换为其他可用端口
许可证说明 ：Dockhand 采用 BSL 1.1 协议，个人和内部使用免费，但不可作为商业 SaaS 服务提供

参考文档

Finsys/dockhand: Dockhand - Docker management you will like.

地址：https://github.com/Finsys/dockhand
Dockhand - Modern Docker Management

地址：https://dockhand.pro/
fnsys/dockhand - Docker Image

地址：https://hub.docker.com/r/fnsys/dockhand