sc-vpn

SC-VPN ゲートウェイ

Starchild プラットフォーム向けの内部 VPN サービスです。18 の固定された国に出口ノードを提供します — Starchild 内部ネットワーク内からのみアクセス可能です。認証情報やセットアップは不要です。

⚠️ 使用すべき場面

SC-VPN は最後の手段であり、デフォルトではありません。 ほとんどのエージェントの HTTP トラフィックはすでに sc-proxy(有料 API 向けのプラットフォームの透過的な課金プロキシ)を経由しています。グローバル VPN プロキシを設定すると sc-proxy のルーティングが壊れます。

SC-VPN は次の場合のみ使用してください:

• 特定のリクエストが地理的にブロックされている、またはリージョンエラーを返す
• 特定の API 呼び出しで特定の国からアクセスしているように見せる必要がある
• 対象のウェブサイト/API がデフォルトの出口からの接続を拒否する

常にリクエスト単位のプロキシを使用してください(requests.get() に proxies= を渡す、または curl に -x を渡す)。グローバルな HTTP_PROXY / HTTPS_PROXY 環境変数を設定しないでください

利用可能な国

国	コード	都市の例
🇦🇺 オーストラリア	au	アデレード、シドニー、メルボルン
🇨🇭 スイス	ch	チューリッヒ
🇩🇪 ドイツ	de	ベルリン、フランクフルト
🇯🇵 日本	jp	東京、大阪
🇲🇾 マレーシア	my	クアラルンプール
🇲🇽 メキシコ	mx	ケレタロ
🇹🇭 タイ	th	バンコク
🇿🇦 南アフリカ	za	ヨハネスブルグ
🇧🇷 ブラジル	br	サンパウロ、フォルタレザ
🇦🇷 アルゼンチン	ar	ブエノスアイレス
🇸🇬 シンガポール	sg	シンガポール
🇭🇰 香港	hk	香港
🇬🇧 イギリス	gb	ロンドン、マンチェスター
🇳🇱 オランダ	nl	アムステルダム
🇫🇷 フランス	fr	パリ、マルセイユ
🇸🇪 スウェーデン	se	ストックホルム、マルメ
🇪🇸 スペイン	es	マドリード
🇮🇹 イタリア	it	ミラノ、ローマ

これらの 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	日本
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

ベース URL: http://sc-vpn.internal:8081

エンドポイント	説明
GET /api/tunnels	18 すべてのトンネルのステータス(リージョン、レイテンシ、稼働時間)
GET /api/status	ゲートウェイの概要
GET /api/usage	あなたのトラフィック統計(送信元 IP で識別)
GET /health	ヘルスチェック

レート制限

制限	デフォルト
クライアントごとの月間クォータ	500 GB
最大同時接続数	50
1 秒あたりのリクエスト数	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 を設定しています — 直ちに解除してください