この記事の概要

接続情報を持っている場合は、まずリンクのプレフィックスを確認してください。4種類のプロトコル共有リンクは、それぞれ1台分のサーバー設定を表します。一方、HTTPまたはHTTPSのサブスクリプションURLは、Shadowrocketがリモートのリストを取得するためのものです。以下では例を使って各項目とエンコードを説明し、iPhone / iPadのHomeとAdd Serverでの追加・更新方法、解析エラーと接続エラーの見分け方を紹介します。

リンクのプレフィックスで確認:1台分のサーバー設定か、サブスクリプションURLか

ss://、vmess://、vless://、trojan://のプレフィックスはプロトコルを示し、その後ろには接続に必要なパラメータが含まれます。インポートすると、これらのパラメータが端末に保存されます。元の設定でアドレス、ポート、認証情報が変更されても、保存済みの設定には反映されません。

サブスクリプションURLは通常、https://example.com/sub?token=xxxxのようなHTTPまたはHTTPSのURLです。これは取得するリストを指すもので、リスト内の特定サーバーのアドレスではありません。ブラウザーで開けるHTTPS URLでも、必ずサブスクリプションとは限りません。ログインページ、エラーページ、互換性のない応答はサーバーリストとして解析できません。

4種類
この記事で扱うプロトコル共有リンクのプレフィックス
1件
各プロトコル共有リンクが示すサーバー設定
2種類
ここで区別する認証情報:1件分の接続情報とサブスクリプション取得用の認証情報

4種類の共有リンクに含まれる項目とエンコード

以下のリンクは、形式を説明するためのサンプルホストとサンプル認証情報を使用しています。サンプルのポート8388と443は、クライアントの必須設定ではありません。実際の設定では、既存の構成に記載されたポート、通信方式、安全性に関するパラメータを維持してください。

Shadowsocks:ss://のBase64URLユーザー情報

ss://[email protected]:8388#SS-demo

このSIP002形式のリンクでは、@より前の部分がaes-128-gcm:testをパディングなしでBase64URLエンコードしたものです。デコードすると、コロンの左側が暗号化方式、右側がパスワードです。@より後ろはホストとポート、#より後ろは名前です。指定された項目だけをエンコードし、リンク全体をさらにBase64で包まないでください。プラグインパラメータが含まれるリンクや異なる形式のリンクは、元の文字列を維持し、この短い例に合わせて項目を削除しないでください。

VMess:vmess://の後ろにはBase64エンコードされたJSONが使われることが多い

{
  "ps": "VMess-demo",
  "add": "vmess.example.com",
  "port": "443",
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "aid": "0",
  "net": "ws",
  "host": "vmess.example.com",
  "path": "/ws",
  "tls": "tls"
}

ここに示すのは、よく使われるVMess共有形式をデコードした内容で、リンクとしてそのまま貼り付けるものではありません。psは名前、addとportは接続先アドレスとポート、idはUUIDです。この例はWebSocketを使用しており、net、host、path、tlsはそれぞれ通信方式、WebSocket Host、パス、TLS設定を表します。アドレス、ポート、UUIDだけをコピーしても、設定全体は再現できません。

VLESS:vless://はUUIDとクエリパラメータを使用

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=vless.example.com&path=%2Fws&sni=vless.example.com#VLESS-demo

@より前はUUID、?より後ろは接続オプションです。ここではtype=wsがWebSocketを示し、path=%2Fwsをデコードすると/wsになります。sniはTLSハンドシェイクで使用するサーバー名を指定します。例ではencryption=noneとsecurity=tlsを併用していますが、これらは異なる階層の設定です。noneを見てTLSを無効にしないでください。例ではホストアドレス、WebSocket Host、SNIが同じですが、実際の設定では異なる場合があります。

Trojan:trojan://はUUIDではなくパスワードを使用

trojan://demo%[email protected]:443?security=tls&type=tcp&sni=trojan.example.com#Trojan-demo

例のパスワードはdemo@passです。認証情報内の@は、後ろに続くアドレスとの区切りと混同しないよう%40と記述します。同様に、項目の値として使う#を名前の区切りとして直接記述することはできません。問題を調べる際はデコード後の項目を照合できますが、インポートには元のURIを使用してください。リンク全体をデコードしてから貼り付けると、項目の境界が変わる可能性があります。

Homeで追加方法を選ぶ

サブスクリプションURLから追加(Type → Subscribe)

おすすめ

iPhone / iPadでHomeを開き、右上の+をタップしてAdd Serverに進み、TypeでSubscribeを選びます。完全なURLをURL欄に貼り付けて保存し、Homeに戻ってサブスクリプショングループとその中の項目を確認します。URLにクエリパラメータが含まれる場合は、それも含めてコピーしてください。

