NAS 与运维

Dockpeek:查看容器端口与访问入口

  • 0 次阅读
  • 0 条评论
文章摘要

Dockpeek 把容器端口、链接和主机信息集中展示,适合服务较多时快速查找入口。它连接 Docker API,部署后应配置独立密码并限制访问。 面板从 Docker API 读取容器和映射端口,卡片链接帮助打开服务。未映射的内部端口不能直接从用户浏览器访问。 适合容器较多时整理入口。连接权限与面板密码需要独立保护。

项目介绍

Dockpeek 把容器端口、链接和主机信息集中展示,适合服务较多时快速查找入口。它连接 Docker API,部署后应配置独立密码并限制访问。

面板从 Docker API 读取容器和映射端口,卡片链接帮助打开服务。未映射的内部端口不能直接从用户浏览器访问。

适合容器较多时整理入口。连接权限与面板密码需要独立保护。

核心功能

功能 作用与使用方式
端口展示 区分宿主与容器端口
快捷链接 直达可访问服务
主机信息 辨认运行环境
标签定制 修正代理后的地址
多主机 按受控方案连接

界面展示

Dockpeek 官方项目配图

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

Dockpeek 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 dockpeek/dockpeek
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 在项目 .env 中设置 DOCKPEEK_SECRET_KEY 和 DOCKPEEK_PASSWORD 为两份独立强随机值,再按下面配置启动。
  2. 打开 http://NAS_IP:3420,使用设定账号登录,核对容器列表与实际端口映射。内部端口未映射时不能直接从浏览器访问。
  3. 为有反向代理的应用设置项目支持的链接标签,避免卡片指向错误的内部地址。多主机接入按官方方案配置受控 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 许可 保留来源与许可;图片只做等比例缩小和压缩。