mubeng：代理检测与 IP 轮换工具

项目简介

mubeng 是一款用 Go 编写的命令行工具，提供两项核心能力：代理 IP 轮换与代理可用性检测。它不需要额外配置文件，只要准备一份代理列表文件，就能以极快的速度完成检查，或把代理池变成一个自动轮换出口 IP 的本地代理服务器。

轮换模式常用于规避基于 IP 的封禁，例如暴力破解防护、API 速率限制或 WAF 拦截；检测模式则可以在不依赖第三方工具的情况下验证代理池质量。

主要功能

• 代理 IP 轮换：按每 N 次请求自动切换代理 IP，可作为本地代理服务器运行。
• 代理检测：批量验证代理 IP 是否可用，可只保留指定国家/地区代码的可用代理。
• 协议兼容：支持 HTTP、HTTPS、SOCKS v4(A)、v5 以及 Amazon API Gateway 代理协议，并可在同一个代理池中混合使用（自动切换 transport）。
• 请求透明：透传所有参数与 URI，支持全部 HTTP/S 方法。
• 自定义输出格式：检测结果可用 --output-format 按模板输出，变量包括 {{proxy}}、{{protocol}}、{{host}}、{{port}}、{{ip}}、{{country}}、{{city}}、{{org}}、{{region}}、{{timezone}}、{{loc}}、{{hostname}}、{{duration}}。
• 跨平台：可在 Windows、Linux、Mac 甚至 Raspberry Pi 上运行。
• 守护进程模式：在 Linux/macOS 上安装为系统服务，在 Windows 上注册服务回调。
• 文件监视：--watch 可在代理文件变化时实时重载。

安装与使用

从 releases 页面 下载预编译二进制文件即可直接运行，也可使用 Docker 或 Go 源码安装。

基本用法（必须先提供代理列表文件）：

▶ mubeng [-c|-a :8080] -f file.txt [options...]

检测代理并只保留 AU、US、UK 的可用代理，结果写入 live.txt：

▶ mubeng -f proxies.txt --check --only-cc AU,US,UK --output live.txt

自定义检测输出格式：

▶ mubeng -f proxies.txt --check --output-format "{{proxy}} | {{country}} | {{duration}}"

代理池文件示例（可混合多种协议）：

http://127.0.0.1:8080
https://127.0.0.1:443
socks4://127.0.0.1:4145
socks5://127.0.0.1:2121

常用参数包括 -a/--address（启动代理服务器）、-A/--auth（设置代理服务器认证）、-d/--daemon（守护进程）、-r/--rotate（每 N 次请求轮换，默认 1）、-m/--method（sequent/random 轮换方式）、-s/--sync（等待上一次请求完成）、--rotate-on-error、--remove-on-error、--max-errors、--max-retries、-o/--output、-v/--verbose 等，完整列表可用 mubeng -h 查看。

mubeng 使用 GoProxy 内置的证书机构；在代理服务器运行期间，用浏览器访问 http://mubeng/cert 即可导出生成的证书，安装步骤与其他代理工具类似。

注意事项

• 轮换按所有请求计数，即使请求失败也会计入。
• 代理服务器默认异步运行，不保证第 N 次之后的请求一定切换 IP；需要严格顺序时请使用 -s/--sync。
• --max-retries 针对同一代理重试失败请求，--max-errors 指所有代理累计失败请求数，两者含义不同；--max-errors 设为小于 0（如 -1）时会无限轮换。
• --verbose 与 --timeout 同时作用于检测和轮换；verbose 模式不会输出请求/响应体，Cookie 值会自动脱敏。
• 使用 -o/--output 运行轮换模式时，请求/响应头不会写入日志文件。
• 超时值支持 5s、300ms、2h45m 等带单位写法。

---

本作品整理自 GitHub 开源项目 mubeng/mubeng，原作者 @mubeng，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。