v2raypool

简介

同时运行多个v2ray代理，暴露多个本地IP端口，组成简单的IP代理池。

可以选一个节点设为系统代理，用来浏览网页。要求不高的话，也可同时调用多个，作为爬虫切换IP的代理池。

提供通用的gRPC控制接口，参看数据定义文件 v2raypool.proto

Windows代理设置: 网络和Internet -> 代理 -> 手动设置代理

使用说明

不想自己编译项目源码，可下载Release压缩包直接使用，再看第4-5步的使用说明。

1. 下载依赖

运行命令: go mod tidy

1.1 如因网络问题下载失败，可设置模块代理。运行命令:

go env -w GOPROXY=https://goproxy.cn,direct
# 或者 go env -w GOPROXY=https://goproxy.io,direct

1.2 若出现依赖包版本冲突，请删除 go.mod 文件，再运行命令:

go mod init github.com/iotames/v2raypool
go mod tidy

2. 编译可执行文件

2.1 编译

# 进入项目 main 目录，并执行go编译命令
cd main

# linux或mac 运行: go build -o v2raypool -trimpath -ldflags "-s -w -buildid=" .
go build -o v2raypool.exe -trimpath -ldflags "-s -w -buildid=" .

编译出二进制可执行文件 v2raypool(linux or max) 或 v2raypool.exe(windows)

2.2 生成配置文件

命令行运行可执行文件(v2raypool.exe 或 ./v2raypool)，会生成配置文件 .env。并提示找不到v2ray核心文件：

