この記事で分かること

UbuntuでClash Verge Revを使い始めたい人向けに、インストール前の確認から初回起動、設定ファイルの読み込み、サブスクリプションの追加、プロキシ接続のテストまでを順番に説明します。WindowsやmacOSではアプリをダブルクリックして導入できますが、Ubuntuでは配布形式、CPUアーキテクチャ、実行権限、デスクトップ環境の統合などを確認する必要があります。ここを飛ばすと、アプリは起動してもシステムプロキシが切り替わらない、設定は読み込めてもノードが表示されない、といった問題が起きやすくなります。

本記事では、Ubuntu Desktopを中心に、GUIで操作できる場面とターミナルで確認したほうが早い場面を分けて解説します。対象はLinuxを初めて使う人だけではありません。開発環境やサーバー用途でUbuntuを利用しており、ブラウザ、Git、Python、Node.jsなど特定のアプリケーションだけをプロキシ経由にしたい人にも役立つ構成です。なお、利用する設定ファイルや購読URLは各サービスの規約に従って入手し、第三者へ不用意に共有しないでください。

導入前に確認する項目

最初にUbuntuの状態を確認します。Clash Verge RevはGUIアプリですが、Ubuntuの種類やデスクトップ環境によって表示場所や権限ダイアログが少し異なります。特に重要なのは、Ubuntuのバージョン、CPUの種類、現在動作しているVPNやプロキシの有無、そして管理者権限です。自分の環境を把握しておけば、後で発生した問題を「アプリの導入」「設定ファイル」「ネットワーク経路」のどの層に分類すべきか判断しやすくなります。

確認項目 確認する理由
Ubuntuのバージョン パッケージや依存関係が対応しているかを判断するため
CPUアーキテクチャ x86_64、arm64など、取得すべきファイルが変わるため
デスクトップ環境 GNOMEのトレイ表示や自動起動の設定方法に影響するため
既存のVPN・TUN 複数の仮想ネットワークが競合する可能性があるため

ターミナルを開き、次のコマンドで基本情報を確認します。

cat /etc/os-release
uname -m
echo "$XDG_CURRENT_DESKTOP"

uname -mがx86_64なら一般的なIntelまたはAMD向けのビルドを選びます。ARM搭載の小型PCや開発ボードではaarch64またはarm64が表示されることがあります。異なるアーキテクチャ用のパッケージを無理に実行すると、インストール途中ではなく起動時に失敗する場合もあるため、ダウンロード前に確認しておくことが大切です。

前提：本記事の画面名はClash Verge RevのリリースやUbuntuのデスクトップ環境によって異なる場合があります。「Profiles」「Settings」「Proxies」に相当する項目を探してください。

Ubuntu向けパッケージを準備する

Clash Verge Revを導入するときは、まずプロジェクトが案内する公式の配布ページやリリース情報を確認します。検索結果に表示された再配布サイトや、ファイルを短縮URLだけで配っているページは避けてください。Linux向けアプリは、同じ名前に見えても古いビルド、改変版、別のコアを含むパッケージが混在することがあります。ファイル名、リリース番号、対応アーキテクチャ、パッケージ形式を順に確認し、ダウンロードした場所を記録しておくと、後から更新や再インストールを行うときにも安心です。

Ubuntuでは、配布形式としてDebianパッケージ、AppImage、圧縮アーカイブなどが使われます。初心者には、システムのアプリ一覧やメニューに登録されやすいDebianパッケージが扱いやすいでしょう。一方、複数のUbuntu環境で同じファイルを持ち運びたい場合はAppImageが便利なことがあります。ただし、AppImageは実行権限の付与やデスクトップランチャーの登録が必要になる場合があります。最初の導入では、無理に便利さを追求せず、使っているUbuntuに自然に統合される形式を選ぶのが安全です。

ダウンロード後は、ファイル名を確認します。ファイル名にamd64やx86_64が含まれるものは多くの一般的なPC向けです。arm64はARM向けなので、IntelまたはAMDのPCに入れることはできません。また、開発版やNightly版は新機能を試せる反面、設定形式が変わったり動作が不安定になったりすることがあります。日常的に使う環境では、まず安定版を選び、必要な理由があるときだけ別のビルドを試してください。

