mirror of
https://github.com/w154594742/free-v2ray-node.git
synced 2025-09-29 21:57:12 -04:00
123 lines
3.6 KiB
Markdown
123 lines
3.6 KiB
Markdown
# Free V2Ray 节点收集与测试工具
|
||
|
||
这是一个用Python编写的工具，用于自动收集、解析、测试和筛选可用的免费V2Ray节点。该工具支持多种代理协议和格式，可以帮助您快速获取可用的代理节点资源。
|
||
|
||
## 主要功能
|
||
|
||
- 从多个在线资源自动获取免费节点信息
|
||
- 支持多种格式的解析（Base64、YAML、JSON、URI等）
|
||
- 支持多种代理协议（VMess、Trojan、VLESS、Shadowsocks、Shadowsocks-R等）
|
||
- 使用V2Ray/XRay核心程序进行实际连接测试
|
||
- 自动测量节点延迟并筛选可用节点
|
||
- 去除重复节点
|
||
- 以标准格式导出可用节点信息
|
||
|
||
## 支持的协议
|
||
|
||
- VMess
|
||
- Trojan
|
||
- VLESS
|
||
- Shadowsocks (SS)
|
||
- Shadowsocks-R (SSR)
|
||
- HTTP/HTTPS
|
||
- SOCKS
|
||
- Hysteria
|
||
- WireGuard
|
||
|
||
## 安装依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
1. 运行主脚本：
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
2. 工具会自动：
|
||
- 从预定义的链接获取节点信息
|
||
- 解析不同格式的节点配置
|
||
- 进行去重处理
|
||
- 测试节点的连接质量和延迟
|
||
- 生成最终的节点列表
|
||
|
||
3. 测试完成后，结果会保存到：
|
||
- `v2ray.txt`：Base64编码的节点信息（可直接导入到V2Ray客户端）
|
||
- `v2ray_raw.txt`：原始文本格式的节点信息（方便查看）
|
||
|
||
## 代码结构
|
||
|
||
- `main.py`：主程序入口，包含所有功能实现
|
||
- 主要功能模块：
|
||
- 订阅链接获取：`fetch_content`
|
||
- 节点解析：`extract_nodes`、`parse_clash_yaml`、`parse_v2ray_base64`、`parse_v2ray_uri`、`parse_json_nodes`
|
||
- 节点测试：`test_node_latency`、`test_latency`
|
||
- 节点处理：`process_node`、`remove_duplicates`
|
||
- 核心程序管理：`find_core_program`、`download_xray_core`
|
||
|
||
## 订阅链接配置
|
||
|
||
编辑脚本中的`links`列表可以自定义订阅链接：
|
||
|
||
```python
|
||
links = [
|
||
"https://example.com/subscription1",
|
||
"https://example.com/subscription2",
|
||
# 添加更多链接...
|
||
]
|
||
```
|
||
|
||
支持多种链接格式，包含日期变量和GitHub仓库链接。
|
||
|
||
## 特性
|
||
|
||
### 自动下载核心程序
|
||
|
||
如果系统中未找到XRay核心程序，工具会自动从GitHub下载最新版本。
|
||
|
||
### 多种格式解析
|
||
|
||
工具支持按照以下顺序尝试解析节点信息：
|
||
1. Base64编码内容
|
||
2. YAML/Clash配置
|
||
3. 使用正则表达式直接提取
|
||
4. JSON格式数据
|
||
|
||
### 智能链接处理
|
||
|
||
- 支持日期变量替换（如`{Y}`、`{m}`、`{d}`、`{Ymd}`等）
|
||
- 支持GitHub仓库文件自动获取（`{x}`占位符）
|
||
- 特殊站点的特殊处理逻辑
|
||
|
||
### 测试方法
|
||
|
||
使用XRay核心程序建立真实连接，通过访问Google测试端点（`http://www.gstatic.com/generate_204`）来测量延迟。
|
||
|
||
## 注意事项
|
||
|
||
1. 该工具仅供学习和研究使用，请遵守当地法律法规。
|
||
2. 部分节点可能由于网络环境不同而表现不同，测试结果仅供参考。
|
||
3. 可能需要管理员权限来下载和运行核心程序。
|
||
4. 在Windows系统上，可能会有防火墙提示，需要允许程序访问网络。
|
||
|
||
## 故障排除
|
||
|
||
- 如果无法获取节点信息，请检查订阅链接是否有效。
|
||
- 如果测试节点时出现错误，请确保XRay核心程序正确安装。
|
||
- 对于特殊网站的解析问题，可能需要安装额外的依赖（如BeautifulSoup4）。
|
||
- 如果遇到编码问题，可能需要调整`fetch_content`函数中的编码处理逻辑。
|
||
|
||
## 贡献
|
||
|
||
欢迎提交问题报告和改进建议！如果您想贡献代码，请提交Pull Request。
|
||
|
||
## 许可
|
||
|
||
该项目采用MIT许可证。
|
||
|
||
## 免责声明
|
||
|
||
本工具仅用于学习和研究网络技术，请勿用于非法用途。使用本工具所产生的任何后果由使用者自行承担。 |