· 入門ガイド · 約8分

vmess://・vless://リンクの形式を解説|単体ノードとサブスクリプションのインポート方法

vmess://・vless://リンクの各項目を解説。単体の共有リンクとサブスクリプションの違い、v2rayN・v2rayNGでのクリップボードからのインポートと更新方法を紹介します。

この記事の概要

リンクを受け取ったら、まず設定を直接インポートできる単体リンクなのか、保存してから更新するサブスクリプション URLなのかを確認しましょう。インポート後はリストとグループを確認してから接続テストを行うと、リンクの読み込み、サブスクリプションの取得、ノードへの接続のどこで問題が起きたかを切り分けやすくなります。

単体ノードとサブスクリプション URLの違い

vmess:// または vless:// で始まる共有リンクには、ノード設定が1件分含まれています。クライアントがリンクを解析すると、その設定がローカルのリストに保存されます。送信者が後からサーバーアドレスやポートを変更しても、手元のリンクには反映されません。新しいリンクを入手して、再度インポートする必要があります。

サブスクリプション URLは通常 https:// で始まり、クライアントがその URLにアクセスして、その時点のノードリストを取得します。ログインページやヘルプページも https:// で始まるため、先頭部分だけでは判断できません。設定の提供元が「サブスクリプション URL」と明記したリンクをコピーし、ブラウザーのアドレスバーに表示されたページ URLは使わないでください。

サブスクリプション URLネットワークリクエストレスポンスの解析グループの更新ノードリスト

VMess・VLESS共有リンクの項目

一般的なVMess共有形式では、JSONをBase64でエンコードし、vmess:// の後ろに付けます。Base64はエンコード方式であり、暗号化ではありません。一般的なVLESS共有形式では、UUID、サーバー、ポートがURLに直接記載され、クエリパラメーターも項目ごとに確認できます。どちらの形式も、元のリンクを別の場所でデコードする必要はありません。クライアントのノード編集画面で項目を確認できます。

36
ハイフン付きUUIDの標準文字数
443
接続例で使われているリモートポート
0
一般的なVMess AEAD設定のalterId

VMess:デコード後のJSON項目

ps
ノードの名前(例:「サンプル」)
add / port
サーバーアドレスとリモートポート(例:node.example.invalid、443)
id / aid
ユーザーUUIDとalterId。一般的なAEAD設定ではalterIdは 0
net / path
転送方式とパス(例:ws、/ws)
tls / sni
TLSを使用するかどうか、および明示的に指定する場合のTLSサーバー名

名前は変更できますが、アドレス、ポート、転送パラメーターはサーバー側の設定と一致させてください。

VLESS:アドレスとクエリパラメーター

@ の左側
ユーザーUUID。以下では位置を示すために全ゼロの値を使用
@ の右側から ? の前まで
サーバーとリモートポート(例:node.example.invalid:443)
type / path
転送方式とパス(例:ws、URLエンコードされた %2Fws)
security / sni
接続のセキュリティ方式とサーバー名。例ではTLSを使用
# の後ろ
ノードの名前。接続パスではありません

例の encryption=none は、TLSを無効にするという意味ではありません。TLSは security=tls で指定します。

以下は、形式を確認するためだけのVLESSリンクです。例のドメインは名前解決できません。また、443 はすべてのノードで固定のポートではなく、システムプロキシ設定に入力するローカルの待ち受けポートでもありません。

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

WebSocketノードを確認するときは、接続先アドレス、TLSサーバー名、WebSocketリクエストの Host を区別してください。3つが同じ場合も異なる場合もあります。接続先アドレスは接続先を決め、サーバー名はTLSハンドシェイクと証明書検証に関係し、リクエストの Host はHTTP層のフィールドです。編集画面でどれも「ドメイン」のように見えても、同じ値に変更しないでください。

v2rayN・v2rayNGでクリップボードから単体ノードをインポート

vmess:// または vless:// で始まる行全体をコピーしてください。チャットアプリ上で表示が折り返されていても、通常はコピーに影響しません。ただし、実際に改行が入っていたり、引用符、リスト番号、文末の句読点までコピーしたりすると、クライアントが読み込めないことがあります。手動でデコードしたテキストを、共有リンクのインポート画面に貼り付けないでください。

  1. v2rayN(デスクトップ):メイン画面を開き、「サーバー」メニューからクリップボードのURLをインポートするコマンドを選びます。一般的な7.xの画面では「クリップボードから一括URLをインポート」と表示され、単一リンクにもこの項目を使います。インポート後、リストから名前で新しい項目を探し、編集画面でプロトコル、サーバー、ポートを確認してから選択し、接続をテストしてください。
  2. v2rayNG(Android):設定リストの右上にある「+」をタップし、「クリップボードからインポート」を選びます。手動で設定を追加する方法は使いません。インポート後に新しい項目を選び、接続ボタンをタップします。初回使用時は、システムからVPN接続の確認を求められる場合があります。
  3. 成功と表示されたのに項目が見つからない場合:まずリストの検索条件を解除し、「すべて」に切り替えるか、現在のグループを確認してください。そのうえで、名前またはサーバーアドレスから探します。見つからないからといって続けてインポートすると、見た目が同じ項目が複数でき、接続テスト時に選び間違えるおそれがあります。

