sc-vpn

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SC-VPN Gateway

Internal VPN service for the Starchild platform. Provides exit nodes in 18 fixed countries — accessible only from within the Starchild internal network. No credentials or setup needed.

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

⚠️ When to Use

⚠️ 使用场景

SC-VPN is a last resort, not a default. Most agent HTTP traffic already goes through

sc-proxy

(the platform's transparent billing proxy for paid APIs). Setting a global VPN proxy will break sc-proxy routing.

Use SC-VPN only when:

A specific request is geo-blocked or returns a region error
You need to appear from a specific country for a particular API call
A target website/API refuses connections from the default exit

Always use per-request proxy (pass

proxies=

requests.get()

-x

curl

). Never set global
HTTP_PROXY
/
HTTPS_PROXY
environment variables

SC-VPN是最后的解决方案，而非默认选项。 大多数Agent的HTTP流量已通过

sc-proxy

（平台针对付费API的透明计费代理）转发。设置全局VPN代理会破坏sc-proxy的路由逻辑。

仅在以下场景使用SC-VPN：

特定请求遭遇地域封锁或返回区域错误
特定API调用需要以特定国家/地区的身份访问
目标网站/API拒绝默认出口IP的连接

始终使用单请求代理（向

requests.get()

传入

proxies=

参数，或向

curl

添加

-x

参数）。切勿设置全局
HTTP_PROXY
/
HTTPS_PROXY
环境变量

Available Countries

可用国家/地区

Country	Code	Example Cities
🇦🇺 Australia	`au`	Adelaide, Sydney, Melbourne
🇨🇭 Switzerland	`ch`	Zürich
🇩🇪 Germany	`de`	Berlin, Frankfurt
🇯🇵 Japan	`jp`	Tokyo, Osaka
🇲🇾 Malaysia	`my`	Kuala Lumpur
🇲🇽 Mexico	`mx`	Querétaro
🇹🇭 Thailand	`th`	Bangkok
🇿🇦 South Africa	`za`	Johannesburg
🇧🇷 Brazil	`br`	São Paulo, Fortaleza
🇦🇷 Argentina	`ar`	Buenos Aires
🇸🇬 Singapore	`sg`	Singapore
🇭🇰 Hong Kong	`hk`	Hong Kong
🇬🇧 United Kingdom	`gb`	London, Manchester
🇳🇱 Netherlands	`nl`	Amsterdam
🇫🇷 France	`fr`	Paris, Marseille
🇸🇪 Sweden	`se`	Stockholm, Malmö
🇪🇸 Spain	`es`	Madrid
🇮🇹 Italy	`it`	Milan, Rome

Only these 18 countries. Requests for other regions are rejected (502). The specific server per country is auto-selected daily based on latency.

国家/地区	代码	示例城市
🇦🇺 澳大利亚	`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错误）。每个国家/地区的具体服务器会根据延迟每日自动选择。

Quick Start

快速开始

curl (per-request proxy)

curl（单请求代理）

bash

undefined

bash

undefined

Route ONE request through Japan

通过日本节点转发单个请求

curl -x "http://jp:x@sc-vpn.internal:8080" https://ifconfig.me

Route ONE request through Brazil

通过巴西节点转发单个请求

curl -x "http://br:x@sc-vpn.internal:8080" https://example.com/api

undefined

curl -x "http://br:x@sc-vpn.internal:8080" https://example.com/api

undefined

Python requests (per-request proxy)

Python requests（单请求代理）

python

import requests

def vpn_proxy(region: str) -> dict:
    """Return proxy dict for a given region code."""
    return {
        "https": f"http://{region}:x@sc-vpn.internal:8080",
        "http":  f"http://{region}:x@sc-vpn.internal:8080",
    }

python

import requests

def vpn_proxy(region: str) -> dict:
    """Return proxy dict for a given region code."""
    return {
        "https": f"http://{region}:x@sc-vpn.internal:8080",
        "http":  f"http://{region}:x@sc-vpn.internal:8080",
    }

Only the geo-blocked request goes through VPN

仅受地域限制的请求通过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)

其他所有请求通过常规sc-proxy路由（无需传入proxies=参数）

resp2 = requests.get("https://api.coingecko.com/...")

undefined

resp2 = requests.get("https://api.coingecko.com/...")

undefined

❌ Do NOT do this

❌ 禁止操作

bash

undefined

bash

undefined

WRONG — may influence other requests

错误做法——可能影响其他请求

export HTTP_PROXY="http://jp:x@sc-vpn.internal:8080" export HTTPS_PROXY="http://jp:x@sc-vpn.internal:8080"

undefined

export HTTP_PROXY="http://jp:x@sc-vpn.internal:8080" export HTTPS_PROXY="http://jp:x@sc-vpn.internal:8080"

undefined

Region Selection

区域选择

The username in the proxy URL selects the exit country:

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

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

输入值	对应区域
`jp` 或 `japan`	日本
`au` 或 `australia`	澳大利亚
`de` 或 `germany`	德国
`ch` 或 `switzerland`	瑞士
`th` 或 `thailand`	泰国
`br` 或 `brazil`	巴西
`ar` 或 `argentina`	阿根廷
`mx` 或 `mexico`	墨西哥
`my` 或 `malaysia`	马来西亚
`za` 或 `south_africa`	南非
`sg` 或 `singapore`	新加坡
`hk` 或 `hong_kong`	中国香港
`gb` 或 `uk` 或 `united_kingdom`	英国
`nl` 或 `netherlands`	荷兰
`fr` 或 `france`	法国
`se` 或 `sweden`	瑞典
`es` 或 `spain`	西班牙
`it` 或 `italy`	意大利

REST API

Base URL:

http://sc-vpn.internal:8081

Endpoint	Description
`GET /api/tunnels`	Status of all 18 tunnels (region, latency, uptime)
`GET /api/status`	Gateway overview
`GET /api/usage`	Your traffic stats (identified by source IP)
`GET /health`	Health check

基础URL：

http://sc-vpn.internal:8081

端点	描述
`GET /api/tunnels`	查看全部18个隧道的状态（区域、延迟、在线时长）
`GET /api/status`	网关概览信息
`GET /api/usage`	你的流量统计（通过源IP识别）
`GET /health`	健康检查

Rate Limits

速率限制

Limit	Default
Monthly quota per client	500 GB
Max concurrent connections	50
Requests per second	100

Clients identified by source IP. No API keys needed — internal network only.

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

客户端通过源IP识别，无需API密钥——仅内部网络可访问。

Verify It Works

验证有效性

bash

undefined

bash

undefined

Your real exit IP

你的真实出口IP

curl https://ifconfig.me

VPN exit IP (should be different, from Japan)

VPN出口IP（应与真实IP不同，来自日本）

curl -x "http://jp:x@sc-vpn.internal:8080" https://ifconfig.me

undefined

curl -x "http://jp:x@sc-vpn.internal:8080" https://ifconfig.me

undefined

Troubleshooting

故障排查

Problem	Fix
`502 Bad Gateway: Unknown region`	Use one of: au, ch, de, jp, my, mx, th, za, br, ar, sg, hk, gb, nl, fr, se, es, it
`502 Bad Gateway: Tunnel not active`	Gateway may need restart — check `/api/status`
`400 Bad Request: No region specified`	Add username to proxy URL: `http://jp:x@sc-vpn.internal:8080`
DNS failure for `sc-vpn.internal`	Only accessible from Starchild internal network
Other requests broken after using VPN	You set global `HTTP_PROXY` — unset it immediately

问题	解决方法
`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:x@sc-vpn.internal:8080`
`sc-vpn.internal` 解析失败	该服务仅可从Starchild内部网络访问
使用VPN后其他请求异常	你设置了全局 `HTTP_PROXY` ——立即取消设置