インストールと移行 · Clash 技術ブログ

Ubuntu に Clash Verge Rev をインストールする方法:DEB、システムプロキシ、自動起動

Ubuntu では、まずアーキテクチャに合う DEB インストーラーを選びます。サブスクリプションとシステムプロキシの設定を終えてから、TUN サービスをインストールするか、自動起動を設定するかを決めてください。各手順に元へ戻す方法を用意します。

  • Ubuntu
  • Linux
  • DEB
  • システムプロキシ
目次

Ubuntu へのインストールは、アーキテクチャに適合する DEB から始める

Ubuntu での完全な手順は、CPU アーキテクチャに合わせて公式 DEB をダウンロードし、apt でインストールして、サブスクリプションをインポートし、システムプロキシを検証した後、最後に自動起動を設定する、という順序です。システムプロキシが安定する前に TUN サービスのインストールとログイン後の自動処理を同時に有効にすると、再起動後に通信できない場合のロールバックが難しくなります。

2026-07-23 時点で、Clash Verge Rev の最新安定版 v2.5.2 には amd64、arm64、armhf 向けの DEB があります。Ubuntu と Debian では DEB を直接使用することで、デスクトップメニュー、依存関係、アンインストールをパッケージマネージャーへ任せられます。現在の Latest には AppImage がないため、サードパーティーサイトで探す必要はありません。

アーキテクチャとの対応

uname -mDEB アセット
x86_64*_amd64.deb
aarch64 / arm64*_arm64.deb
armv7l*_armhf.deb。まず OS 自体が 32 ビット ARM であることを確認する

ダウンロード後、まずアーキテクチャとパッケージ情報を確認する

Ubuntu の確認コマンド。DEB のパスは実際にダウンロードしたファイルへ変更してください
DEB='./Clash.Verge_2.5.2_amd64.deb'
uname -m
dpkg --print-architecture
dpkg-deb -I "$DEB" | sed -n '1,25p'

バージョン番号は現在の例にすぎず、ファイル名には自分でダウンロードした Release を使用してください。dpkg-deb でパッケージの Architecture と Depends を読み取れます。この時点で OS と一致しない場合は、--force-architecture で強制インストールしないでください。

apt でローカルの DEB をインストールし、依存関係も同時に解決する

アーキテクチャが一致することを確認してから、apt でローカルファイルをインストールします。この方法なら、依存関係が不足している場合に明確なパッケージ名が表示され、後で同じパッケージ管理システムからアンインストールすることもできます。

ダウンロードディレクトリで実行する。DEB のパスは実際のファイルへ変更してください
DEB='./Clash.Verge_2.5.2_amd64.deb'
sudo apt install "$DEB"

# 查看安装状态
dpkg -l | grep -i clash-verge

# 需要卸载时先记下上一步显示的真实包名
sudo apt remove clash-verge

コマンド内のファイル名とパッケージ名には、ローカルで実際に得た結果を使用してください。apt が依存関係を解決できないと報告した場合は、完全なエラーと Ubuntu のバージョンを保存します。無作為に選んだ Web サイトから単体の .so ファイルをダウンロードして、システムライブラリを上書きしないでください。インストール後はアプリケーションメニューから一度起動すると、TUN をすぐに有効にするよりも WebKit、システムトレイ、カーネルの起動エラーを確認しやすくなります。

初回は Profile とシステムプロキシだけを検証する

アプリケーションを起動できても、まだ TUN は変更しないでください。簡単な Profile とシステムプロキシでブラウザを利用できれば、インストールパッケージ、Mihomo カーネル、デスクトッププロキシが正常に連携できることを十分確認できます。

最小限の接続経路

  1. リモートサブスクリプションまたはローカル設定をインポートする

    Clash Verge Rev 2.x は URL、ローカルファイル、ドラッグ操作によるインポートに対応しています。まず手動で更新してください。

  2. 現在の Profile に設定する

    ポリシーグループとノードが以前のキャッシュではないことを確認します。

  3. ノードを一つ固定する

    Rule モードを維持し、システムプロキシを有効にします。

  4. ブラウザを開いて接続を確認する

    ドメイン、ルール、出口がすべて表示されて初めて、デスクトッププロキシが正常と判断できます。

