Docker容器管理面板Dockhand

发表于 分类于 Waline： 阅读次数： 本文字数： 2.2k 阅读时长 ≈ 2 分钟
Dockhand 是一个现代化的 Docker 管理面板，支持容器管理、Compose 堆栈编排、Git 集成和多环境管理。

简介

什么是 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 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文件夹 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 文件

1
2
3
4
5
6
7
8
9
10
11
12
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  # 存放数据库和配置

执行以下命令启动：

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 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，应该不会陌生

注意事项

  1. Docker Socket 权限：需要确保运行 Dockhand 的用户有权限访问 /var/run/docker.sock，否则无法管理容器
  2. 数据持久化：数据存储在 /app/data 目录，升级前建议先备份数据卷
  3. 安全建议：首次使用后建议修改默认密码，并妥善保管管理员账号
  4. 端口冲突：如果 3424 端口被占用，请更换为其他可用端口
  5. 许可证说明：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