ステップ1：Clash Verge Revをインストールする

Debianパッケージをダウンロードした場合は、ファイルマネージャーからダブルクリックしてソフトウェアセンターで開く方法と、ターミナルからインストールする方法があります。GUI操作では表示されたパッケージ名と提供元を確認し、インストールボタンを押して認証します。ターミナルを使う場合は、ダウンロードディレクトリへ移動してからパッケージを指定します。

cd ~/Downloads
sudo apt install ./clash-verge-rev_*.deb

ファイル名の部分は実際にダウンロードした名前へ置き換えてください。./を付けるのは、現在のディレクトリにあるローカルパッケージを指定するためです。インストール中に依存関係の追加を求められた場合は、内容を確認してから進めます。見覚えのないリポジトリを追加するよう求められた場合は、いったん中止し、配布元の説明と照合してください。

インストールが終わったら、アプリケーション一覧でClash Verge Revを検索します。最初の起動では、設定ディレクトリの作成、ネットワークアクセス、システムプロキシの変更などを確認するダイアログが表示されることがあります。権限の内容を読まずにすべて許可するのではなく、どの機能に必要な権限なのかを確認してください。一般的なHTTPプロキシとして利用するだけなら、最初からTUNや高度なネットワーク機能を有効にする必要はありません。

Ubuntuのパスワードを入力してもアプリが起動しない場合、パッケージの種類が合っていない、依存関係が不足している、または既存のネットワークサービスと競合している可能性があります。エラーメッセージを保存してから追加操作を行ってください。

AppImageを使う場合の注意点

AppImageを選ぶ場合は、ダウンロードしたファイルに実行権限を付けます。ファイルマネージャーのプロパティ画面で「プログラムとして実行可能」を有効にする方法と、ターミナルからchmodを使う方法があります。

cd ~/Downloads
chmod +x Clash.Verge.Rev*.AppImage
./Clash.Verge.Rev*.AppImage

AppImageはパッケージマネージャーを通さずに起動できる反面、アプリケーション一覧への登録、自動起動、更新の確認を自分で管理する必要があります。毎日使う場合は、専用のアプリディレクトリへ移動し、ファイル名を固定しておくと管理しやすくなります。ただし、古いファイルと新しいファイルを同じ場所に置くと、どちらを起動しているのか分からなくなるため、使用しない旧版は整理してください。

ステップ2：初回起動と基本設定

Clash Verge Revを起動すると、プロファイル、プロキシ、ルール、設定などの画面が表示されます。最初に確認したいのは、アプリがバックグラウンドで動作していること、ローカルの混合ポートが設定されていること、そしてコアが正常に起動していることです。ポート番号は環境や初期設定によって異なるため、記事中の数字をそのまま使わず、アプリの設定画面に表示された値を使ってください。

混合ポートは、HTTPプロキシとSOCKSプロキシの両方を受け付けるための入口です。たとえばアプリに127.0.0.1:7897と表示されている場合、同じUbuntu上のアプリケーションはそのアドレスへ接続できます。127.0.0.1は自分のPC自身を意味するため、通常はLAN上の他の端末からアクセスできません。LAN共有を意図していない限り、待受アドレスを無闇に0.0.0.0へ変更しないでください。

続いて、起動時にClash Verge Revを開始するかを決めます。自宅の開発PCで常にプロキシを使うなら自動起動が便利ですが、外出先のWi-Fiや社内ネットワークで毎回同じ経路を使えるとは限りません。自動起動を有効にする場合でも、システムプロキシを自動で有効にする設定は別に確認しましょう。アプリだけ起動してプロキシを有効にしない構成にしておくと、必要なときだけ手動で切り替えられます。

ステップ3：設定ファイルまたは購読URLを追加する

