jonlabelle/network-tools

Docker Network Tools 镜像文档

镜像概述和主要用途

Docker Network Tools是一个预安装了多种网络工具的Docker镜像，旨在为网络诊断、分析和扫描等任务提供便捷的工具集。无需在本地系统安装各类网络工具，通过该镜像可直接启动交互式Bash会话或运行特定工具命令，适用于临时或快速的网络相关操作需求。支持amd64和arm64架构，可从Docker Hub或GitHub Container Registry获取。

核心功能和特性

• 丰富工具集：集成多种常用网络工具，满足各类网络任务需求（完整列表见GitHub仓库）。
• 多架构支持：提供linux/amd64和linux/arm64平台支持，适配不同硬件环境。
• 自动更新：每周自动构建以获取最新安全补丁和工具版本，提交代码或手动触发也可触发构建，确保镜像安全性和工具时效性。
• 灵活使用：支持交互式Bash会话或直接运行工具命令，用完即走（--rm参数），不占用本地资源。

使用场景

• 临时进行网络诊断和故障排查
• 执行网络扫描任务（如使用nmap）
• 快速测试或分析网络环境，避免在本地系统安装多个网络工具
• 需要在不同架构环境（amd64/arm64）中使用统一网络工具集的场景

使用方法

启动交互式Bash会话

在终端中启动交互式Bash会话：

bash
docker run --rm -it jonlabelle/network-tools

在arm64架构上启动交互式Bash会话：

bash
docker run --rm -it --platform linux/arm64 jonlabelle/network-tools

直接运行命令

直接运行工具命令并在完成后退出（以nmap为例）：

bash
docker run --rm -it jonlabelle/network-tools nmap -v 10.0.10.0/24

从GitHub Container Registry拉取

若需从GitHub Container Registry而非Docker Hub拉取镜像，将jonlabelle/network-tools替换为ghcr.io/jonlabelle/network-tools。例如：

bash
docker run --rm -it ghcr.io/jonlabelle/network-tools

包含工具

完整工具列表请参见GitHub仓库的https://github.com/jonlabelle/docker-network-tools?tab=readme-ov-file#included-tools%E3%80%82

自动构建

该镜像通过以下方式自动构建和发布：

• 每周构建：每周日UTC 1:43自动构建，确保包含最新的安全更新和软件包版本，即使无代码变更，基础Alpine Linux镜像和所有网络工具也会获取最新安全补丁。
• 提交触发：主分支有代码推送时自动构建，确保新功能或修复及时可用。
• 手动触发：可通过GitHub Actions工作流手动触发，用于紧急更新或测试。

镜像发布至：

• https://hub.docker.com/r/jonlabelle/network-tools
• https://github.com/jonlabelle/docker-network-tools/pkgs/container/network-tools

支持多架构：linux/amd64和linux/arm64。

建议使用latest标签

请始终使用latest标签（如jonlabelle/network-tools:latest），而非特定版本标签。latest标签会自动更新，包含每周安全补丁、错误修复和工具更新，确保使用最安全和最新的版本。此外，为控制存储，注册表仅保留最近25次构建，旧版本标签可能被移除。

相关项目

https://github.com/jonlabelle/docker-nmap - 预安装Nmap网络安全扫描器的最小Docker镜像。

许可证

https://github.com/jonlabelle/docker-network-tools/blob/main/LICENSE.txt