cURLとSOCKS5プロキシの組み合わせは、HTTPリクエストをトンネルに通す最短の方法です。1行のテストで通った構文は、そのまま本番スクリプトでも動きます。cURLはSOCKS5をネイティブに扱うため、端点の生死を確認するだけなら追加ライブラリは不要です。

つまずくのはフラグではなくDNSです。socks5://とsocks5h://はほぼ同じに見えますが、実位置をリクエストの外に保つのは後者だけです。

cURLをSOCKS5経由にする理由

  • プロトコル非依存。 1本のトンネルでAPI、SMTP、IMAP、SSH、WebSocketを運べます。
  • socks5hのリモートDNS。 プロキシ側が名前解決するため、ISPも対象サイトも実回線のDNSを見ません。
  • 接続ごとの認証。 認証情報はSOCKSハンドシェイク内で交わされ、ヘッダーに残りません。
  • ヘッダーを注入しない。 HTTPプロキシのX-Forwarded-ForやViaを付けず、バイトをそのまま転送します。

最初のリクエスト前の5項目

  1. 方式を選ぶ:公開先はsocks5h、社内ホストのみsocks5。
  2. ホストとポートを確認。1080が定番だが1081や8080のこともある。
  3. 認証情報をエンコードする:@は%40、:は%3A、/は%2F。
  4. --connect-timeout 10と--max-time 60を設定する。
  5. https://api.ipify.orgで出口IPと国を確認する。

フラグの比較

  • -x socks5h://host:port — プロキシ側でDNS解決。既定の選択。
  • -x socks5://host:port — ローカル解決。社内目的のみ。
  • --socks5-hostname host:port — socks5hの長い形式。
  • --preproxy socks5h://… — SOCKS5出口の手前にHTTPプロキシを連結。

4ステップで設定する

  1. 認証情報を環境変数に置き、シェル履歴に残さない。
  2. URLを組み立てる:socks5h://user:p%40ss@host:1080。
  3. curl -sS -x "$PROXY" https://api.ipify.orgで出口IPを検証。
  4. -v付きで実行してハンドシェイクを確認し、リトライを追加。

よくある質問

socks5とsocks5hの違いは?

socks5はローカルで名前解決してIPを送るため実位置が漏れる可能性があります。socks5hはホスト名を渡してプロキシに解決させます。公開先では必ずsocks5hを使います。

tunnelエラーが出るのはなぜ?

多くはポート違い、未エンコード文字、またはsocks5の誤用です。-vでハンドシェイクが止まる位置を見れば特定できます。

フラグを一度設定し、毎回出口IPを確認すれば、cURLのSOCKS5は最も信頼できる1行コマンドになります。端点はFTProxyのレジデンシャルプロキシから。