2026-06-15 00:49:26 +08:00

8.6 KiB

Raw Blame History

WhereAmI - 多协议轮转代理工具

项目简介

WhereAmI 是一个基于 Python 和 PyQt6 的现代化多协议轮转代理工具，能够将各种外部代理（HTTP/HTTPS/SOCKS4/SOCKS5）通过本地 SOCKS5 转发服务部署到 127.0.0.1:8745，配合 Proxifier 等工具使用。

核心特性

🚀 三步工作流程

验证代理：并发测试所有代理的连通性，对 SOCKS5 代理进行握手验证
获取代理：从验证通过的代理列表中选择可用代理作为上游代理
转发到 8745 端口：启动 SOCKS5 服务器监听 8745 端口，双向转发数据

🎯 主要功能

✅ 多协议支持：HTTP、HTTPS、SOCKS4、SOCKS5
✅ 自动获取代理：从指定网页抓取代理列表
✅ 本地文件支持：从 JSON 文件加载代理配置
✅ 健康检测：TCP 延迟测试 + Google 连通性测试
✅ 代理轮转：手动切换 / 自动定时切换
✅ 实时状态监控：GUI 界面显示代理状态、延迟、统计信息
✅ 日志记录：详细的运行日志，支持文件和控制台输出

技术栈

开发语言: Python 3.9+
GUI 框架: PyQt6
网络请求: requests, aiohttp
HTML 解析: BeautifulSoup4, lxml
配置文件: PyYAML
SOCKS 支持: PySocks
日志系统: loguru
加密: cryptography

安装步骤

1. 克隆项目

git clone <repository-url>
cd WhereAmI

2. 安装依赖

pip install -r requirements.txt

3. 运行程序

python main.py

使用说明

快速开始

启动程序
```
python main.py
```
配置代理源
- 点击 "⚙️ 配置" 按钮
- 设置自动获取 URL（默认已配置为泰国代理网站）
- 或启用本地文件模式
获取代理
- 点击 "🌐 获取免费代理" 按钮
- 程序会自动从网页抓取并检测代理
启动服务
- 点击 "▶ 开始服务" 按钮
- 服务将在 127.0.0.1:8745 启动 SOCKS5 代理
配置 Proxifier
- 打开 Proxifier
- 添加代理服务器：127.0.0.1:8745，类型选择 SOCKS5
- 设置代理规则，将需要代理的应用添加到规则中
切换代理
- 手动切换：点击 "🔄 切换下一个" 按钮
- 自动切换：在配置中设置为 auto 模式

配置说明

配置文件 config.yaml 包含以下主要配置项：

# 代理源配置
proxy_sources:
  auto_fetch:
    enabled: true                    # 是否启用自动获取
    url: "http://cn.freevpnnode.com/free-proxy-for-thailand/"  # 抓取URL
    refresh_interval: 10             # 刷新间隔（分钟）
  local_file:
    enabled: true                    # 是否启用本地文件
    path: "local.json"               # 本地文件路径

# 轮转策略
rotation:
  mode: "manual"                     # manual | auto
  auto_switch_interval: 300          # 自动切换间隔（秒）
  latency_threshold: 500             # 延迟阈值（毫秒）

# 输出配置
output:
  host: "127.0.0.1"                  # 监听地址
  port: 8745                         # 监听端口

# 检测配置
health_check:
  timeout: 5                         # TCP连接超时（秒）
  connectivity_test_url: "https://www.google.com/"
  connectivity_timeout: 10           # 连通性测试超时（秒）
  max_failures: 3                    # 最大失败次数
  retry_delay: 600                   # 重试延迟（秒）

本地代理文件格式

项目使用两个JSON文件来管理代理：

1. `proxy.json` - 自动抓取的代理（自动生成）

此文件由程序自动创建，保存从网页抓取的代理列表。不要手动编辑此文件，每次获取新代理时会被覆盖。

2. `local.json` - 用户手动添加的代理（推荐）

此文件用于存放您自己的可靠代理。格式示例：

[
  {
    "ip_address": "192.168.1.100",
    "port": 1080,
    "username": "no need",
    "password": "no need",
    "protocol": "socks5",
    "country": "CN",
    "anonymity": "elite",
    "speed": "fast",
    "uptime_percentage": "99%",
    "response_time": "100ms",
    "latency": "50ms",
    "last_updated": "now"
  }
]

