私人 VPN 一键管理，通用 Agent 自动化技能
Manage your private VPN infrastructure with agent automation.
VpnLine 是一个 Agent Skill（通用智能体技能），用于管理个人 VPN 基础设施。当你在任意支持 Agent Skills 的智能体（Claude Code、DeepSeek Harness、Cursor、Windsurf、Codex 等）中提到 VPN 相关操作时，技能自动加载并执行对应任务。
支持 macOS、iPhone、Android 多平台，双线路冗余架构，本地代理自动切换。
┌──────────────────────────────────────────────┐
│ Agent（Claude Code / DSH 等） │
│ 用户提到 VPN 相关操作时 │
│ 自动加载 VpnLine Skill │
└──────────────────┬───────────────────────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
┌────────┐ ┌──────────┐ ┌──────────┐
│ macOS │ │ iPhone/ │ │ Android │
│ ss-local│ │ iPad │ │ SS App │
└────┬───┘ └────┬─────┘ └────┬─────┘
│ │ │
└───────────┼──────────────┘
│ SOCKS5 / IKEv2
▼
┌────────────────────────┐
│ DigitalOcean SFO3 │
│ Ubuntu 22.04 LTS │
│ ┌──────────────────┐ │
│ │ Shadowsocks:8388 │ │ ← 主线路
│ │ IPsec/L2TP+IKEv2 │ │ ← 备用
│ └──────────────────┘ │
└────────────────────────┘
- 多 Agent 兼容 — 标准 Agent Skills 格式（SKILL.md），Claude Code / DSH / Cursor / Windsurf 等开箱即用
- 双线路冗余 — Shadowsocks 主线路 + IKEv2 备用线路
- 多平台支持 — macOS 菜单栏开关 / iPhone Shadowrocket / Android SS 客户端
- 本地代理自动切换 — VPN 连断时代理环境变量自动设置/清除，零手动操作
- 一键运维 — 服务状态检查、重启、防火墙管理
- 新设备配置 — 自动生成客户端配置文件
| 线路 | 协议 | 端口 | 用途 | 优势 |
|---|---|---|---|---|
| 主线路 | Shadowsocks | 8388 | SOCKS5 代理 | 轻量、易配置、全平台支持 |
| 备用线路 | IPsec/L2TP + IKEv2 | 500/4500 | 全隧道 VPN | 原生系统支持、稳定性好 |
桌面已有 US VPN.app，点击即可连接/断开。
或终端启动：
/opt/homebrew/opt/shadowsocks-libev/bin/ss-local -c /opt/homebrew/etc/shadowsocks-libev.json- App Store 下载 Shadowrocket（付费）或 Outline（免费）
- 扫描
ss://二维码或手动输入配置 - 开启连接
- 下载 Shadowsocks for Android
- 扫描二维码或手动配置
- 开启连接
服务器上已有导出的配置文件：
/root/vpnclient.mobileconfig # iOS/macOS
/root/vpnclient.sswan # Android StrongSwan
/root/vpnclient.p12 # 证书文件
重新导出：
ssh root@server "sudo ikev2.sh --exportclient <name>"git clone https://github.com/iTrimut/VpnLine.git
cd VpnLine
bash install.sh # 自动检测当前智能体并安装（项目级）
bash install.sh --user # 用户级安装（所有项目可用；DSH 固定用户级）
bash install.sh --agent claude # 也可用 --agent 指定智能体支持自动检测：Claude Code、DeepSeek Harness (DSH)、Cursor、Windsurf、GitHub Copilot、OpenCode、Codex。
也可以把技能目录（SKILL.md、references/）复制到所用智能体的 skills 目录，目录名取 upup-vpn：
| 智能体 | 安装路径 |
|---|---|
| Claude Code | .claude/skills/upup-vpn/ |
| DeepSeek Harness (DSH) | ~/.dsh/skills/upup-vpn/（用户级全局） |
| Cursor | .cursor/skills/upup-vpn/ |
| Windsurf | .windsurf/skills/upup-vpn/ |
| GitHub Copilot | .github/skills/upup-vpn/ |
| OpenCode / Codex | .opencode/skills/upup-vpn/ / .codex/skills/upup-vpn/ |
以 Claude Code 为例：
cd your-project
git clone https://github.com/iTrimut/VpnLine.git .claude/skills/upup-vpn在任意上述智能体中输入 VPN 相关关键词（如"连接 VPN"），确认 Skill 自动加载。
references/credentials.md 是已入库的非敏感模板（服务器 IP、端口、协议等）。
真实密码 / token 统一存放在本机 ~/.vpnline/upup.secrets.json（不在仓库里）：
mkdir -p ~/.vpnline
# 从 Mac 的 /opt/homebrew/etc/shadowsocks-libev.json 复制 SS 密码填入
# 字段说明见 ~/.vpnline/README.md智能体每次处理 VPN 任务时自动读取该文件；.vpnline 目录请勿放进任何 git 仓库。
~/.zshrc 中配置了 zsh precmd hook，VPN 连断时代理环境变量自动切换：
| 状态 | 行为 |
|---|---|
| VPN 连接中（端口 1080 通） | 自动设置 ALL_PROXY、HTTPS_PROXY、NO_PROXY |
| VPN 断开（端口 1080 不通） | 自动清除所有代理变量 |
国内域名直连：*.xiaomi.com、*.qq.com、*.wechat.com 等。
ssh -i ~/.ssh/id_ed25519 root@<SERVER_IP> \
"systemctl status ipsec shadowsocks-libev --no-pager | grep Active"ssh -i ~/.ssh/id_ed25519 root@<SERVER_IP> \
"systemctl restart ipsec shadowsocks-libev"| 端口 | 协议 | 用途 |
|---|---|---|
| 22 | TCP | SSH |
| 500 | UDP | IKEv2 |
| 4500 | UDP | NAT-T |
| 8388 | TCP/UDP | Shadowsocks |
VPN, 连接, 断开, Shadowsocks, SS, 代理, proxy,
翻墙, 科学上网, DigitalOcean, droplet, 服务器迁移,
ss-local, IKEv2, L2TP, 新设备配置, 检查/更换 IP 位置
❓ Q: macOS 26.5 安装 mobileconfig 后 VPN 服务不显示？ A: 使用 Shadowsocks 客户端替代，或检查系统偏好设置 → VPN。
❓ Q: AppleScript .app 提示"未验证的开发者"？ A: 右键点击 → 打开，或系统设置 → 隐私与安全性 → 仍要打开。
❓ Q: ss-local 断连怎么办？
A: 重启 ss-local 或使用脚本重连：/Users/xiaan/Documents/VPNTool/ss_vpn.sh
VpnLine/
├── README.md # 项目说明（本文件）
├── README_EN.md # English version
├── SKILL.md # Agent Skill 主文件（标准格式）
├── LICENSE # MIT License
├── install.sh # 一键安装脚本（多智能体自动检测）
└── references/
└── credentials.md # 服务器配置模板（真实密码仅本地保存）
欢迎提交 Issue 和 Pull Request。
私人 VPN，安全上网