hollowpnt/docker-port-viewer

Docker容器查看工具 (TypeScript)

镜像概述

本镜像是一个基于TypeScript构建的轻量级应用程序，旨在提供简洁直观的界面，帮助用户快速查看当前运行中的Docker容器信息。通过该应用，用户可无需执行复杂的docker ps命令，直接通过Web界面或命令行获取容器状态、ID、名称、端口映射等关键信息。

核心功能与特性

• 实时容器监控：动态展示当前所有运行状态的Docker容器列表
• 容器信息展示：包含容器ID、名称、状态、启动时间、端口映射、镜像名称等基础信息
• 轻量级设计：基于Node.js和TypeScript构建，镜像体积小，资源占用低
• 易于部署：支持Docker单容器部署及docker-compose编排，配置简单
• 跨平台兼容：可在任何支持Docker的Linux、Windows或macOS环境运行

使用场景

• 开发环境中快速查看容器运行状态
• 个人服务器或小型部署环境的容器管理辅助工具
• 教学或演示场景中展示容器运行情况
• 需要简化容器状态监控流程的日常运维工作

使用方法

前置要求

• 已安装Docker Engine (20.10.0+)
• 容器需具有访问Docker守护进程的权限（通过挂载Docker socket实现）

Docker Run 部署

通过以下命令快速启动应用：

bash
docker run -d \
  --name container-viewer \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart unless-stopped \
  [镜像名称]:[标签]

参数说明：

• -p 8080:8080：端口映射（主机端口:容器端口），默认使用8080端口
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，使应用能获取容器信息
• --name container-viewer：指定容器名称，便于管理

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  container-viewer:
    image: [镜像名称]:[标签]
    container_name: container-viewer
    ports:
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped
    # 可选：指定自定义端口
    environment:
      - PORT=3000

启动服务：

bash
docker-compose up -d

配置参数

环境变量

自定义配置示例

修改默认端口和刷新间隔：

bash
docker run -d \
  --name container-viewer \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e PORT=3000 \
  -e REFRESH_INTERVAL=10 \
  [镜像名称]:[标签]

访问应用

部署完成后，通过以下方式访问应用：

• Web界面：在浏览器中访问 http://<主机IP>:<端口>（如 http://localhost:8080）
• 命令行界面（如支持）：通过 docker exec -it container-viewer npm run cli 查看文本输出

注意事项

• 确保挂载的Docker套接字路径正确，不同操作系统可能存在差异（如Windows WSL2中路径可能为 /mnt/wsl/docker-desktop-data/docker.sock）
• 生产环境中建议限制容器对Docker套接字的权限，避免安全风险
• 应用仅展示运行状态的容器，已停止的容器不会显示

故障排查

• 无法看到容器信息：检查Docker套接字是否正确挂载，容器是否具有读取权限
• 应用无法启动：检查端口是否被占用，尝试修改PORT环境变量
• 界面无响应：检查Docker服务是否正常运行，重启应用容器