Docker部署Wireshark遇bind() to 0.0.0.0:3000端口占用问题求助

问题描述 #

刚接触Docker与网络技术，已通过Docker Compose成功部署AdGuard、Jellyfin及Homer仪表盘。添加Wireshark时出现报错：

nginx: [emerg] bind() to 0.0.0.0:3000 failed (98: Address in use)

环境为旧款MacBook Pro + Docker Desktop，所有服务通过VSCode的Docker Compose文件启动（执行docker compose up -d）。AdGuard原配置3000:3000/tcp，已修改为80端口并正常运行；Homer用8080:8080，Jellyfin用默认8096:8096。尝试为Wireshark配置3030:3030和3031:3031端口，但日志仍显示3000端口被占用，经查该端口被Docker Desktop本身占用。

Wireshark的Docker Compose配置如下：

---
version: "2.1"
services:
  wireshark:
    image: lscr.io/linuxserver/wireshark:latest
    container_name: wireshark
    cap_add:
      - NET_ADMIN
    security_opt:
      - seccomp:unconfined #optional
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Berlin
    volumes:
      - mypath:/config
    ports:
      - 3030:3030 #optional
      - 3031:3031 #optional
    restart: unless-stopped

错误原因 #

核心问题是network_mode: host配置：当容器使用宿主机网络模式时，ports映射规则会被完全忽略，容器内的Wireshark服务会直接使用默认的3000端口监听宿主机网络，而这个端口正好被Docker Desktop占用，导致绑定失败。

解决步骤 #

提供两种可行方案，根据你的抓包需求选择：

方案一：修改容器内Wireshark服务的监听端口（保留host网络模式） #

linuxserver/wireshark镜像支持通过环境变量调整服务端口，在environment中添加端口指定即可：

environment:
  - PUID=1000
  - PGID=1000
  - TZ=Europe/Berlin
  - PORT=3030 # 添加这一行，指定容器内服务监听3030端口

修改后重新启动容器：docker compose up -d，此时容器会直接使用宿主机的3030端口，避开被占用的3000端口，同时保留host网络模式的全网络抓包能力。

方案二：关闭host网络模式（使用Docker桥接网络） #

如果不需要抓宿主机全网络流量，可以删除network_mode: host配置，此时ports映射会生效：

# 删除此行：network_mode: host

修改后容器内部服务仍监听默认3000端口，但会映射到宿主机的3030端口，不会与Docker Desktop的3000端口冲突。注意：这种模式下容器只能抓自身网络命名空间内的流量，若需要抓宿主机或其他容器的流量，可能需要额外配置网络（比如将容器加入目标容器的网络命名空间）。

额外提示 #

• 若选择方案一，确保宿主机的3030端口未被其他服务占用；
• 可以用lsof -i :3030（MacOS）命令检查端口占用情况。

内容的提问来源于stack exchange，提问作者bennyyy999