项目介绍
Dockpeek 把容器端口、链接和主机信息集中展示,适合服务较多时快速查找入口。它连接 Docker API,部署后应配置独立密码并限制访问。
面板从 Docker API 读取容器和映射端口,卡片链接帮助打开服务。未映射的内部端口不能直接从用户浏览器访问。
适合容器较多时整理入口。连接权限与面板密码需要独立保护。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 端口展示 | 区分宿主与容器端口 |
| 快捷链接 | 直达可访问服务 |
| 主机信息 | 辨认运行环境 |
| 标签定制 | 修正代理后的地址 |
| 多主机 | 按受控方案连接 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | dockpeek/dockpeek |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 在项目
.env中设置DOCKPEEK_SECRET_KEY和DOCKPEEK_PASSWORD为两份独立强随机值,再按下面配置启动。 - 打开
http://NAS_IP:3420,使用设定账号登录,核对容器列表与实际端口映射。内部端口未映射时不能直接从浏览器访问。 - 为有反向代理的应用设置项目支持的链接标签,避免卡片指向错误的内部地址。多主机接入按官方方案配置受控 Socket Proxy,不裸露 Docker TCP API。
首次使用与操作检查
对照 Container Manager 核对几个端口,给反代服务配置正确链接再测试。
远端引擎不裸露 TCP API。只读面板也接触引擎数据,配置与独立密钥一起保护。
Docker Compose
依据官方单主机 Compose 整理,初始密码和密钥由下方准备命令自动生成到 .env。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/dockpeek/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/dockpeek
cd /volume1/docker/dockpeek
umask 077
touch .env
if ! grep -q "^DOCKPEEK_PASSWORD=." .env; then
generated_secret=$(openssl rand -hex 32)
printf 'DOCKPEEK_PASSWORD=%s\n' "$generated_secret" >> .env
fi
if ! grep -q "^DOCKPEEK_SECRET_KEY=." .env; then
generated_secret=$(openssl rand -hex 32)
printf 'DOCKPEEK_SECRET_KEY=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/dockpeek
所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/dockpeek/.env;该文件只保留在本机。
services:
dockpeek:
image: dockpeek/dockpeek:latest
restart: unless-stopped
ports:
- "3420:8000"
environment:
SECRET_KEY: "${DOCKPEEK_SECRET_KEY}"
USERNAME: admin
PASSWORD: "${DOCKPEEK_PASSWORD}"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- Docker Socket 对宿主机具有很高控制能力,管理页面只允许可信使用者访问。
- 端口发现只能辅助整理,不替代应用健康检查或权限审计。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
保留 Compose、环境密钥和自定义标签;更新功能执行前另备份目标应用数据。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 dockpeek/dockpeek 官方仓库,按 MIT 许可 保留来源与许可;图片只做等比例缩小和压缩。