サブスクリプションの更新失敗、グループが更新されない、更新後にノードが減ったといった場合は、まず対象グループを手動更新し、ダウンロード・内容の解析・更新後の接続のどの段階で失敗したかを切り分けましょう。v2rayNとv2rayNGでは、サブスクリプションURLと更新時の通信経路を確認してから、グループの定期更新を有効にするか判断できます。
ダウンロード・解析・接続のどの段階で失敗したか確認する
サブスクリプションURLは、クライアントがノード一覧を取得するためのアドレスであり、一覧にある個々のノードのサーバーアドレスではありません。更新に成功したのは、クライアントがサブスクリプションの内容を取得して処理できたという意味で、すべてのノードに接続できるとは限りません。反対に、サブスクリプションURLにアクセスできなくても、保存済みのノードがすぐに使えなくなるわけではありません。切り分けの際は既存の一覧を残し、リンクのテスト目的でグループを削除しないでください。
- URLへのリクエストに失敗する:サービス提供元の管理画面からサブスクリプションURLをもう一度コピーし、前後の空白や改行、クエリパラメーターを確認します。アカウントのログインページ、個別ノードの共有リンク、変換サービスの表示ページをサブスクリプションURLの代わりに使わないでください。
- リクエストは成功するがノードが追加されない:HTTP 200はサーバーから何らかの内容が返されたことを示すだけです。ログインページやメンテナンスページ、認証ページでも200が返る場合があります。まず、サービス提供元がクライアントでインポート可能な形式のサブスクリプションを提供しているか確認し、次にグループのフィルター条件で項目が除外されていないか確認してください。
- ノードは更新されたが接続できない:グループ内の新しいノードを1つ選んで接続テストを行い、接続ログを確認します。この場合は、ノードのアドレスや通信パラメーター、コアの対応状況を確認してください。サブスクリプションの更新間隔を短くしても、ハンドシェイクの失敗は解決しません。
サブスクリプションの更新ログ:タイムアウト・解析・証明書エラー
エラーが出たグループだけを更新し、クリックした時刻を記録して、同じ時刻のクライアントのメッセージを確認します。エラーの表現はOSやバージョンによって異なります。以下はよく見られるメッセージや例外名です。対処する際は、サブスクリプションのリクエストエラーと、コアの実行ログに出るノード接続エラーを区別してください。
java.net.UnknownHostException
原因:リクエスト元でホスト名を解決できませんでした。URLの入力ミス、または現在のネットワークでのDNS名前解決の失敗が考えられます。対処法:まずサブスクリプションのドメイン名を確認し、信頼できる別のネットワークで同じグループを再試行します。ノード設定とDNSを同時に変更するのは避けてください。
java.net.SocketTimeoutException: timeout
原因:接続またはレスポンスの読み込みがタイムアウトしました。このメッセージだけでは、サブスクリプションの期限切れとは判断できません。対処法:同じサブスクリプションURLを使い、現在のネットワークからの直接接続と、動作確認済みのプロキシ経由の両方で試して、どちらでダウンロードできるか記録します。
The SSL connection could not be established, see inner exception.
原因:TLS接続失敗を示す概要メッセージです。証明書の日付、ホスト名、信頼チェーンのどれに問題があるかは、詳細な例外を確認する必要があります。対処法:まずシステムの日付・時刻・タイムゾーンを同期して再試行します。それでもエラーが出る場合は、機密情報を伏せた詳細な例外をサービス提供元に共有して確認してください。証明書の検証は無効にしないでください。
同じグループでどちらの経路でも401が返る場合は、まずURLを変更
サービス提供元の管理画面からサブスクリプションURLを再取得し、既存のグループでURLを置き換えてから手動で一度更新します。429が返った場合は、レスポンスのRetry-Afterまたはサービス提供元の案内に従って待ってください。更新を連続して実行すると、次のテスト結果を判断しにくくなります。
v2rayN:現在のサブスクリプションを更新し、間隔を設定する
v2rayNでは、メイン画面の「サブスクリプショングループ」メニューからグループを管理でき、同じメニューから更新も実行できます。以下では一般的な日本語UIに沿って説明します。バージョンによって表示が多少異なるため、実際のメニュー名と項目の単位を確認してください。最初の切り分けでは現在のグループだけを更新すると、結果とログを照らし合わせやすくなります。
グループのURLを確認する
「サブスクリプショングループ」→「サブスクリプショングループ設定」を開き、対象グループを選んで、名前とサブスクリプションURLを確認します。サービス提供元がURLを再発行した場合は、既存のグループのURLを置き換えて保存してください。新旧のURLを別々の更新対象グループとして残さないようにします。
直接接続で更新を試す
メイン画面に戻り、対象グループを選択して「サブスクリプショングループ」→「現在のサブスクリプションを更新(プロキシ経由なし)」を実行します。メッセージと対象グループの一覧を確認してください。一部の項目が表示されない場合は、グループのフィルター設定とサービス提供元から配信された内容を確認します。
プロキシ経由の更新と比較する
直接接続でタイムアウトする場合は、既存のノードが正常に接続でき、ローカルプロキシが起動していることを確認してから、「サブスクリプショングループ」→「現在のサブスクリプションを更新(プロキシ経由)」を実行して比較します。どちらの方法も失敗する場合は、それぞれのエラーを記録してください。プロキシ経由の更新は、認証エラーや証明書エラー全般を解決する方法ではありません。
更新間隔を設定する
手動更新に成功したら、対象グループの編集画面に戻り、「自動更新間隔」欄を確認します。単位は分です。
1440を入力すると24時間になります。サービス提供元がより長い間隔を指定している場合は、その案内に従って入力してください。保存後はクライアントを起動したままにし、次の更新周期に更新記録を確認します。
「プロキシ経由」を手動で選んで更新に成功しても、定期更新で同じ経路が使われるとは限りません。手動更新は成功するのに定期更新が失敗する場合は、予定時刻のログを確認し、そのときプログラムが起動していたか、PCがスリープしていなかったか、定期リクエストに必要なネットワークやローカルプロキシが利用可能だったかを調べます。グループの内容が変わらないのは正常な場合もあるため、ノード数だけで更新の有無を判断しないでください。
v2rayNG:グループの更新と自動更新を確認する
v2rayNGのメイン画面でサイドバーを開き、「サブスクリプショングループ設定」に進んで対象のサブスクリプションを編集し、URLと更新対象になっているかを確認します。保存してノード一覧に戻り、対象グループを選択して、右上の「⋮」メニューから「サブスクリプションを更新」を選びます。メニューの対象範囲はバージョンによって異なります。現在のグループだけを更新する項目がある場合は、そちらを優先してください。全グループの更新しか選べない場合は、更新結果と各グループの一覧を確認し、別のグループの結果を対象グループの結果と取り違えないようにします。
- 定期更新を設定する:まず「サブスクリプショングループ設定」の編集画面で、現在のバージョンに自動更新の切り替えや間隔の設定があるか確認します。全体設定のスイッチがある場合は、有効にしたうえで対象グループが更新対象になっているかも確認してください。間隔を入力する欄がある場合は、表示されている単位に合わせて1日分の値を入力します。たとえば、時間単位なら
24、分単位なら1440です。定期更新の項目がない場合は手動で更新し、デスクトップ版のメニュー手順を当てはめないでください。 - 更新時の通信経路を確認する:サブスクリプションを更新するのは、クライアントからのネットワークリクエストです。システム上で接続が有効と表示されていても、そのアイコンだけでサブスクリプションのドメインがどの経路を通るかは判断できません。アプリごとの通信設定や現在のネットワーク、クライアントの実装によって結果が変わる場合があります。比較するときは、一度に変更する条件を1つに絞り、同じサブスクリプションURLを使ってください。
- バックグラウンドで実行されるか確認する:手動更新は成功するのに定期更新の記録がない場合は、Androidの設定でアプリのバックグラウンド実行が制限されていないか、省電力中や待機中にタスクが遅延していないかを確認します。まず現在のバージョンが定期更新に対応しているかを確認してから、システム側の制限を調べてください。バッテリー設定を変えるだけで、クライアントに定期更新機能が追加されるわけではありません。
自動更新の頻度と結果の確認
サービス提供元から推奨間隔が案内されていない場合は、まず24時間間隔で一周期分の動作を確認します。長期間安定しているグループは、すぐに更新しようとして間隔をむやみに短くする必要はありません。複数の端末で同じサブスクリプションを使う場合は、更新時刻をずらし、同じ認証情報へのリクエストが集中しないようにします。サービス提供元が指定する更新頻度は、ここでの目安より優先してください。
- 現在の状態を記録する:手動で一度更新し、グループ名、成功時刻、ノード数を記録します。サブスクリプションURL全体をスクリーンショットや公開ログに載せないでください。クエリパラメーターにアクセス用の認証情報が含まれる場合があります。
- 次回の定期実行を確認する:設定した間隔が経過したら、クライアントの通知や更新ログを確認します。内容に変化がなくても、リクエストと解析の成功がログで確認できれば、間隔を短くする必要はありません。クライアントの起動後にしか更新が確認できない場合は、起動時またはスリープ解除後にタスクが実行される設定か確認してください。
- 状況に応じて設定を戻す:リクエスト制限が発生した場合は更新間隔を延ばすか、自動更新を一時的に無効にします。サービス提供元から認証情報の再発行を求められた場合は、既存グループのURLを置き換えてください。失敗しているのが1つのグループだけなら、他のサブスクリプションを作り直さず、そのグループだけを修正します。