garfieldwtf/port-listener

🐱 Port Listener - 防火墙测试容器

基于轻量级Alpine Linux的容器，用于防火墙和网络策略测试。运行HTTP、HTTPS（带10年自签名证书）、SNMP（UDP）等多种服务，支持全面的网络测试场景。

✨ 核心功能

• 🌐 HTTP服务：TCP 80端口
• 🔐 HTTPS服务：TCP 443端口（含10年自签名证书）
• 📡 SNMP服务：UDP 161端口（用于UDP协议测试）
• 🐧 轻量级：Alpine基础镜像，大小约15MB
• 🏥 内置健康检查：确保服务正常运行
• 🎯 友好Web界面：支持浏览器直接测试
• 🔧 灵活端口映射：适配不同主机端口需求
• Busybox版本：仅监听80/TCP和161/UDP端口

🚀 快速启动

基础使用（默认端口）

bash
# 拉取最新镜像
docker pull garfieldwtf/port-listener:latest

# 运行容器（映射端口到主机）
docker run -d \
  -p 8080:80 \
  -p 8443:443 \
  -p 1610:161/udp \
  --name port-tester \
  garfieldwtf/port-listener:latest

服务测试方法

🔧 端口映射示例

映射到自定义主机端口

bash
# HTTP→9000，HTTPS→9443，SNMP→9999/UDP
docker run -d \
  -p 9000:80 \
  -p 9443:443 \
  -p 9999:161/udp \
  --name firewall-test \
  garfieldwtf/port-listener:latest

多实例测试

bash
# 实例1
docker run -d \
  -p 10080:80 \
  -p 10443:443 \
  -p 10161:161/udp \
  --name tester-1 \
  garfieldwtf/port-listener:latest

# 实例2（不同端口）
docker run -d \
  -p 20080:80 \
  -p 20443:443 \
  -p 20161:161/udp \
  --name tester-2 \
  garfieldwtf/port-listener:latest

映射到标准端口（需Root权限）

bash
# 注意：需sudo/root权限且端口未被占用
sudo docker run -d \
  -p 80:80 \
  -p 443:443 \
  -p 161:161/udp \
  --name port-listener \
  garfieldwtf/port-listener:latest

🐳 Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  port-listener:
    image: garfieldwtf/port-listener:latest
    container_name: port-listener
    ports:
      - "8080:80"    # 主机8080→容器80
      - "8443:443"   # 主机8443→容器443
      - "1610:161/udp" # 主机1610→容器161/UDP
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost/health"]
      interval: 30s
      timeout: 3s
      retries: 3
      start_period: 5s

运行命令：docker-compose up -d

📊 测试命令

HTTP测试

bash
# 基础curl请求
curl http://localhost:8080

# 查看响应头
curl -I http://localhost:8080

# wget下载测试
wget http://localhost:8080 -O test.html

HTTPS测试（忽略证书警告）

bash
# 跳过证书验证
curl -k https://localhost:8443

# 详细SSL信息
curl -k -v https://localhost:8443

# 查看证书有效期
openssl s_client -connect localhost:8443 -servername localhost </dev/null 2>/dev/null | \
  openssl x509 -noout -dates

SNMP测试（UDP）

bash
# 测试SNMP连通性
snmpget -v 2c -c public localhost:1610 sysDescr.0

# 遍历系统信息
snmpwalk -v 2c -c public localhost:1610 system

# 检查SNMP服务状态
snmpstatus -v 2c -c public localhost:1610

🎨 Web界面

容器提供友好的Web界面，支持HTTP/HTTPS访问：

• HTTP：http://你的主机:端口
• HTTPS：https://你的主机:端口（需跳过证书警告）

界面功能：

• 服务状态仪表盘
• 连接测试工具
• 端口信息展示
• 响应式设计（适配移动端/桌面端）
• 深色/浅色主题切换

🛠️ 容器管理

查看状态

bash
# 查看日志
docker logs port-listener

# 实时日志
docker logs -f port-listener

# 健康状态
docker inspect --format='{{.State.Health.Status}}' port-listener

容器内命令执行

bash
# 查看证书信息
docker exec port-listener /cert-info.sh

# 内部测试SNMP
docker exec port-listener snmpwalk -v 2c -c public localhost system

停止与清理

bash
# 停止容器
docker stop port-listener

# 删除容器
docker rm port-listener

# 强制停止并删除
docker rm -f port-listener

🐛 故障排除

常见问题

1. 端口占用：

   bash
   # 查看端口占用进程
   sudo lsof -i :8080
   

2. 浏览器证书警告：正常现象，点击“高级”→“继续访问”即可。
3. SNMP命令未找到：安装SNMP工具（如Ubuntu：sudo apt-get install snmp）。

📄 许可证

本镜像用于测试和教育目的，内部软件遵循各自包的许可证（Alpine Linux、nginx、net-snmp）。

祝您测试顺利！ 🔥🔧
维护者：https://hub.docker.com/r/garfieldwtf/port-listener