sc-vpn

SC-VPN Gateway

Starchild 平台的内部 VPN 服务。提供 18 个固定国家/地区的出口节点——仅可从 Starchild 内部网络访问。无需凭据或设置。

⚠️ 何时使用

SC-VPN 是最后的手段，而不是默认选项。 大多数 Agent 的 HTTP 流量已通过 sc-proxy（平台用于付费 API 的透明计费代理）。设置全局 VPN 代理会 破坏 sc-proxy 的路由。

仅在以下情况下使用 SC-VPN：

• 特定请求遭到 地理位置屏蔽或返回区域错误
• 你需要在某个特定 API 调用中显示来自 特定国家/地区
• 目标网站/API 拒绝来自默认出口的连接

始终使用单请求代理（向 requests.get() 传入 proxies=，或向 curl 传入 -x）。切勿设置全局 HTTP_PROXY / HTTPS_PROXY 环境变量

可用国家/地区

国家/地区	代码	示例城市
🇦🇺 澳大利亚	au	Adelaide、Sydney、Melbourne
🇨🇭 瑞士	ch	Zürich
🇩🇪 德国	de	Berlin、Frankfurt
🇯🇵 日本	jp	Tokyo、Osaka
🇲🇾 马来西亚	my	Kuala Lumpur
🇲🇽 墨西哥	mx	Querétaro
🇹🇭 泰国	th	Bangkok
🇿🇦 南非	za	Johannesburg
🇧🇷 巴西	br	São Paulo、Fortaleza
🇦🇷 阿根廷	ar	Buenos Aires
🇸🇬 新加坡	sg	Singapore
🇭🇰 香港	hk	Hong Kong
🇬🇧 英国	gb	London、Manchester
🇳🇱 荷兰	nl	Amsterdam
🇫🇷 法国	fr	Paris、Marseille
🇸🇪 瑞典	se	Stockholm、Malmö
🇪🇸 西班牙	es	Madrid
🇮🇹 意大利	it	Milan、Rome

仅支持这 18 个国家/地区。 其他地区的请求会被拒绝（502）。每个国家/地区使用的具体服务器会根据延迟每天自动选择。

快速开始

curl（单请求代理）

# Route ONE request through Japan
curl -x "http://jp:[email protected]:8080" https://ifconfig.me

# Route ONE request through Brazil
curl -x "http://br:[email protected]:8080" https://example.com/api

Python requests（单请求代理）

import requests

def vpn_proxy(region: str) -> dict:
    """Return proxy dict for a given region code."""
    return {
        "https": f"http://{region}:[email protected]:8080",
        "http":  f"http://{region}:[email protected]:8080",
    }

# Only the geo-blocked request goes through VPN
resp = requests.get("https://geo-restricted-api.example.com", proxies=vpn_proxy("jp"))

# All other requests go through normal sc-proxy routing (no proxies= arg)
resp2 = requests.get("https://api.coingecko.com/...")

❌ 请勿这样做

# WRONG — may influence other requests
export HTTP_PROXY="http://jp:[email protected]:8080"
export HTTPS_PROXY="http://jp:[email protected]:8080"

区域选择

代理 URL 中的 用户名用于选择出口国家/地区：

输入	解析为
jp 或 japan	Japan
au 或 australia	Australia
de 或 germany	Germany
ch 或 switzerland	Switzerland
th 或 thailand	Thailand
br 或 brazil	Brazil
ar 或 argentina	Argentina
mx 或 mexico	Mexico
my 或 malaysia	Malaysia
za 或 south_africa	South Africa
sg 或 singapore	Singapore
hk 或 hong_kong	Hong Kong
gb 或 uk 或 united_kingdom	United Kingdom
nl 或 netherlands	Netherlands
fr 或 france	France
se 或 sweden	Sweden
es 或 spain	Spain
it 或 italy	Italy

REST API

基础 URL：http://sc-vpn.internal:8081

端点	说明
GET /api/tunnels	所有 18 条隧道的状态（区域、延迟、运行时间）
GET /api/status	网关概览
GET /api/usage	你的流量统计（根据源 IP 识别）
GET /health	健康检查

速率限制

限制	默认值
每个客户端的月度配额	500 GB
最大并发连接数	50
每秒请求数	100

客户端根据源 IP 识别。无需 API 密钥——仅限内部网络访问。

验证是否正常工作

# Your real exit IP
curl https://ifconfig.me

# VPN exit IP (should be different, from Japan)
curl -x "http://jp:[email protected]:8080" https://ifconfig.me

故障排除

问题	解决方法
502 Bad Gateway: Unknown region	使用以下代码之一：au、ch、de、jp、my、mx、th、za、br、ar、sg、hk、gb、nl、fr、se、es、it
502 Bad Gateway: Tunnel not active	网关可能需要重启——检查 /api/status
400 Bad Request: No region specified	在代理 URL 中添加用户名：http://jp:[email protected]:8080
sc-vpn.internal 的 DNS 解析失败	仅可从 Starchild 内部网络访问
使用 VPN 后其他请求异常	你设置了全局 HTTP_PROXY——立即取消设置