技能名称: vpn-rotate-skill
详细描述:

VPN 轮换技能

轮换 VPN 服务器以绕过 API 速率限制。适用于任何兼容 OpenVPN 的 VPN。

设置

1. 运行设置向导

bash
./scripts/setup.sh

此操作将：

• - 检查 OpenVPN 是否已安装
• 帮助您配置 VPN 提供商
• 设置免密码 sudo
• 测试连接

2. 手动设置

如果您偏好手动设置：

bash

安装 OpenVPN

创建配置目录

从您的 VPN 提供商下载 .ovpn 文件

将它们放入 ~/.vpn/servers/

创建凭据文件

为 openvpn 启用免密码 sudo

使用方法

装饰器（推荐）

python
from scripts.decorator import withvpnrotation

@withvpnrotation(rotate_every=10, delay=1.0)
def scrape(url):
return requests.get(url).json()

每调用 10 次自动轮换 VPN

VPN 类

python
from scripts.vpn import VPN

vpn = VPN()

连接

轮换（断开连接 + 重新连接到不同服务器）

断开连接

上下文管理器

python
from scripts.vpn import VPN

vpn = VPN()

with vpn.session():
# VPN 已连接
for url in urls:
vpn.before_request() # 处理轮换
data = requests.get(url).json()

VPN 已断开

命令行界面

bash
python scripts/vpn.py connect
python scripts/vpn.py status
python scripts/vpn.py rotate
python scripts/vpn.py disconnect
python scripts/vpn.py ip

配置

装饰器选项

python
@withvpnrotation(
rotate_every=10, # 每 N 次请求后轮换
delay=1.0, # 请求之间的秒数
config_dir=None, # 覆盖配置目录
creds_file=None, # 覆盖凭据文件
country=None, # 按国家前缀过滤服务器（例如 us）
auto_connect=True, # 首次请求时自动连接
)

VPN 类选项

python
VPN(
config_dir=~/.vpn/servers,
creds_file=~/.vpn/creds.txt,
rotate_every=10,
delay=1.0,
verbose=True,
)

推荐设置

文件结构

vpn-rotate-skill/
├── SKILL.md # 本文件
├── README.md # 概述
├── scripts/
│ ├── vpn.py # VPN 控制器
│ ├── decorator.py # @withvpnrotation
│ └── setup.sh # 设置向导
├── examples/
│ └── catastro.py # 西班牙房产 API 示例
└── providers/
├── protonvpn.md # ProtonVPN 设置
├── nordvpn.md # NordVPN 设置
└── mullvad.md # Mullvad 设置

故障排除

sudo: a password is required

运行设置脚本或手动添加 sudoers 条目：
bash
echo $USER ALL=(ALL) NOPASSWD: /usr/sbin/openvpn, /usr/bin/killall | sudo tee /etc/sudoers.d/openvpn

连接失败

1. 1. 检查凭据是否正确
2. 手动测试：sudo openvpn --config ~/.vpn/servers/server.ovpn --auth-user-pass ~/.vpn/creds.txt
3. 检查 VPN 提供商账户是否激活

仍然被屏蔽

1. 1. 降低 rotate_every（尝试 5 而不是 10）
2. 增加 delay（尝试 2-3 秒）
3. 检查 API 是否完全屏蔽 VPN IP

没有 .ovpn 文件

从您的 VPN 提供商下载：

• - ProtonVPN：https://protonvpn.com/support/vpn-config-download/
• NordVPN：https://nordvpn.com/ovpn/
• Mullvad：https://mullvad.net/en/account/#/openvpn-config