v2rayN・v2rayNGでサブスクリプションを追加・更新

サブスクリプションは、URLの保存と更新の2段階で設定します。「保存成功」はクライアントにURLが記憶されたことを示すだけで、ノードがリストに追加されたとは限りません。サブスクリプションを2つ使う場合は別々のグループに登録すると、次回の更新時に、どちらのURLが空のリストを返したか、またはエラーになったかを確認できます。

  1. v2rayN(デスクトップ):「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、グループを追加します。見分けやすい名前とサブスクリプション URL全体を入力して保存してください。メイン画面に戻り、そのグループを選択して「サブスクリプショングループ」メニューから現在のサブスクリプションを更新します。プロキシ経由の有無を選べる場合は、サブスクリプションサーバーに直接アクセスできるなら、まずプロキシを経由しない方法を選んでください。
  2. v2rayNG(Android):左上のメニューから「サブスクリプショングループ設定」を開き、「+」をタップして名前とURLを入力し、保存します。設定リストに戻って該当グループに切り替え、右上のその他メニューから「サブスクリプションを更新」を実行してください。バージョンによってメニューの表記が多少異なることがあります。先にサブスクリプショングループへ保存し、その後リストから更新するのがポイントです。
  3. 更新後の確認:対象のグループに項目が追加されていることを確認します。設定を1つ開いてサーバー、ポート、転送方式を確認してから選択し、接続してください。項目が1つだけでも、サブスクリプションがその時点で1件しか返していない可能性があります。項目数ではなく、所属グループでサブスクリプション由来かどうかを判断してください。

サブスクリプション URLには、疑問符以降のクエリパラメーターも含めて入力してください。パラメーターを削除したり、大文字・小文字を変えたりしないでください。また、ノードのサーバー欄にサブスクリプション URLを入力してはいけません。提供元が複数の形式を用意している場合は、現在のクライアント向けと明記されたものを選んでください。URLにアクセスできても、クライアントが応答内容を解析できるとは限りません。

インポート失敗・更新のタイムアウト・接続エラー

貼り付け後に有効な設定がないと表示されたら、何を確認すればよいですか?

まずクリップボードの先頭が vmess:// または vless:// か確認し、途中に改行がないか、末尾に句読点が混ざっていないかを確認してください。コピーしたものが https:// のサブスクリプション URLなら、サブスクリプショングループから追加してください。ノードのインポートを何度も試す必要はありません。

サブスクリプション更新がタイムアウトします。プロキシ経由に切り替えると改善しますか?

まずネットワークに接続できていることを確認し、プロキシを経由せずに再試行してください。サブスクリプションサーバーへの直接接続がタイムアウトし、リストに利用可能なノードがある場合は、そのノードを選択してから、クライアントのプロキシ経由で更新するコマンドを試せます。利用可能なノードがなければ、この設定だけで接続が確立することはありません。サブスクリプション URLにアクセスできる、利用権限のあるネットワークに切り替えて再試行してください。

サブスクリプションの更新完了と表示されるのに、グループが空なのはなぜですか?

まず、更新したグループに切り替え、絞り込み条件を解除してください。ログに解析エラーが表示されている場合は、提供元のページに戻り、使用するクライアントに対応したURLをコピーし直します。ログに 401 または 403 と表示されている場合は、アカウントの状態やトークンの有効期限、ログインページのURLを誤ってコピーしていないかを確認してください。

ノードをインポートできたのに、Webページを開けないのはなぜですか?

まず、選択中のノードが新しくインポートしたものか確認し、通信がクライアントを経由しているかを調べてください。デスクトップではシステムプロキシが有効か、ブラウザーがそのプロキシを使っているかを確認します。Androidでは接続が開始されているかを確認してください。接続ログにTLSハンドシェイクや証明書のエラーがある場合は、元の設定とサーバー名、端末の時刻を照合します。設定ミスを隠すために証明書検証を無効にしないでください。

v2rayN をダウンロード