必填字段：

ip_address: 代理 IP 地址
port: 代理端口
username: 用户名（无认证填 "no need"）
password: 密码（无认证填 "no need"）
protocol: 协议类型（http/https/socks4/socks5）

可选字段：

country: 国家代码
anonymity: 匿名级别
speed: 速度描述
uptime_percentage: 在线率
response_time: 响应时间
latency: 延迟
last_updated: 最后更新时间

GUI 界面说明

主界面布局

顶部状态栏

状态指示器：显示服务运行状态（运行中/已停止）
当前代理信息：显示正在使用的代理 IP、端口、协议、延迟
统计信息：显示总代理数、可用数、优秀数、不可用数

控制按钮区

▶ 开始服务：启动 SOCKS5 代理服务（需要先选择一个代理节点）
⏹ 停止服务：停止代理服务
🔄 切换下一个：切换到下一个可用代理
🌐 获取免费代理：从网页抓取代理并检测（默认功能）
📁 使用本地代理：仅加载 local.json 中的代理
🔧 其他代理（预留）：暂未实现，预留用于后续测试
⚙️ 配置：打开配置对话框

标签页

代理列表：显示所有代理的详细信息表格
- 列：IP地址、端口、协议、国家、状态、延迟、匿名级别、速度、运行时间、最后更新
- 状态颜色：🟢 优秀、🟡 可用、🔴 不可用、⚪ 未知
- 过滤选项："显示不可用代理"复选框，控制是否显示不可用的代理
- 选择代理：点击表格行来选择要使用的代理节点
连接日志：显示所有通过代理的连接记录
- 格式：[时间戳] 本地IP:端口 -> 远程代理IP:端口
- 示例：[2026-06-14 22:30:15] 127.0.0.1:54321 -> 192.168.1.100:1080
- 支持清空日志
日志：显示程序运行日志
- 支持清空日志
- 显示时间戳和详细操作信息

常见问题

Q1: 如何测试代理是否工作？

A: 启动服务后，使用 curl 命令测试：

curl -x socks5://127.0.0.1:8745 https://ip.sb

Q2: 为什么有些代理显示为不可用？

A: 代理可能因为以下原因被标记为不可用：

TCP 连接超时（>5秒）
Google 连通性测试失败
连续失败 3 次以上

Q3: 如何添加自己的代理？

A: 编辑 local.json 文件，按照格式添加您的可靠代理信息。程序会自动合并 proxy.json（抓取的代理）和 local.json（手动添加的代理）。建议优先使用 local.json 添加稳定可靠的代理。

Q4: 端口 8745 被占用怎么办？

A: 在配置中修改监听端口，或使用以下命令查找占用进程：

netstat -ano | findstr "8745"

Q5: 如何实现自动切换代理？

A: 在配置中将 rotation.mode 设置为 "auto"，并设置 auto_switch_interval 为期望的切换间隔（秒）。

项目结构

WhereAmI/
├── main.py                 # 主入口
├── config.yaml            # 配置文件
├── proxy.json             # 自动抓取的代理（程序自动生成）
├── local.json             # 用户手动添加的代理（推荐）
├── requirements.txt       # 依赖包
├── README.md              # 项目说明
├── core/                  # 核心逻辑
│   ├── __init__.py
│   ├── models.py          # 数据模型
│   ├── data_source.py     # 数据源获取
│   ├── health_checker.py  # 健康检测器
│   ├── proxy_manager.py   # 代理管理器
│   └── simple_proxy_forwarder.py  # 简化转发器
├── gui/                   # GUI界面
│   ├── __init__.py
│   └── main_window.py     # 主窗口
├── utils/                 # 工具类
│   └── __init__.py
└── logs/                  # 日志目录
    └── whereami.log

注意事项

首次运行：请确保安装了所有依赖包
代理质量：免费代理稳定性较差，建议定期更新代理列表
安全性：不要在免费代理上登录敏感账户或传输机密数据
法律合规：请遵守当地法律法规，合理使用代理服务

许可证

本项目仅供学习和研究使用。

贡献

欢迎提交 Issue 和 Pull Request！

版本: v1.0.0
更新日期: 2026-06-14

8.6 KiB Raw Blame History Unescape Escape