Clash Verge Rev単体をインストールしただけでは、接続先のノードやルールは用意されません。利用するサービスから取得した設定ファイル、または購読URLを追加する必要があります。購読URLはアカウント情報と同じように扱い、公開リポジトリ、チャット、スクリーンショットへ貼り付けないでください。URLに認証用の文字列が含まれている場合、流出すると第三者に利用される可能性があります。

プロファイル画面でリモート設定の追加欄を開き、購読URLと分かりやすい名前を入力します。取得に成功すると、プロファイル一覧へ新しい項目が表示されます。そこで重要なのは、追加しただけで自動的に利用中になるとは限らないことです。ダウンロード後に対象プロファイルを選択し、更新日時、プロキシグループ、ルールの読み込み状況を確認してください。

設定ファイルをローカルから読み込む場合は、拡張子だけで判断せず、内容がClashまたはMihomo互換の形式になっているかを確認します。先頭にproxies:、proxy-groups:、rules:などが含まれていても、インデントが崩れていると読み込みに失敗します。YAMLは空白の扱いが厳密なので、タブ文字を混ぜないこと、値に特殊文字が含まれる場合は引用符を使うことが基本です。

mixed-port: 7897
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

dns:
  enable: true
  enhanced-mode: fake-ip

rules:
  - MATCH,PROXY

上の例は構造を理解するための最小例であり、実際のノード情報や認証情報を含みません。これだけで外部通信が可能になるわけではありません。実運用では、提供元が案内するプロファイルを使い、必要に応じて自分の環境向けにルールやDNS設定を調整します。設定を編集する前には元ファイルをコピーしておくと、変更後に問題が出ても簡単に戻せます。

ステップ4：プロキシモードを選択する

Clashには、通信をどのように振り分けるかを決めるモードがあります。Ruleモードでは、ドメインやIP、地域情報などのルールに従ってDIRECTとPROXYを切り替えます。日常利用では、国内サービスや社内サイトを直接接続し、対象の通信だけをプロキシへ送れるため、速度と安定性のバランスを取りやすい方法です。

Globalモードは多くの通信を選択したプロキシへ送るため、ルールの問題かどうかを確認する切り分けに使えます。ただし、すべての通信を同じ経路へ流すと、銀行、社内システム、地域制限のあるサービスでログイン確認が発生することがあります。常用するより、一時的なテストとして利用するほうが安全です。Directモードはプロキシを使わず、導入直後に通常のネットワークが正常かを確認するときに役立ちます。

最初はRuleモードを選び、プロキシグループの選択を自動または手動に設定します。自動選択が用意されている場合でも、実際の遅延だけで最適なノードが決まるとは限りません。接続は速くても混雑している、特定の時間帯だけ切断される、動画や開発APIに向かない、といったことがあります。複数のノードを試し、遅延、接続成功率、実際の用途での安定性を合わせて判断してください。

ステップ5：Ubuntuのシステムプロキシを設定する

GUIアプリを使うブラウザの多くは、Ubuntuのシステムプロキシ設定を参照できます。Clash Verge Rev側でシステムプロキシを有効にすると、HTTP、HTTPS、場合によってはSOCKSの接続先がデスクトップ環境へ反映されます。反映後はブラウザを再起動し、設定画面の値が変わっているかを確認してください。アプリ側のスイッチを押しただけで、すでに起動しているアプリへ必ず反映されるとは限りません。

ターミナルで動くコマンドは、システムプロキシを自動的に読むとは限りません。その場合は環境変数を明示します。混合ポートが7897の場合の例は次のとおりです。

export http_proxy=http://127.0.0.1:7897
export https_proxy=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897
export no_proxy=localhost,127.0.0.1,::1
export NO_PROXY=localhost,127.0.0.1,::1

これらをシェルの設定ファイルへ常に追加するかどうかは、利用環境に合わせて決めます。常時有効にすると便利ですが、Clash Verge Revを終了したときに、ターミナルの通信がすべて失敗することがあります。まずは一時的なシェルで試し、問題がなければ~/.bashrcや~/.zshrcへ追加してください。会社や学校のネットワークでは、プロキシの利用が規約で制限されている場合もあるため、必ず管理者の案内を確認します。