ログ、Profiles、ターミナルのプロキシがそれぞれどこにあるか

ブラウザは利用できても、ターミナルのコマンドが引き続きタイムアウトすることは Linux ではよくあります。デスクトップのシステムプロキシと shell の環境変数は別の設定です。まず個別に確認し、apt または Git のためだけに TUN をすぐ有効にする必要はありません。

公式ドキュメントに記載された Linux のパス

対象内容パス
verge.yaml~/.config/io.github.clash-verge-rev.clash-verge-rev/verge.yaml
作業ディレクトリ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/
Profiles~/.local/share/io.github.clash-verge-rev.clash-verge-rev/profiles/
WebView のキャッシュ~/.cache/io.github.clash-verge-rev.clash-verge-rev/
現在のターミナルだけに適用するプロキシ
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1

# 结束测试
unset HTTP_PROXY HTTPS_PROXY NO_PROXY

システムプロキシの検証に成功してから、自動起動を有効にする

まず Clash Verge Rev の設定ページで「自動起動」または Auto Launch を有効にします。バージョンによって名称が少し異なる場合があります。これはユーザーがデスクトップへログインした後にアプリケーションを起動する設定で、OS の起動前からプロキシを利用できるという意味ではなく、権限確認なしに TUN が自動で通信を処理する保証もありません。システムプロキシだけが必要な場合は、まず TUN を無効のままにしてください。

デスクトップの自動起動項目が実際に参照するプログラムを確認する
find ~/.config/autostart /etc/xdg/autostart   -maxdepth 1 -type f -iname '*clash*' -print 2>/dev/null

grep -R '^Exec=' /usr/share/applications 2>/dev/null   | grep -i 'clash.verge|clash-verge'

自動起動を実際に一度検証する

  1. まずログアウトし、デスクトップへログインし直す

    Clash Verge Rev のプロセスが一つだけ表示され、以前のクライアントが同時に起動していないことを確認します。

  2. 現在の Profile とノードを確認する

    アプリケーションの起動後も、サブスクリプションが選択済みで、実行時設定が直前に検証したものと同じであることを確認してください。

  3. システムプロキシを確認する

    自動的に有効にする設定の場合は、ブラウザからの接続が記録される必要があります。自動処理を望まない場合は、スイッチを無効のままにしてください。

  4. 終了後の復元をテストする

    アプリケーションメニューから正常に終了した後、Ubuntu の HTTP、HTTPS、SOCKS プロキシがローカルポートを参照しなくなります。

今回のログインテストに合格して初めて、自動起動を実際に利用できると判断できます。システムトレイのアイコンが表示されるだけでは不十分です。Profile が未選択の場合やシステムプロキシが残っている場合、アイコンとネットワークの状態が一致しない可能性があります。

プロキシを読み込まないプログラムが実際にある場合に、TUN サービスをインストールする

TUN にはサービスと仮想ネットワークインターフェースの権限が必要です。まずシステムプロキシを安定させ、その後で現在のバージョンの設定ページからサービスをインストールしてください。以前のチュートリアルにあるサービススクリプトとインストールディレクトリは変わっている可能性があります。権限または IPC のエラーが発生した場合は、現在の Release と公式 FAQ を先に確認し、別のバージョンに残されたコマンドをそのまま実行しないでください。

システムトレイが表示されない場合は、デスクトップ環境に AppIndicator のサポートがないことがよくあります。ウィンドウがクラッシュする場合は、ターミナルからアプリケーションを起動して stderr を確認してください。どちらもサブスクリプションのノード品質とは関係ありません。

ダブルクリックしてもウィンドウが表示されない

ターミナルから起動して WebKit/グラフィックライブラリのエラーを保存し、現在のデスクトップセッションを確認します。

ブラウザは利用できるが、apt/Git は通信できない

該当するコマンドの環境変数またはツール設定を構成し、TUN は先に有効にしないでください。

TUN のスイッチがすぐに無効へ戻る

サービスのインストールと権限を確認し、DNS とノードを繰り返し変更しないでください。

終了後にブラウザが通信できない

デスクトップのネットワーク設定で残存するプロキシを無効にし、アプリケーションが強制終了されなかったか確認します。

参考資料