minimsecure/netbox

netbox 镜像文档

镜像概述

netbox 是一个专为网络相关服务检查设计的 Docker 容器，集成了多种网络诊断工具，可用于快速检测、分析和排查网络服务问题。

核心功能和特性

• 集成常用网络诊断工具，如 ping、traceroute、nslookup、curl、dig 等
• 支持网络连通性测试、域名解析验证、服务端口检测
• 轻量级设计，启动快速，资源占用低
• 可直接在容器内执行网络诊断命令，无需在主机环境安装额外工具

使用场景和适用范围

• 网络故障排查：快速定位主机间连通性问题、端口可达性问题
• 服务部署验证：检查新部署服务的网络可访问性
• 容器网络测试：验证容器间、容器与外部服务的网络通信
• 跨环境网络测试：在隔离环境中模拟网络请求，测试服务响应

使用方法和配置说明

基本使用（交互式运行）

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm netbox

进入容器后，可直接使用内置网络工具，例如：

bash
# 测试域名解析
nslookup example.com

# 测试网络连通性
ping 8.8.8.8

# 检测端口连通性
curl -v http://example.com:80

使用主机网络

如需使用主机网络命名空间（可访问主机网络栈），添加 --net=host 参数：

bash
docker run -it --rm --net=host netbox

挂载外部网络配置（可选）

如需使用主机的 DNS 配置或网络文件，可挂载相关文件：

bash
docker run -it --rm -v /etc/resolv.conf:/etc/resolv.conf netbox

后台执行网络检测命令

可直接在容器启动时执行特定网络检测命令，完成后自动退出：

bash
# 执行 traceroute 并输出结果
docker run --rm netbox traceroute example.com

# 检查特定端口连通性
docker run --rm netbox curl -I [***]