使用 Docker 容器测试端口开放性

在实际生产环境中，需要客户给服务器开放部分端口，提供外网使用

但实际调试过程中，经常因为客户未正确开通，增加调试的复杂度

本文在 Docker 环境的基础上，使用 netshoot 镜像，结合脚本，实打实的观察到端口是否开放

一、为什么使用 Docker?

在项目现场，客户给与的环境基本都是纯内网。操作系统缺少很多工具，如果是 Docker 环境，那么就很灵活了，自己想用什么工具，自行封装到镜像内即可。

二、测试对象

测试分为服务端、客户端。当我们需要测试一台目标服务器的端口是否开放，我们在自己电脑（或服务器）上测试。那么，目标服务器就是服务端，我们的电脑（或服务器）就是客户端。

三、测试流程

使用 netshoot 镜像，在服务端（目标服务器）启动一个 netshoot 的容器，该容器映射需要测试的端口及标注端口类型（TCP/UDP），该容器内使用 socat 开启端口的监听。在客户端（测试的电脑/服务器）启动一个 netshoot 的容器，该容器内使用 socat 向服务端发送消息。如果端口正确开放，则服务端能够打印消息

四、脚本说明

服务端脚本使用说明：

bash 复制代码

# 用法: ./server.sh [-u|-t] <端口号>
# 示例:
# TCP监听: ./server.sh -t 8080
# UDP监听: ./server.sh -u 8081
# 默认TCP: ./server.sh 8080

客户端脚本使用说明：

bash 复制代码

# 用法: ./client.sh [-u|-t] <服务器IP> <端口号> [间隔秒数]
# 示例:
# TCP客户端: ./client.sh -t 192.168.80.10 8080 1
# UDP客户端: ./client.sh -u 192.168.80.10 8081 2
# 默认TCP:   ./client.sh 192.168.80.10 8080

五、测试流程

拉取 netshoot:v0.13 镜像

bash 复制代码

docker pull netshoot:v0.13

导出镜像

bash 复制代码

docker save netshoot:v0.13 > netshoot_v0.13.tar

在服务端（被测试端口是否开放的服务器，下同）新建 /opt/netshoot 目录，将镜像上传到 /opt/netshoot，导入镜像

bash 复制代码

sudo mkdir -p /opt/netshoot
sudo chown -R $USER:$USER /opt/netshoot
cd /opt/netshoot
docker load < netshoot_v0.13.tar

在服务端新建 server.sh 脚本

sudo vi /opt/netshoot/server.sh

bash 复制代码

#!/bin/bash
# 用法: ./server.sh [-u|-t] <端口号>
# 示例:
# TCP监听: ./server.sh -t 8080
# UDP监听: ./server.sh -u 8081
# 默认TCP: ./server.sh 8080

# 默认协议为 TCP
PROTO="tcp"
PORT=""

# 解析选项
while getopts "ut" opt; do
  case $opt in
    u) PROTO="udp";;
    t) PROTO="tcp";;
    *) echo "用法: $0 [-u|-t] <端口号>"
       exit 1;;
  esac
done
shift $((OPTIND -1))

# 检查必需参数（端口号）
if [ $# -ne 1 ]; then
  echo "用法: $0 [-u|-t] <端口号>"
  exit 1
fi

PORT=$1

# 验证端口是否为数字
if ! [[ "$PORT" =~ ^[0-9]+$ ]]; then
  echo "错误：端口号必须为数字！"
  exit 1
fi

case "${PROTO}" in
  tcp)
    docker run -it --rm --init \
      -v /etc/localtime:/etc/localtime:ro \
      -v /etc/timezone:/etc/timezone:ro \
      -p ${PORT}:${PORT} nicolaka/netshoot:v0.13 \
      socat TCP-LISTEN:${PORT},reuseaddr,fork -
    ;;
  udp)
    docker run -it --rm --init \
      -v /etc/localtime:/etc/localtime:ro \
      -v /etc/timezone:/etc/timezone:ro \
      -p ${PORT}:${PORT}/udp nicolaka/netshoot:v0.13 \
      socat UDP-RECV:${PORT},reuseaddr -
    ;;
  *)
    echo "无效协议，请使用 udp/tcp"
    exit 1
    ;;
