一个高效的代理扫描和测试工具,支持检测 HTTP、HTTPS、SOCKS4 和 SOCKS5 类型的代理,判断其有效性和匿名性,适用于代理发现与批量验证场景。
| 功能分类 | 具体说明 |
|---|---|
| 多类型支持 | 兼容 HTTP、HTTPS、SOCKS4、SOCKS5 四种主流代理类型 |
| 双工作模式 | 发现模式(扫描 IP 范围/文件)、测试模式(验证已有代理列表) |
| 匿名性检测 | 自动判断代理是否暴露本机真实 IP,区分匿名/非匿名代理 |
| 灵活配置 | 可自定义 IP 范围、扫描端口、超时时间、并发数等参数 |
| 批量处理 | 支持大型网段批次扫描,避免内存占用过高 |
| 结果筛选 | 通过内容验证关键字筛选符合业务需求的有效代理 |
| 日志与保存 | 支持详细调试日志、多种保存模式(全部/仅匿名代理) |
| 异常处理 | 完善的信号捕获(Ctrl+C)、重试机制、SSL 忽略选项 |
# 发现模式(扫描新代理) proxy-finder -m s [选项] # 测试模式(验证已有代理) proxy-finder -testfile [代理列表文件路径] [选项]
| 选项 | 类型 | 描述 | 示例 |
|---|---|---|---|
-m s |
模式 | 指定为「发现模式」(必需) | -m s |
-range |
IP 范围 | 扫描的 IP 段(CIDR/起止格式) | -range 192.168.1.0/24 或 -range 10.0.0.1-10.0.0.255 |
-file |
文件路径 | 包含 IP/CIDR 的列表文件(每行一条) | -file ips.txt |
-testfile |
文件路径 | 包含代理的列表文件(测试模式必需) | -testfile proxies.txt |
-type |
代理类型 | 指定扫描的代理类型(逗号分隔) | -type http,https,socks5 |
-v |
开关 | 启用详细模式(显示调试日志,不显示进度) | -v |
-t |
整数 | 代理测试超时时间(秒),默认 10 秒 | -t 15 |
-p |
整数 | 并发数,默认 200(高并发需调整系统限制) | -p 150 |
-ports |
端口列表 | 自定义扫描端口(逗号分隔) | -ports 8080,3128,1080 |
-url |
URL | 自定义测试 URL(默认 https://httpbin.org/ip) | -url https://www.baidu.com |
-content |
字符串 | 内容验证关键字(仅保留包含该关键字的响应) | -content "success" |
-s |
整数 | 保存模式:0=不保存,1=保存所有有效代理,2=仅保存匿名代理(默认 1) | -s 2 |
-h |
开关 | 显示帮助信息 | -h |
# 扫描 192.168.1.0/24 网段,仅检测 HTTP/HTTPS 代理,并发 150,超时 12 秒
proxy-finder -m s -range 192.168.1.0/24 -type http,https -p 150 -t 12# 从 ips.txt 读取 IP/CIDR,扫描预设端口,仅保存匿名代理到 data 目录
proxy-finder -m s -file ips.txt -s 2# 测试 proxies.txt 中的代理,启用日志,自定义测试 URL 为百度
proxy-finder -testfile proxies.txt -log -url https://www.baidu.com# 详细模式扫描,显示每步调试信息,忽略 SSL 证书错误
proxy-finder -m s -range 10.0.0.0/24 -v -ignoressl- Ubuntu 22.04 LTS 系统(64 位)
- 具有 sudo 权限的用户
- 稳定的网络连接(用于安装依赖和测试代理)
# 更新系统包索引 sudo apt update && sudo apt upgrade -y # 安装 Go 语言环境(编译必需)和 Git(可选,用于拉取代码) sudo apt install -y golang git
go version
- 正常输出示例:
go version go1.18.1 linux/amd64(版本 ≥1.16 即可)
# 方式 1:Git 拉取(推荐,便于更新) git clone https://github.com/saycc1982/proxy-finder.git # 替换为实际仓库地址 cd proxy-finder # 方式 2:手动下载源码(无 Git 时) # 1. 下载 proxy-finder.go 文件到本地 # 2. 进入文件所在目录 # 编译生成可执行文件 go build -o proxy-finder proxy-finder.go
# 将程序移动到系统全局路径,支持任意目录调用 sudo mv proxy-finder /usr/local/bin/ # 验证配置 proxy-finder -h # 正常显示帮助信息即成功
# 创建 data 目录(用于保存结果和日志) mkdir -p ~/proxy-finder-data chmod 755 ~/proxy-finder-data # 后续运行时可指定日志/结果路径到该目录 proxy-finder -m s -range 192.168.1.0/24 -logfile ~/proxy-finder-data/proxy-log.log
- 提示
创建 data 目录失败: permission denied或无法写入日志文件
# 方法 1:给当前目录赋予写入权限 chmod 755 . # 方法 2:指定自定义数据目录(推荐) mkdir -p ~/proxy-data proxy-finder -m s -range 192.168.1.0/24 -logfile ~/proxy-data/log.txt -s 1
- 提示
请求失败: context deadline exceeded或响应状态码非 200
# 1. 检查网络连通性 ping 8.8.8.8 # 测试外网连接 curl https://httpbin.org/ip # 测试默认测试 URL # 2. 关闭防火墙(临时测试,生产环境需按需配置规则) sudo ufw disable # 3. 更换国内测试 URL(如默认 URL 无法访问) proxy-finder -m s -range 192.168.1.0/24 -url https://www.baidu.com
- 高并发时提示
打开文件过多或too many open files
# 方法 1:临时提高文件描述符限制(当前终端生效) ulimit -n 65535 # 方法 2:永久提高限制(重启后生效) sudo tee -a /etc/security/limits.conf << EOF * soft nofile 65535 * hard nofile 65535 EOF # 方法 3:降低并发数(避免资源耗尽) proxy-finder -m s -range 192.168.1.0/24 -p 100 # 并发数从默认 200 降至 100
- 提示
undefined: xxx或version go1.xx is required
# 1. 检查 Go 版本(需 ≥1.16) go version # 2. 升级 Go 版本(以 1.20.4 为例) sudo apt remove golang -y wget https://dl.google.com/go/go1.20.4.linux-amd64.tar.gz sudo tar -C /usr/local -xzf go1.20.4.linux-amd64.tar.gz # 3. 配置 Go 环境变量 echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc source ~/.bashrc # 4. 重新编译 go build -o proxy-finder proxy-finder.go
- 提示
两次 IP 服务失败或无法检查代理是否暴露本机 IP
# 1. 手动指定国内可访问的测试 URL(跳过 IP 检测) proxy-finder -m s -range 192.168.1.0/24 -url https://www.baidu.com # 2. 检查 IP 服务连通性 curl http://myip.ipip.net # 测试第一个 IP 服务 curl https://trackip.net/ip # 测试第二个 IP 服务
- 合规性:请确保扫描的 IP 段和代理使用符合当地法律法规,禁止用于未授权的网络探测。
- 资源占用:高并发(如
-p 500)可能占用大量 CPU/带宽,建议根据服务器配置调整。 - 代理列表格式:
-testfile支持的代理格式:http://ip:port、socks5://ip:port或ip:port(默认 http)。 - 日志查看:启用
-log后,日志默认保存到data/log_时间戳.log,可通过-logfile自定义路径。
如有功能建议或 BUG 反馈,欢迎联络作者:
- 作者:ED
- 联络:https://t.me/hongkongisp
- 服务器推荐:顺安云 https://www.say.cc
- (香港自营机房,稳定可靠)