ヒント：GUIアプリとターミナルで結果が違うときは、Clashの問題と決めつけず、環境変数、シェルの種類、アプリごとのプロキシ対応状況を分けて確認すると原因を見つけやすくなります。

接続が成功したか確認する

プロキシを有効にしたら、まずClash Verge Revの接続ログを開きます。ブラウザでページを開いた直後に、対象ドメイン、使用されたルール、選択されたプロキシグループが表示されるか確認してください。ログに何も出ない場合は、ブラウザが別のプロキシ設定を使っている、システムプロキシが反映されていない、またはキャッシュされたページを表示している可能性があります。

次に、ターミナルからHTTPリクエストを送ります。環境変数を使わず、プロキシを直接指定する方法は、シェル設定の影響を受けにくいので切り分けに便利です。

curl -v -x http://127.0.0.1:7897 https://example.com
curl -I https://example.com

最初のコマンドは指定したHTTPプロキシを経由します。二つ目は環境変数が設定されている場合にその値を使います。-vの出力では、プロキシへの接続、CONNECTの確立、TLSハンドシェイク、HTTPレスポンスの順に確認できます。DNSエラー、接続拒否、TLSエラー、HTTPの認証エラーは原因が異なるため、表示された段階をメモしてください。

接続ログとcurlの結果が一致しない場合、次の項目を確認します。第一に、Clash Verge Revが本当に起動しているか。第二に、設定画面に表示されたポート番号とコマンドのポート番号が同じか。第三に、Ruleモードのルールが対象ドメインをDIRECTへ送っていないか。第四に、Ubuntu側のファイアウォールや別のVPNが接続を奪っていないかです。複数の確認を一度に変更せず、ひとつずつ戻しながら試すと原因を追いやすくなります。

よくある問題と対処方法

アプリが起動しない

アプリが何も表示せず終了する場合は、ターミナルから起動してエラーを確認します。AppImageなら実行権限、Debianパッケージなら依存関係やアーキテクチャを確認します。WaylandとX11の違い、GPUアクセラレーション、古い設定ファイルが原因になる場合もあります。初回起動だけ失敗するなら、ユーザー設定ディレクトリの内容をバックアップしたうえで、一時的に名前を変えて起動する方法があります。ただし、購読URLや秘密情報が含まれている可能性があるため、削除ではなくバックアップを優先してください。

プロファイルを読み込めない

プロファイルの取得に失敗する場合は、URLの入力ミス、購読の期限切れ、サービス側の一時障害、TLS検証、DNSの問題を順番に確認します。ブラウザでURLを開けることと、Clashが有効な設定を取得できることは同じではありません。取得したファイルがHTMLのエラーページになっていないか、テキストエディターで先頭部分を確認してください。YAMLの構文エラーなら、編集した箇所を元に戻し、設定チェッカーやClashのエラー表示を利用します。

プロキシを有効にしても通信が変わらない

プロキシを有効にしたつもりでも、実際にはモードがDirectのまま、システムプロキシだけが無効、またはブラウザが独自の接続設定を使っている場合があります。ブラウザのネットワーク設定を確認し、いったん完全に終了してから再起動します。ターミナルアプリは、既存のシェルに環境変数を追加しても、子プロセスや別のGUIランチャーへ自動で伝わらないことがあります。どの方法で起動したアプリが、どの設定を読んでいるのかを確認してください。

TUNを使うべきか

TUNは、アプリごとのプロキシ設定を無視するプログラムも含め、より広い通信をClashへ取り込める機能です。Linuxで開発ツールやコンテナの通信をまとめて扱いたい場合には便利ですが、ルーティングテーブル、DNS、VPN、Dockerネットワークなどと競合しやすくなります。初心者は、まずシステムプロキシと環境変数で目的のアプリが動くか確認し、それで不足する場合だけTUNを検討してください。