esac

赋予 server.sh 脚本执行权限

sudo chmod +x /opt/netshoot/server.sh

参考 步骤 3，在客户端（访问服务端端口的电脑，需要 Linux 系统）导入 netshoot 镜像
在客户端新建 client.sh 脚本

sudo vi /opt/netshoot/client.sh

bash 复制代码

#!/bin/bash
# 用法: ./client.sh [-u|-t] <服务器IP> <端口号> [间隔秒数]
# 示例:
# TCP客户端: ./client.sh -t 192.168.80.10 8080 1
# UDP客户端: ./client.sh -u 192.168.80.10 8081 2
# 默认TCP:   ./client.sh 192.168.80.10 8080

# 默认协议为TCP
PROTO="tcp"
# 解析选项
while getopts "ut" opt; do
  case $opt in
    u) PROTO="udp";;
    t) PROTO="tcp";;
    *) echo "用法: $0 [-u|-t] <服务器IP> <端口号> [间隔秒数]"
       exit 1;;
  esac
done
shift $((OPTIND -1))

# 检查必需参数
if [ $# -lt 2 ]; then
  echo "用法: $0 [-u|-t] <服务器IP> <端口号> [间隔秒数]"
  exit 1
fi

SERVER_IP=$1
PORT=$2
INTERVAL=${3:-1}

cleanup() {
  echo "正在清理容器..."
  docker stop "$CONTAINER_NAME" >/dev/null 2>&1
}
trap cleanup EXIT

CONTAINER_NAME="client_$(date +%s)"

case "${PROTO}" in
  tcp)
    docker run -i --rm --init \
      -v /etc/localtime:/etc/localtime:ro \
      -v /etc/timezone:/etc/timezone:ro \
      --name "$CONTAINER_NAME" nicolaka/netshoot:v0.13 \
      sh -c "trap 'exit 0' SIGINT; \
        count=1; \
        while true; do \
          echo -e \"[\$(date '+%Y-%m-%d %H:%M:%S')] 第\${count}次发送 TCP 消息\"; \
          count=\$((count+1)); \
          sleep ${INTERVAL}; \
        done | socat - TCP-CONNECT:${SERVER_IP}:${PORT}" &
    ;;
  udp)
    docker run -i --rm --init \
      -v /etc/localtime:/etc/localtime:ro \
      -v /etc/timezone:/etc/timezone:ro \
      --name "$CONTAINER_NAME" nicolaka/netshoot:v0.13 \
      sh -c "trap 'exit 0' SIGINT; \
        count=1; \
        while true; do \
          echo -e \"[\$(date '+%Y-%m-%d %H:%M:%S')] 第\${count}次发送 UDP 消息\"; \
          count=\$((count+1)); \
          sleep ${INTERVAL}; \
        done | socat - UDP-SENDTO:${SERVER_IP}:${PORT}" &
    ;;
esac

# 等待容器运行
sleep 1
# 前台运行等待中断
wait

赋予 client.sh 脚本执行权限

sudo chmod +x /opt/netshoot/client.sh

先启动服务端脚本，服务端会卡住等待客户端发送消息

bash 复制代码

./server.sh 8080

再启动客户端脚本，客户端后台循环往服务端发送消息

bash 复制代码

./client.sh 192.168.80.10 8080

客户端启动后，服务端打印客户端发送过来的消息

由此证明，端口一定是开放了。如果测试 UDP，只需要在服务端、客户端的启动脚本的命令上添加 -u 参数。例如：./server.sh -u 8081 ./client.sh -u 192.168.80.10 8081