向いているケース:サブスクリプションURLを持っていて、配信元の更新に合わせて同じサーバーリストを更新したい場合。

プロトコル共有リンクから追加

共有リンク全体をコピーしてからShadowrocketを開きます。クリップボードからのインポート確認が表示されたら承認し、Homeで追加された設定を確認してください。同じ設定のQRコードがある場合は、Homeのスキャン機能を使えます。インポートの確認が表示されない場合は、クリップボードに完全なURIが1件だけ入っているか、ペーストが許可されているかを確認してください。

向いているケース:特定のサーバー設定を1件だけ保存したい場合、またはプロトコル共有リンクだけを持っている場合。

インポート前に元の文字列を保存

2種類のURLを受け取った場合は、それぞれ保存してください。プロトコルURIは1件分の設定の照合に、サブスクリプションURLはリストの更新に使います。改行や末尾の句読点がある場合は、元の配信元からコピーし直してください。パラメータを手作業で並べ替えたり、URI内のパスワードやUUID、サブスクリプションURL内のtokenを公開したりしないでください。Base64はエンコード方式であり、認証情報を隠すものではありません。

サブスクリプションの更新、ルールによる振り分け、接続テストは分けて確認

サブスクリプションの更新では、同じURLに再度アクセスして応答を解析します。共有リンクから個別にインポートした同名の設定は置き換わりません。反対に、直接インポートした設定が一時的に使えても、古いサブスクリプションURLが有効だとは限りません。配信元で設定が更新された可能性がある場合は、古い項目のアドレス、ポート、通信方式を控えて新しいリストと照合してください。名前だけで比較しないようにしましょう。

  1. まずリストを更新:Homeで元のサブスクリプショングループを更新し、項目が取得できるか確認します。配信元でアドレスやtokenが変更されている場合は、保存済みのURLを更新してください。古いURLに繰り返しアクセスしても、新しいリストは取得できません。
  2. 次に選択中の設定を確認:リストが表示されたら、使う項目を選択し、ポート、認証情報、TLS、SNI、通信パスを確認します。インポートできたことが示すのは項目を解析できたということだけで、サーバーに接続できることや認証情報が有効であることを保証しません。
  3. 最後にルールを確認:接続は確立しているのに特定のリクエストが想定した経路を通らない場合は、HomeのGlobal Routingを確認します。Configを使用している場合は、Configで有効なルールとその順序を確認してください。サーバー設定を1件インポートしても、ルールは変更されません。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

このルール設定では、example.comとそのサブドメインへのリクエストにPROXYを使用し、それ以外の一致しないリクエストはFINAL,DIRECTで処理します。そのため、別のドメインでテストして直接接続になっても、共有リンクのインポート失敗とは限りません。

よくある質問:解析エラー、空のリスト、同名の設定

vmess://をコピーしたのに、インポート時に形式エラーが出るのはなぜですか?

元のテキストからコピーし直し、プレフィックスが欠けていないか、末尾に句点、引用符、メッセージ中の省略記号が付いていないか確認してください。画面上の折り返しなのか、実際に改行が入っているのかも見分けます。まず「=」を削除したり、文字を置き換えたりしないでください。リンクの種類によってエンコード形式が異なる場合があります。

サブスクリプションURLを開けるのに、Homeに項目が表示されないのはなぜですか?

取得したものがサブスクリプションURLであり、アカウントページやダウンロード案内ページではないことを確認します。既存の配信元から401または403が返る場合は、tokenと取得権限を確認してください。200が返っても、内容がログインページや互換性のないリストであることがあります。応答形式は元の配信元に確認し、完全なURLを第三者の解析サイトに送信しないでください。

更新後に同名の項目が2つ表示された場合、どちらを選べばよいですか?

項目が更新したばかりのサブスクリプショングループ内にあるかを確認してから、詳細を開いてホスト、ポート、通信方式を照合します。もう一方が以前に単独でインポートした設定なら、今回の更新では変更されていません。新しい項目が使えることを確認してから、古い項目を削除するか判断してください。

名前は変更できるのに、pathやsniを同じように変更できないのはなぜですか?

名前は設定を見分けるためのものですが、pathとsniは接続に使われます。インポート後にTLSハンドシェイクが失敗した場合は、元の設定と項目ごとに照合してください。名前に使われているドメインでSNIを置き換えたり、テストのために証明書の検証を無効にしたりしないでください。

Shadowrocketを入手

iPhone / iPad版はApp Storeから入手でき、価格は2.99米ドルの買い切りです。システム要件はApp Storeの掲載内容をご確認ください。Mac(Appleシリコン / Intel)、Windows、Android、Linux版は無料で、本サイトからインストーラーを入手できます。本サイトではサーバーやサブスクリプションの提供・販売・推奨は行っていません。