TUNを有効にする前に、現在のネットワーク状態を記録します。デフォルトルート、DNSサーバー、使用中のVPN、Dockerや仮想マシンのネットワークを把握しておくと、無効化後に元へ戻しやすくなります。TUNを試した後にネットワーク全体が不安定になった場合は、Clashを再起動するだけでなく、他のVPNを停止し、ルーティングとDNSが元の状態へ戻っているか確認してください。

安全に運用するためのポイント

Clash Verge Revは通信経路を変更するツールなので、便利さだけでなく安全性も意識する必要があります。購読URLや設定ファイルには、接続先、認証情報、ルール、外部リソースの参照が含まれることがあります。出所が不明な設定をそのまま使わず、内容を確認し、不要な外部プロバイダーやスクリプトがないかを確認してください。更新後に突然ルールが変わった場合は、変更履歴や提供元の告知を確認します。

また、プロキシを通すことで通信元の地域や出口が変わるため、銀行、決済、社内認証、クラウド管理画面では追加の本人確認が発生することがあります。重要なアカウントを使うときは、接続先とルールを確認し、必要ならDIRECTへ戻してください。パスワードやAPIキーを含む通信については、TLSが有効であること、プロキシが不審な証明書を挿入していないことも確認します。

Ubuntuをサーバーとして使う場合は、GUIユーザーの設定とsystemdサービスの環境が別になる点にも注意が必要です。デスクトップで有効にしたシステムプロキシが、バックグラウンドサービスへ自動的に引き継がれるとは限りません。サービス単位で環境変数を設定する場合は、秘密情報をユニットファイルへ直書きせず、権限を制限した環境ファイルや安全なシークレット管理を利用してください。

初心者向けの確認手順まとめ

  1. Ubuntuの情報を確認する：バージョン、CPUアーキテクチャ、デスクトップ環境、既存VPNの有無を調べます。
  2. 適切なパッケージを選ぶ：公式の配布情報とファイル名を照合し、x86_64やarm64を間違えないようにします。
  3. Clash Verge Revを導入する：DebianパッケージまたはAppImageを使い、初回起動時の権限内容を確認します。
  4. ポートを確認する：混合ポートのアドレスと番号を設定画面で確認し、記事の例をそのまま流用しません。
  5. プロファイルを追加する：購読URLまたは設定ファイルを登録し、取得後に実際のプロファイルを選択します。
  6. Ruleモードで試す：必要な通信だけをプロキシへ送る設定にし、ログでルールの結果を確認します。
  7. ブラウザとCLIを別々に検証する：システムプロキシ、curl、環境変数がそれぞれ意図どおりに働くかを確認します。
  8. 問題を一つずつ切り分ける：アプリ、プロファイル、ポート、ルール、DNS、VPNの順に確認します。

UbuntuでClash Verge Revを選ぶ理由

Ubuntu向けのプロキシツールには、設定ファイルを直接編集するタイプ、ブラウザ専用の拡張機能、コマンドラインだけで動くクライアントなど、さまざまな選択肢があります。軽量なツールは導入後の負荷が小さい一方、ノード切り替えやルール確認を毎回ターミナルで行う必要があり、設定に慣れていない人には現在の状態が分かりにくいことがあります。ブラウザ拡張は手軽ですが、Git、パッケージマネージャー、IDE、コンテナなどブラウザ以外の通信には適用されません。

Clash Verge Revは、プロファイル、プロキシグループ、ルール、ログをひとつの画面で確認しやすく、必要に応じてシステムプロキシ、環境変数、TUNを使い分けられる点がUbuntuでの利点です。特に今回のように、ブラウザはシステムプロキシ、開発ツールはHTTPS_PROXY、特定のアプリは別ルールという構成を段階的に組めるため、最初から全通信を変更せずに試せます。もしUbuntuで設定状態を見ながら安全にプロキシ環境を整えたいなら、ここまでの手順を使ってClash Verge Revを導入し、まずは小さな通信テストから始めるとよいでしょう。

インストーラーを入手する

Clash を無料でダウンロードして、快適なネット体験を →