v2raypool.exe
请检查配置文件，路径:(.env)
VP_V2RAY_PATH 配置项错误，找不到可执行文件。
请下载v2ray核心文件(https://github.com/v2fly/v2ray-core/releases)

3. 下载v2ray核心文件

3.1 官网下载核心文件Zip压缩包: https://github.com/v2fly/v2ray-core/releases

3.2 解压到 main/bin 目录，并删除或改名解压后的 config.json 文件，防止程序错误读取。

3.3 检查或修改v2ray 可执行文件路径: 查看 .env 配置文件的 VP_V2RAY_PATH 配置项。

4. 设置订阅地址

更改 .env 配置文件的 VP_SUBSCRIBE_URL，改成实际使用的订阅源地址(http开头) 若订阅源地址网络异常，可使用 VP_SUBSCRIBE_DATA_FILE 配置项。通过其他途径查看订阅地址的响应结果，把内容存入文件。

VP_HTTP_PROXY 配置项，可设置一个http开头的代理地址。在 gRPC客户端 使用 --activeproxynode 命令项可激活一个节点使用代理端口。

5. 运行服务端和客户端

5.1 服务端

可执行文件直接运行，启动 gRPC 服务端

# linux 或 mac 执行 ./v2raypool
v2raypool.exe

5.2 客户端

gRPC 客户端交互命令:

# 启动v2ray代理池
v2raypool.exe --startproxynodes

# 查看v2ray代理池信息(包括：本地代理端口号，测速结果，运行状态，测速时间，节点名，节点索引)
v2raypool.exe --getproxynodes

# 测速(测速基准使用https://www.google.com)。测速结束后，会自动选择最快的节点作为系统代理节点。
v2raypool.exe --testproxynodes

# 根据索引值激活某个节点为系统代理的端口（--getproxynodes 查看索引值，系统代理端口从VP_HTTP_PROXY的值读取）
v2raypool.exe --activeproxynode=16

# 停止所有节点
v2raypool.exe --stopproxynodes

6. 配置systemd系统服务(Linux)

使用环境变量 VP_ENV_FILE 定义环境变量配置文件的路径。不设置默认为 .env

使用Linux自带的systemctl命令管理 v2raypool。

1. 新建 v2raypool.service 文件：

vim /usr/lib/systemd/system/v2raypool.service

v2raypool.service内容示例(/root/v2raypool/main 为可执行文件所在路径):

[Unit]
Description=v2ray proxy pool
After=network.target

[Service]
WorkingDirectory=/root/v2raypool/main
ExecStart=/root/v2raypool/main/v2raypool
User=root
Restart=on-failure
RestartSec=300
# KillSignal=SIGQUIT
TimeoutStopSec=10
StandardOutput=file:/root/v2raypool/main/output.log
# StandardError=file:/root/qddns/output.err.log

[Install]
WantedBy=multi-user.target

1. 重载systemd配置

systemctl daemon-reload

1. 使用 systemctl 管理v2raypool的gRPC服务端

systemctl status v2raypool
systemctl start v2raypool
systemctl stop v2raypool

配置说明

在 main 目录编译生成可执行文件，首次运行会生成2个文件:

• default.env: 显示所有配置项的默认值，不应修改此文件。
• .env: 程序配置文件。更改后可覆盖 default.env 文件中的默认值。

# 该目录存放程序运行时产生的文件
VP_RUNTIME_DIR = "runtime"

# Web服务器端口。设置为0可禁用Web面板
VP_WEB_SERVER_PORT = 8087

# 代理池的gRPC服务端口
VP_GRPC_PORT = 50051

# v2ray可执行文件路径
# 例: "D:\\Users\\yourname\\v2ray-windows-64\\v2ray.exe" or "/root/v2ray-linux64/v2ray"
VP_V2RAY_PATH = "bin/v2ray.exe"

# 代理节点订阅地址
VP_SUBSCRIBE_URL = ""

# 若订阅地址无法直接访问，可指定订阅数据文件，数据文件内容为访问订阅地址获取的原始数据。
# 若有设置订阅数据文件，且文件内容不为空。则优先从该文件读取订阅节点信息。
VP_SUBSCRIBE_DATA_FILE = "subscribe_data.txt"

# 设置HTTP代理，代理池每个节点的本地端口号，往后开始累加。为防止与常用端口冲突，尽量设大点。
VP_HTTP_PROXY = "http://127.0.0.1:30000"

# 节点测速的URL
VP_TEST_URL = "https://www.google.com"

订阅节点

数据格式

1. VP_SUBSCRIBE_URL: 订阅地址配置。填写 http 开头的URL网址。

2. base64订阅数据: 访问订阅地址得到的原始数据。数据被BASE64加密，可保存为 subscribe_data.txt 文件，并配置 VP_SUBSCRIBE_DATA_FILE 选项。

base64订阅数据 经过 base64解码 后，得到以 \n 换行符分割的多个代理节点信息。 每个节点信息也是被Base64加密过的。格式为: 协议://Base64加密字符串。如下所示:

ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTMwNTozNlpDSGVhYlVTZktqZlFFdko0SERW@185.242.86.156:54170#github.com/freefq%20-%20%E4%BF%84%E7%BD%97%E6%96%AF%20%201
vmess://eyJhZGQiOiAiMjAyLjc4LjE2Mi41IiwgImFpZCI6IDAsICJob3N0IjogImlyc29mdC5zeXRlcy5uZXQiLCAiaWQiOiAiMmZmOTdjNmQtODU1Ny00MmE0LWI0M2YtMTljNzdjNTk1OWVhIiwgIm5ldCI6ICJ3cyIsICJwYXRoIjogIi9AZm9yd2FyZHYycmF5IiwgInBvcnQiOiA0NDMsICJwcyI6ICJnaXRodWIuY29tL2ZyZWVmcSAtIFx1NTM3MFx1NWVhNiAgMiIsICJ0bHMiOiAidGxzIiwgInR5cGUiOiAiYXV0byIsICJzZWN1cml0eSI6ICJhdXRvIiwgInNraXAtY2VydC12ZXJpZnkiOiB0cnVlLCAic25pIjogIiJ9
vmess://eyJhZGQiOiAiMjAyLjc4LjE2Mi41IiwgImFpZCI6IDAsICJob3N0IjogInNhaGFuZC5zZXJ2ZW1pbmVjcmFmdC5uZXQiLCAiaWQiOiAiMTE4Mjg3ZDItZTk2OC00MmUxLTgwZDAtMTJmYTJmNWQzOGQ2IiwgIm5ldCI6ICJ3cyIsICJwYXRoIjogIi9AZm9yd2FyZHYycmF5IiwgInBvcnQiOiA0NDMsICJwcyI6ICJnaXRodWIuY29tL2ZyZWVmcSAtIFx1NTM3MFx1NWVhNiAgMyIsICJ0bHMiOiAidGxzIiwgInR5cGUiOiAiYXV0byIsICJzZWN1cml0eSI6ICJhdXRvIiwgInNraXAtY2VydC12ZXJpZnkiOiB0cnVlLCAic25pIjogIiJ9
vmess://eyJ2IjogIjIiLCAicHMiOiAiZ2l0aHViLmNvbS9mcmVlZnEgLSBcdTdmOGVcdTU2ZmRDbG91ZEZsYXJlXHU1MTZjXHU1M2Y4Q0ROXHU4MjgyXHU3MGI5IDQiLCAiYWRkIjogInd3dy5kYXJrcm9vbS5sb2wiLCAicG9ydCI6IDgwODAsICJpZCI6ICIyMjgyNmI0NC01YzFhLTRiNGItZGJhYS04M2EyZThiZDk1ZjAiLCAiYWlkIjogMCwgInNjeSI6ICJhdXRvIiwgIm5ldCI6ICJ3cyIsICJob3N0IjogInd3dy5kYXJrcm9vbS5sb2wiLCAicGF0aCI6ICIvIiwgInRscyI6ICIifQ==
ss://YWVzLTI1Ni1nY206N0JjTGRzTzFXd2VvR0QwWA@193.243.147.128:40368#github.com/freefq%20-%20%E6%B3%A2%E5%85%B0%20%205
vmess://eyJhZGQiOiAic2VydmVyMzEuYmVoZXNodGJhbmVoLmNvbSIsICJhaWQiOiAwLCAiaG9zdCI6ICJzZXJ2ZXIzMS5iZWhlc2h0YmFuZWguY29tIiwgImlkIjogIjQxNTQxNDNjLWJiYmEtNDdhNC05Zjc5LWMyZWQwODdjYmNjOSIsICJuZXQiOiAid3MiLCAicGF0aCI6ICIvIiwgInBvcnQiOiA4ODgwLCAicHMiOiAiZ2l0aHViLmNvbS9mcmVlZnEgLSBcdTdmOGVcdTU2ZmRDbG91ZEZsYXJlXHU1MTZjXHU1M2Y4Q0ROXHU4MjgyXHU3MGI5IDYiLCAidGxzIjogIiIsICJ0eXBlIjogImF1dG8iLCAic2VjdXJpdHkiOiAiYXV0byIsICJza2lwLWNlcnQtdmVyaWZ5IjogdHJ1ZSwgInNuaSI6ICIifQ==

1. 系统会忽略格式错误或解析失败的节点，然后继续解析下个节点。

2. 节点信息再次经过 BASE64解码 后，解析为JSON字符串格式。如下所示:

{"add":"us0.u9v2v2.top","host":"","id":"93EA57CE-EA21-7240-EE7F-317F4A6A8B65","net":"ws","path":"","port":"444","ps":"u9un-v2-US-LosAngeles0","tls":"","type":"none","v":2,"aid":0}

错误提示

1. ---ParseV2rayNodes--Base64.Decode--err: 表示解析到一个错误的代理节点。该节点为BASE64解码错误。系统自动忽略并解析下一个节点。
2. ---ParseV2rayNodes--json.Unmarshal err: 表示解析到一个错误的代理节点。该节点BASE64解码后，不是符合规范的JSON数据格式。系统自动忽略并解析下一个节点。

如下节点会解析失败:

ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTMwNTozNlpDSGVhYlVTZktqZlFFdko0SERW@185.242.86.156:54170#github.com/freefq%20-%20%E4%BF%84%E7%BD%97%E6%96%AF%20%201

调试工具

• base64在线解码

路由规则

支持自定义域名和IP列表配置:

• PROXY_DOMAIN_LIST 代理域名列表
• DIRECT_DOMAIN_LIST 直连域名列表
• PROXY_IP_LIST 代理IP列表
• DIRECT_IP_LIST 直连IP列表

域名匹配规则:

• 纯字符串：当此字符串匹配目标域名中任意部分，该规则生效。比如 sina.com 可以匹配 sina.com、sina.com.cn、sina.company 和 www.sina.com，但不匹配 sina.cn。
• 正则表达式：由 regexp: 开始，余下部分是一个正则表达式。当此正则表达式匹配目标域名时，该规则生效。例如 regexp:\.goo.*\.com$`` 匹配 www.google.com、fonts.googleapis.com，但不匹配 google.com`。
• 子域名（推荐）：由 domain: 开始，余下部分是一个域名。当此域名是目标域名或其子域名时，该规则生效。例如 domain:v2ray.com 匹配 www.v2ray.com、v2ray.com，但不匹配 xv2ray.com。
• 完整匹配：由 full: 开始，余下部分是一个域名。当此域名完整匹配目标域名时，该规则生效。例如 full:v2ray.com 匹配 v2ray.com 但不匹配 www.v2ray.com。
• 预定义域名列表：由 geosite: 开头，余下部分是一个类别名称（域名列表），如 geosite:google 或者 geosite:cn。名称及域名列表参考预定义域名列表。
• 从文件中加载域名：形如 ext:file:tag，必须以 ext: 开头，后面跟文件名和标签，文件存放在资源目录中，文件格式与 geosite.dat 相同，标签必须在文件中存在。

IP匹配规则:

• IP：形如 127.0.0.1。
• CIDR：形如 10.0.0.0/8。
• GeoIP： 形如 geoip:cn 为正向匹配，即为匹配「中国大陆 IP 地址」。后面跟双字符国家或地区代码，支持所有可以上网的国家和地区。

形如 `geoip:!cn`` 为反向匹配，即为匹配「非中国大陆 IP 地址」。后面跟双字符国家或地区代码，支持所有可以上网的国家和地区。

特殊值：geoip:private（V2Ray 3.5+），包含所有私有地址，如 127.0.0.1。

• 从文件中加载 IP： 形如 ext:file:tag 和 ext-ip:file:tag 为正向匹配，即为匹配 「tag 内的 IP 地址」。

形如 ext:file:!tag 和 ext-ip:file:!tag 为反向匹配，即为匹配「非 tag 内的 IP 地址」。

必须以 ext: 或 ext-ip: 开头，后面跟文件名、标签或 !标签，文件存放在资源目录中，文件格式与 geoip.dat 相同，标签必须在文件中存在。

具体请参看 v2ray路由规则

开发相关

gRPC接口

1. 使用proto数据格式定义文件: ./v2raypool.proto 可实现跨语言调用
2. Go语言的gRPC接口文件位于 ./grpc 目录。引用包名: github.com/iotames/v2raypool/grpc
3. 调用过程参考代码文件: ./main/main_grpc.go

# 从proto数据格式文件生成可供Go语言调用的代码包
protoc --go_out=./ --go-grpc_out=./ v2raypool.proto