まず、リンクにサーバー設定が含まれているのか、サーバー一覧を取得するためのURLなのかを見分けてから、適切な方法でインポートします。サービス提供元から入手したリンクをお持ちで、Shadowrocketへのインポート結果を確認したい方に向けて、4種類のURIの見分け方、サブスクリプションの登録場所、フィールドごとのインポート・更新失敗の確認方法を説明します。以下はiPhone/iPadの画面を基準にしています。ほかのプラットフォームでは実際の画面に合わせてください。
まず接頭辞を確認:単一サーバーURIとサブスクリプションURLの違い
ss://、vmess://、vless://、trojan://は通常、1件のサーバー設定に必要な情報を含みます。リンク全体をコピーすると、クライアントがアドレス、ポート、認証情報、通信設定をローカルで解析します。設定が解析できても接続成功を意味するわけではなく、サーバーが現在利用可能であることも保証されません。
サブスクリプションURLは通常、https://で始まるアドレスです。ShadowrocketがそのURLにアクセスして応答内容を読み取り、サーバー一覧を作成または更新します。URLにはアクセストークンが含まれる場合があり、一般公開のWebページやプロキシプロトコルとは異なります。https://で始まるというだけではサブスクリプションとは判断できません。用途と応答形式を確認してください。
結論:内容を見分けてからインポート方法を選ぶ
プロトコルの接頭辞があれば、単一サーバーの設定情報として扱います。サービス提供元がサブスクリプションURLとして明示している場合は、Subscribeを使います。サブスクリプションURLのドメインを単一サーバーのAddressに入力したり、プロトコルURI全体をサブスクリプションの取得先として扱ったりしないでください。
ss://:認証情報がBase64でエンコードされている場合がある
ss://はShadowsocksの共有リンクに使われます。一般的なSIP002形式では、暗号化方式とパスワードをユーザー情報として記述し、その後にサーバーアドレスとポートを続けます。ユーザー情報には通常、URL-safe Base64が使われます。古い形式では「認証情報・アドレス・ポート」全体がBase64でエンコードされている場合もあります。そのため、サーバーのドメイン名がそのまま見えるかどうかで、リンクが完全かどうかを判断することはできません。
| 構成要素 | 確認方法 |
|---|---|
ss:// | Shadowsocksの共有リンク形式を示します。サブスクリプションの更新URLではありません。 |
| ユーザー情報 | デコードすると、通常は暗号化方式、コロン、パスワードが含まれます。Base64自体に機密性を保護する機能はありません。 |
| サーバーとポート | 例:説明用アドレスのnode.example.com:8388。8388は例であり、固定ポートではありません。 |
?plugin= | 省略可能なプラグイン設定です。クライアントが任意のプラグインに対応しているとは限らないため、インポートのために安易に削除しないでください。 |
#以降 | 通常はメモ名です。空白やASCII以外の文字を含む場合、パーセントエンコードされていることがあります。 |
インポート後、Homeで該当レコードの編集画面を開き、Type、Address、Port、暗号化方式、Passwordを重点的に確認します。暗号化方式とパスワードはそれぞれ対応する項目に入力してください。Base64の文字列全体をPasswordに入力してはいけません。元のリンクの文字が欠けている場合は、エンコードの見た目から推測して補わず、リンクを再コピーしてください。
vmess://:JSONのBase64形式とその他の共有形式を見分ける
一般的なvmess://共有リンクは、「接頭辞+Base64でエンコードされたJSON」の形式です。デコードしたJSONには通常、add、port、id、net、tlsなどのフィールドが含まれます。生成元によって異なる形式が使われることがあるため、すべてのVMess共有リンクが同じ外部構造とは限りません。
以下はフィールドの意味を確認するためのJSON例です。利用可能なサーバー情報ではなく、そのまま貼り付けてインポートできる完全なリンクでもありません。ドメインは例示用で、UUIDはすべてゼロのデモ値です。接続に使用できるのは、実際のサービス設定にある値だけです。
{
"v": "2",
"ps": "Example",
"add": "node.example.com",
"port": "443",
"id": "00000000-0000-0000-0000-000000000000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/demo",
"tls": "tls",
"sni": "edge.example.com"
}
addとportは接続先を示します。443はTLSでよく使われるポートですが、ポート番号だけではTLSが有効かどうかは判断できません。idはUUID形式の認証情報です。サブスクリプションURL内のtokenで代用することはできません。netがwsの場合は、WebSocketのHostとPathも確認してください。アドレスとポートだけでは不十分です。tlsはTLSの有効・無効、sniはハンドシェイク時に使うサーバー名に関係します。Host、SNI、接続先アドレスは異なる場合があります。
名前を解析できても接続に失敗する場合、名前の誤りではなく通信設定の不足が原因であることがよくあります。Addressが正しいからといってHost、Path、TLSを確認しないままにしないでください。元の設定を確認できない場合は、wsを別の通信方式に安易に変更しないでください。
vless://とtrojan://:見た目は似ていても認証フィールドが異なる
どちらも、ユーザー情報、アドレス、ポート、クエリパラメーターを含むURI形式がよく使われます。VLESSのユーザー情報は通常UUID、Trojanは通常パスワードです。接頭辞だけを書き換えて相互変換することはできません。以下の2行は構造の例にすぎず、例示ドメイン、全ゼロのUUID、デモ用パスワードは接続には使えません。
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#Example
trojan://[email protected]:443?security=tls&type=tcp&sni=edge.example.com#Example
| フィールド | 意味と確認ポイント |
|---|---|
@より前 | VLESSでは通常UUID、Trojanでは通常パスワードです。特殊文字はURIの規則に従ってエンコードする必要があります。 |
security=tls | TLS関連の設定を示します。実際のサービス設定と一致しているか確認してください。ポート番号だけから推測することはできません。 |
type=ws / type=tcp | 通信方式を示します。方式によって確認が必要な追加フィールドは異なります。 |
sni | TLSハンドシェイクで使うサーバー名です。サービス設定と証明書の検証要件に一致している必要があります。 |
host / path | WebSocketの設定でよく使われます。%2Fdemoをデコードすると/demoになります。 |
encryption=noneはVLESSプロトコル自体の暗号化フィールドを表し、接続全体が必ず暗号化されていないという意味ではありません。TLSを使うかどうかは別途確認してください。Trojanは通常TLSを利用します。証明書エラーが発生した場合は、端末の時刻、SNI、証明書を確認してください。証明書検証を無効にすることは、通常の対処方法ではありません。
拡張パラメーターへの対応状況は、パーサーによって異なる場合があります。共有リンクにこの記事で触れていないパラメーターが含まれている場合は、元の内容を保持して編集画面を確認してください。インポートが成功しても、すべての拡張パラメーターが反映されたとは限りません。
QRコード・クリップボード・Subscribe:リンクの種類に合わせて操作
QRコードはテキストを別の形で保存したものです。単一サーバーURIもサブスクリプションURLもQRコードにできますが、スキャンしただけで単一サーバーのリンクが更新可能なサブスクリプションに変わるわけではありません。まず提供元の説明を確認し、読み取った内容もチェックしてください。
Subscribe:サブスクリプションの更新設定を維持する
おすすめサブスクリプションを利用中で、今後も更新する場合は、Home → + → TypeでSubscribeを選択し、画面の項目に従ってサブスクリプションURLを入力して保存します。初回の取得が完了したら、作成されたレコードとサブスクリプショングループを確認してください。
適したケース:サーバー一覧を継続して同期するため、サブスクリプションURLであることを確認済みの場合
クリップボードからインポート:URI全体を解析
プロトコルの接頭辞から末尾のメモまで、リンク全体をコピーしてHomeに戻ります。クリップボードへのアクセスやインポートの確認が表示されたら承認し、解析結果を確認してください。案内が表示されない場合は、+から元のパラメーターを入力してレコードを手動で作成できます。
適したケース:単一サーバーの共有テキストを1件以上、すべて取得済みの場合
QRコードをスキャン:コードに含まれる元の内容を読み取る
Homeからスキャン機能を開き、カメラへのアクセスを許可してQRコードを読み取ります。読み取った内容がWebページや通常のテキストであれば、用途を確認してから操作してください。サーバーレコードとしてそのまま保存しないでください。
適したケース:リンクが別の画面に表示されていて、手入力やコピーが難しい場合
サブスクリプションURLの例はhttps://example.com/sub?token=xxxxです。URLの形式を示すための例であり、利用できる内容は含まれていません。クエリパラメーターのtokenはそのまま保持してください。単一サーバーのパスワードに置き換えたり、tokenを含むURLを公開の掲示板に投稿したりしないでください。
- トラブルシューティング中に元の設定を失わないよう、既存のレコードと使用中のパラメーターを先に保存してください。
- インポート後、レコード数、Type、Address、Port、TLS、通信設定を確認してください。
- アプリ内で該当するサブスクリプションの更新操作を行い、正常に更新できることを確認してから、自動更新の設定を検討してください。
- サブスクリプション内のレコードを手動で編集した場合、次回の更新でサーバーから返された設定に上書きされることがあります。残しておきたい変更は別途記録してください。
サブスクリプションの応答には、複数の共有URIが含まれることも、クライアントが認識できる別の形式が使われることもあります。サーバー一覧のサブスクリプションとConfig内の構成ファイルは別のものです。ノードをインポートしても、ルール、DNS、Global Routingがすべて自動設定されるわけではありません。
インポート失敗・サブスクリプション更新失敗・接続失敗を分けて確認する
まず、問題が発生した段階を特定します。レコードがまったく作成されない場合は、リンク形式を確認します。レコードは作成されたもののサブスクリプションを更新できない場合は、URLへのリクエストを確認します。レコードを選択できるのにWebページが開かない場合は、接続とルーティングを確認してください。問題の段階を特定しないまま、すべての設定を何度も削除しないでください。
リンクをコピーしたのに認識されないのはなぜですか?
テキストがss://などの接頭辞から始まり、引用符、日本語の説明文、メッセージアプリが挿入した改行が混じっていないことを確認してください。表示テキストだけをコピーし、リンク全体をコピーできていない可能性もあります。クリップボードへのアクセスが拒否された場合は、システム設定でアプリのペースト権限を確認するか、Home → +から分かっているパラメーターを手動で入力してください。
QRコードをスキャンしたらhttps://で始まるURLが表示されました。ノードとして使えますか?
接頭辞だけでは判断できません。サブスクリプションURL、構成用URL、通常のWebページのどれかをまず確認してください。サーバー一覧を取得するためのURLだと明確に確認できた場合に限り、TypeがSubscribeのレコードに入力します。スキャン後のプレビューが提供元の説明と一致しない場合は、保存を中止してください。
サブスクリプションは保存できましたが、更新に失敗します。どうすればよいですか?
保存できたのはローカルにレコードが作成されたという意味で、サーバーへのリクエスト成功を示すものではありません。URLが完全か、tokenが有効か、そのアドレスにネットワークからアクセスできるかを確認してください。HTTP 401または403は通常アクセス権限、404はパスやリソース、タイムアウトはネットワークや接続先の応答に関係します。サブスクリプションのリクエストエラーに対処するために、単一サーバーのPortを変更しないでください。
ノードをインポートできたのに、Webページが開かないのはなぜですか?
Homeで選択中のレコードと接続状態を確認してから、Global Routingを確認してください。Directでは選択中のプロキシを経由して通信しません。Proxyはルールの影響を切り分ける一時的な確認に使えます。Configでは現在の設定に従って処理されます。元のモードを記録し、テスト後に戻してください。あわせてAddress、Port、認証情報、TLS、SNI、通信パラメーターも確認します。
Settings → On Demandでは、条件に応じて接続を開始する動作を管理します。誤った共有リンクを有効なレコードに修復する機能ではありません。インポートの問題を調べる際は、まずレコードを手動で確認して接続テストを完了し、その後にOn Demandを個別に確認してください。自動接続の動作と形式の問題が混同されるのを防げます。
共有前に確認:リンクのエンコードは情報を隠すものではない
Base64、パーセントエンコード、QRコードは、認証情報を隠すための安全対策ではありません。共有リンクにはパスワード、UUID、サーバーアドレスが含まれることがあり、サブスクリプションURLにはサーバー一覧全体を取得できるtokenが含まれる場合があります。スクリーンショットでパスワードが読めなくても、QRコードやエンコードされた文字列から復元できる可能性があります。
- 問い合わせやトラブル調査では、プロトコル、通信方式、ポート、エラーメッセージなど必要な情報だけを残してください。
- パスワード、UUID、サブスクリプションtoken、QRコードは削除してください。メモ名を隠すだけでは不十分です。
- 構造を示す必要がある場合は、例示用ドメインと明確なデモ値を使い、実際のリンクを貼り付けないでください。
- 認証情報を公開してしまった場合は、自分のサービス管理画面などから失効または変更し、その後ローカルのレコードも更新してください。