ffeldhaus/wireshark

Wireshark Web容器镜像

Docker镜像，通过XPRA技术使Wireshark可通过网页浏览器访问。

镜像概述

该镜像旨在提供一种便捷方式，使Wireshark网络分析工具能够通过HTML5网页浏览器访问，无需在本地安装Wireshark。通过XPRA（X11 Persistent Remote Applications）技术实现图形界面的远程传输，方便用户在任何设备上通过浏览器进行网络流量分析。

核心功能与特性

• 浏览器访问：通过HTML5网页浏览器直接访问Wireshark图形界面
• 网络流量捕获：支持从网络接口捕获实时流量（需适当权限配置）
• 文件上传分析：支持将本地网络trace文件拖放至Wireshark窗口进行分析
• SSL加密：默认使用自签名SSL证书保障传输安全，支持自定义证书
• 密码保护：默认密码保护访问，支持通过环境变量自定义密码
• 灵活部署：支持多种运行模式，可根据需求配置网络模式和权限

使用场景

• 远程网络分析：在没有本地安装Wireshark的设备上进行网络分析
• 服务器端流量监控：在服务器环境中捕获和分析网络流量
• 团队协作：通过共享会话功能实现多人协作分析网络问题
• 教学演示：在教学环境中展示Wireshark的使用和网络分析过程

使用方法与配置说明

基本参数说明

• 默认端口：***（可通过端口映射修改）
• 默认密码：wireshark（可通过XPRA_PASSWORD环境变量修改）
• 默认SSL证书：自签名证书（可通过挂载自定义证书替换）
• 权限要求：
  • 基础流量捕获：需添加--cap-add NET_ADMIN参数
  • 高级权限需求：如无法捕获接口或出现权限错误，可使用--privileged参数（不推荐，存在安全风险）
• 网络模式：使用--net host可将容器加入主机网络（此时端口映射失效，需确保主机***端口可访问）

部署示例

1. 仅分析现有网络trace文件

适用于无需捕获实时流量，仅分析已保存的网络trace文件的场景：

bash
docker run -p 14500:14500 --restart unless-stopped --name wireshark ffeldhaus/wireshark

2. 捕获网络设备流量（基础配置）

需加入主机网络并添加网络管理权限：

bash
docker run --restart unless-stopped --name wireshark --net host --cap-add NET_ADMIN ffeldhaus/wireshark

3. 捕获网络设备流量（高级权限）

当基础配置无法捕获接口时使用（不推荐，存在安全风险）：

bash
docker run --restart unless-stopped --name wireshark --net host --privileged ffeldhaus/wireshark

4. 自定义密码和SSL证书

配置自定义访问密码和SSL证书：

bash
docker run --restart unless-stopped --name wireshark --net host --cap-add NET_ADMIN \
  -e XPRA_PASSWORD=mypassword \
  --mount type=bind,source="$(pwd)"/ssl-cert.pem,target=/etc/xpra/ssl-cert.pem,readonly \
  ffeldhaus/wireshark

访问方式

通过浏览器访问Wireshark，URL格式如下：

https://<你的主机IP或主机名>:14500/?floating_menu=false&password=wireshark

• floating_menu=false：禁用XPRA浮动菜单
• password=wireshark：访问密码（如通过XPRA_PASSWORD修改，需使用自定义密码）
• sharing=true：启用会话共享功能，允许多人同时访问

致谢

本镜像的实现依赖以下项目的优秀工作，建议支持这些项目：

• Wireshark：网络协议分析工具
• XPRA：X11远程应用程序持久化工具