快捷導(dǎo)航

Docker容器管理面板Dockhand的使用小結(jié)

更新時(shí)間：2026年06月11日 09:40:56 作者：楊浦老蘇

Dockhand是一個(gè)現(xiàn)代化的Docker管理面板,支持容器管理、Compose堆棧編排、Git集成和多環(huán)境管理,下面就來詳細(xì)的介紹一下,感興趣的可以了解一下

簡介

什么是 Dockhand ？

Dockhand 是一款現(xiàn)代化、高效的 Docker 管理應(yīng)用程序，提供實(shí)時(shí)容器管理、Compose 堆棧編排和多環(huán)境支持。所有功能都集成在一個(gè)輕量級(jí)、安全且注重隱私的軟件包中。它可以幫助用戶通過 Web 界面直觀地管理和監(jiān)控 Docker 容器，簡化了容器作、堆棧部署和可觀察性。

主要特點(diǎn)

容器管理：實(shí)時(shí)啟動(dòng)、停止、重啟和監(jiān)控容器
Compose Stacks：Docker Compose 部署的可視化編輯器
Git 集成：通過 Webhook 和自動(dòng)同步從 Git 倉庫部署堆棧
多環(huán)境管理：管理本地和遠(yuǎn)程 Docker 主機(jī)
終端和日志：交互式 shell 訪問和實(shí)時(shí)日志流
文件瀏覽器：瀏覽、上傳和下載容器中的文件
身份驗(yàn)證：通過 OIDC 實(shí)現(xiàn) SSO、本地用戶以及可選的 RBAC（企業(yè)級(jí)）
開源免費(fèi)：基于 BSL 1.1 協(xié)議開源（個(gè)人免費(fèi)使用，2029年轉(zhuǎn)為 Apache 2.0）

應(yīng)用場景

個(gè)人服務(wù)器管理：個(gè)人用戶可以通過 Web 界面輕松管理 VPS 或家庭服務(wù)器上的 Docker 容器
開發(fā)者工具：開發(fā)人員可以快速查看容器狀態(tài)、查看日志、管理堆棧，無需記憶命令行
家庭媒體服務(wù)器：管理媒體服務(wù)、下載工具等家庭常用容器的理想選擇
小團(tuán)隊(duì)協(xié)作：支持多用戶和 RBAC，適合小團(tuán)隊(duì)內(nèi)部使用

Dockhand 是一個(gè)輕量級(jí)、安全且注重隱私的 Docker 管理工具，界面現(xiàn)代化，功能全面。

安裝

在群暉上以 Docker 方式安裝。

在注冊(cè)表中搜索 dockhand，選擇第一個(gè) fnsys/dockhand，版本選擇 latest。

本文寫作時(shí)，latest 版本對(duì)應(yīng)為 v1.0.25；

docker cli 安裝

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

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

# 進(jìn)入 dockhand 目錄
cd /volume1/docker/dockhand

# 運(yùn)行容器
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 安裝，將下面的內(nèi)容保存為 docker-compose.yml 文件

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 守護(hù)進(jìn)程
      - ./data:/app/data  # 存放數(shù)據(jù)庫和配置

執(zhí)行以下命令啟動(dòng)：

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

# 進(jìn)入 dockhand 目錄
cd /volume1/docker/dockhand

# 將 docker-compose.yml 放入當(dāng)前目錄

# 一鍵啟動(dòng)
docker-compose up -d

運(yùn)行

在瀏覽器中訪問 http://<群暉IP>:3424 即可進(jìn)入 Web 界面

在左側(cè)邊欄，點(diǎn)擊 Settings 。選擇 Environments 標(biāo)簽，然后點(diǎn)擊 Add environment

Name：主機(jī)的名稱
Connection type：使用默認(rèn)的 Unix socket
Socket path：使用默認(rèn)的 /var/run/docker.sock
Public IP：就是主機(jī)的 IP，老蘇的群暉主機(jī) IP 是 192.168.0.197

如果測(cè)試沒問題，就可以點(diǎn) Add 添加了

如果不想使用默認(rèn)的 UTC 時(shí)區(qū)，可以在 Settings 中切換

現(xiàn)在點(diǎn)開左側(cè)邊欄 Dashboard能看到資源情況

而進(jìn)入 Containers 就能看到已經(jīng)安裝的容器

查個(gè)日志什么的，非常方便

進(jìn)入 Stacks 可以粘貼 Compose file，如果用過 portainer，應(yīng)該不會(huì)陌生

注意事項(xiàng)

Docker Socket 權(quán)限：需要確保運(yùn)行 Dockhand 的用戶有權(quán)限訪問 /var/run/docker.sock，否則無法管理容器
數(shù)據(jù)持久化：數(shù)據(jù)存儲(chǔ)在 /app/data 目錄，升級(jí)前建議先備份數(shù)據(jù)卷
安全建議：首次使用后建議修改默認(rèn)密碼，并妥善保管管理員賬號(hào)
端口沖突：如果 3424 端口被占用，請(qǐng)更換為其他可用端口
許可證說明：Dockhand 采用 BSL 1.1 協(xié)議，個(gè)人和內(nèi)部使用免費(fèi)，但不可作為商業(yè) SaaS 服務(wù)提供