-
同时接入多个v2ray节点,使用多个本地端口,组成简单的IP代理池服务。可供爬虫等程序调用。
-
可以选一个节点设为系统代理,作为普通的v2ray客户端使用。
-
提供通用gRPC控制接口,参看数据定义文件
v2raypool.proto
项目文档: https://iotames.github.io/v2raypool/
提供 gRPC接口
和 Web网页
两种交互方式。
Windows代理设置: 网络和Internet
-> 代理
-> 手动设置代理
不想自己编译项目源码,可下载Release压缩包直接使用,再看第4-5步的使用说明。
运行命令: 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.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.1 官网下载核心文件Zip压缩包: https://github.com/v2fly/v2ray-core/releases
3.2 解压到 main/bin
目录,并删除或改名解压后的 config.json
文件,防止程序错误读取。
3.3 检查或修改v2ray 可执行文件路径
: 查看 .env
配置文件的 VP_V2RAY_PATH
配置项。
设置代理节点的订阅源地址,请更改 .env
文件的 VP_SUBSCRIBE_URL
配置项,配置值为http网络地址。
若网络地址访问异常,可使用 VP_SUBSCRIBE_DATA_FILE
配置项。设法查看订阅地址的响应结果,保存到文件 subscribe_data.txt
。
5.1 服务端
可执行文件直接运行,会启动 gRPC
和 WebUI
服务端。
首次运行,会自动生成 .env
和 default.env
配置文件。
# linux 或 mac 执行 ./v2raypool
v2raypool.exe
5.2 客户端
gRPC
客户端交互命令:
# 启动v2ray代理池,激活所有代理节点。
v2raypool.exe --startproxynodes
# 查看v2ray代理池信息(包括:本地代理端口号,测速结果,运行状态,测速时间,节点名,节点索引)
v2raypool.exe --getproxynodes
# 临时设置默认的URL测速地址。默认为 .env 文件中 VP_TEST_URL 配置项的值。
v2raypool.exe --setproxytesturl
# 测速(测速基准使用https://www.google.com)。测速结束后,会自动选择最快的节点作为系统代理节点。
v2raypool.exe --testproxynodes
# 指定已测速过的域名,按速度从快到慢,查看代理节点信息
v2raypool.exe --getproxynodesbydomain=www.google.com
# 根据索引值激活某个节点为系统代理的端口(--getproxynodes 命令可查看索引值,系统代理端口从VP_HTTP_PROXY的值读取)
v2raypool.exe --activeproxynode=16
# 更新订阅。更新节点的同时,也会更新 subscribe_data.txt 数据文件
v2raypool.exe --updateproxynodes
# 停止所有节点
v2raypool.exe --stopproxynodes
WebUI
网页面板: http://127.0.0.1:8087. windows
环境下网页会自动打开。
Linux平台通过配置 v2raypool.service
,可使用 systemctl
系统命令来管理 v2raypool
。
可使用环境变量 VP_ENV_FILE
定义配置文件的路径。不设置默认为 .env
- 新建
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/v2raypool/main/output.err.log
[Install]
WantedBy=multi-user.target
- 重载systemd配置
systemctl daemon-reload
- 使用 systemctl 管理v2raypool的gRPC服务端
systemctl status v2raypool
systemctl start v2raypool
systemctl stop v2raypool
在 main
目录编译生成可执行文件,首次运行会生成2个文件:
default.env
: 显示所有配置项的默认值,不应修改此文件。.env
: 程序配置文件。更改后可覆盖 default.env 文件中的默认值。
# 该目录存放程序运行时产生的文件
VP_RUNTIME_DIR = "runtime"
# 傻瓜模式。当配置满足条件时,应用启动后,自动运行所有节点,执行测速,并设置速度最快的节点为系统代理。
# 适合打包现成的配置和应用,直接分享给小白用。
VP_AUTO_START = true
# 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"
# 代理节点订阅地址
# 支持 http:// 和 socks5:// 协议
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"
出站协议 | 订阅数据格式 | 是否支持 |
---|---|---|
vmess:// | base64 | ✅ |
ss:// | base64 | ✅ |
trojan:// | - | ✅ |
ssr:// | - | ❌ |
- ✅ 已支持
- ⛏️ 开发中
- ❌ 不支持
-
VP_SUBSCRIBE_URL
: 订阅源的地址配置。填写http
开头的URL网址。 -
订阅数据
: 访问订阅源的URL地址得到的原始数据。数据可能被BASE64编码过,可保存为subscribe_data.txt
文件,并配置VP_SUBSCRIBE_DATA_FILE
选项。
订阅数据
经过 base64解码
后,得到以 \n
换行符分割的多个代理节点信息。
每个节点信息,可能都被Base64编码过(vmess://),也可能是明文(vless://),或者二者混合(ss://)。如下所示:
vmess://eyJhZGQiOiAiMjAyLjc4LjE2Mi41IiwgImFpZCI6IDAsICJob3N0IjogImlyc29mdC5zeXRlcy5uZXQiLCAiaWQiOiAiMmZmOTdjNmQtODU1Ny00MmE0LWI0M2YtMTljNzdjNTk1OWVhIiwgIm5ldCI6ICJ3cyIsICJwYXRoIjogIi9AZm9yd2FyZHYycmF5IiwgInBvcnQiOiA0NDMsICJwcyI6ICJnaXRodWIuY29tL2ZyZWVmcSAtIFx1NTM3MFx1NWVhNiAgMiIsICJ0bHMiOiAidGxzIiwgInR5cGUiOiAiYXV0byIsICJzZWN1cml0eSI6ICJhdXRvIiwgInNraXAtY2VydC12ZXJpZnkiOiB0cnVlLCAic25pIjogIiJ9
vless://[email protected]:443?encryption=none&security=reality&sni=azure.microsoft.com&fp=safari&pbk=c7qU9-_0WflwIKUiZFxSss_xw-2AP3jB1ENxKLI0OTw&type=tcp&headerType=none#u9un-US-Xr1
ss://Y2hhY2hhMjAtaWV0Zi1wb2x5MTMwNTozNlpDSGVhYlVTZktqZlFFdko0SERW@185.242.86.156:54170#github.com/freefq%20-%20%E4%BF%84%E7%BD%97%E6%96%AF%20%201
ss://[email protected]:40368#github.com/freefq%20-%20%E6%B3%A2%E5%85%B0%20%205
vmess://eyJhZGQiOiAic2VydmVyMzEuYmVoZXNodGJhbmVoLmNvbSIsICJhaWQiOiAwLCAiaG9zdCI6ICJzZXJ2ZXIzMS5iZWhlc2h0YmFuZWguY29tIiwgImlkIjogIjQxNTQxNDNjLWJiYmEtNDdhNC05Zjc5LWMyZWQwODdjYmNjOSIsICJuZXQiOiAid3MiLCAicGF0aCI6ICIvIiwgInBvcnQiOiA4ODgwLCAicHMiOiAiZ2l0aHViLmNvbS9mcmVlZnEgLSBcdTdmOGVcdTU2ZmRDbG91ZEZsYXJlXHU1MTZjXHU1M2Y4Q0ROXHU4MjgyXHU3MGI5IDYiLCAidGxzIjogIiIsICJ0eXBlIjogImF1dG8iLCAic2VjdXJpdHkiOiAiYXV0byIsICJza2lwLWNlcnQtdmVyaWZ5IjogdHJ1ZSwgInNuaSI6ICIifQ==
-
由于协议不支持,数据格式不兼容,等原因造成的节点解析失败,都会被忽略,然后继续解析下个节点。
-
vmess
节点信息再次经过BASE64解码
后,解析为JSON字符串格式。如下所示:
{"add":"us0.xxx.top","host":"","id":"93EA57CE-EA21-7240-EE7F-317F4A6A8B65","net":"ws","path":"","port":"444","ps":"xxx-v2-US-LosAngeles0","tls":"","type":"none","v":2,"aid":0}
支持自定义域名和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路由规则
- 使用proto数据格式定义文件:
./v2raypool.proto
可实现跨语言调用 - Go语言的gRPC接口文件位于
./grpc
目录。引用包名:github.com/iotames/v2raypool/grpc
- 调用过程参考代码文件:
./main/main_grpc.go
# 从proto数据格式文件生成可供Go语言调用的代码包
protoc --go_out=./ --go-grpc_out=./ v2raypool.proto