快捷導(dǎo)航

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

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

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

簡介

什么是 Dockhand ？

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

主要特點

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

應(yīng)用場景

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

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

安裝

在群暉上以 Docker 方式安裝。

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

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

docker cli 安裝

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

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

# 進(jìn)入 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 安裝，將下面的內(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í)行以下命令啟動：

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

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

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

# 一鍵啟動
docker-compose up -d

運行

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

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

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

如果測試沒問題，就可以點 Add 添加了

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

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

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

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

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

注意事項

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