BLOG

VPN SOCKS5

2026/05/01 2 min read BLOG 编程学习之路 VPN SOCKS5

sub2api 添加代理 必须的 4 个步骤(最简版)

步骤 1:准备一个 可用的 SOCKS5 代理

必须是这种格式:

plaintext

socks5://ip:端口

例如:

plaintext

socks5://172.18.0.1:1080

必须满足:

  • sub2api 能访问到这个 IP
  • 端口没被防火墙拦
  • 代理不需要账号密码(或你要填账号密码)

步骤 2:拿到 sub2api 管理员 Token(JWT)

你必须有管理员权限才能添加代理。

获取命令:

bash

运行

docker exec sub2api printenv JWT

会输出一串很长的 token,复制下来。


步骤 3:用 API 添加代理到 sub2api

执行这条命令(把内容替换成你的):

bash

运行

TOKEN="你的管理员JWT"

curl -X POST http://127.0.0.1:8080/api/v1/admin/proxies \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "HK-170",
    "type": "socks5",
    "host": "172.18.0.1",
    "port": 1080,
    "username": "",
    "password": "",
    "country": "US",
    "weight": 100,
    "is_active": true
  }'

必须填写的字段(缺一不可)

  • typesocks5
  • host:代理 IP
  • port:代理端口
  • country:国家代码(US/HK/SG)
  • is_active: true(启用)

步骤 4:验证代理是否添加成功

bash

运行

curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8080/api/v1/admin/proxies

看到你的代理 = 成功


超级简化总结(你只要记这个)

  1. 有 socks5 代理
  2. 拿到 sub2api 的 JWT 管理员 token
  3. 用 POST 调用 /api/v1/admin/proxies 添加
  4. 开启 is_active: true