目次
Ubuntu ではシステムのアーキテクチャに合う DEB パッケージを使います。ウィンドウが開いたら、取り込んだ設定で通信できるかも確認します。ブラウザー、コマンドライン、ログイン時の自動起動では、それぞれ確認する設定が異なります。動作を確認できた部分は維持し、失敗した手順を調べてください。ターミナルのタイムアウトだけで再インストールを始める必要はありません。
Ubuntu に DEB をインストール：amd64、arm64、armhf の選び方
下の表で、使っているプロセッサーのアーキテクチャと Ubuntu の DEB パッケージが一致するか確認してください。一致しないパッケージを無理にインストールしてはいけません。Clash Verge Rev のインストール後はシステムプロキシを確認し、正常に動いてからログイン時の自動起動を設定します。プロキシが必要なアプリがシステムプロキシを使わない場合に、TUN サービスを検討してください。変更は一つずつ行い、問題が起きたら直前の変更を元に戻します。
2026-07-23 時点の Clash Verge Rev の最新安定版 v2.5.2 は、amd64、arm64、armhf の DEB を提供しています。Ubuntu と Debian では、このバージョンをパッケージマネージャーでインストール・アンインストールできます。この Release に AppImage はありません。
新しいバージョンを入手するときは対応するリリースページの実際のファイルを確認し、ない形式を第三者のサイトで探さないでください。
アーキテクチャとの対応
| uname -m | DEB アセット |
|---|---|
| x86_64 | *_amd64.deb |
| aarch64 / arm64 | *_arm64.deb |
| armv7l | *_armhf.deb。まず OS 自体が 32 ビット ARM であることを確認する |
uname と dpkg が示すアーキテクチャは 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を確認できます。ここでシステムとの不一致が見つかった場合は、--force-architectureで強制インストールしないでください。
apt でローカルの DEB をインストールし、依存関係も同時に解決する
アーキテクチャが一致することを確認してから、apt でローカルファイルをインストールします。この方法なら、依存関係が不足している場合に明確なパッケージ名が表示され、後で同じパッケージ管理システムからアンインストールすることもできます。
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 とシステムプロキシだけを検証する
設定をインポートしてシステムプロキシを確認する
リモートサブスクリプションまたはローカル設定をインポートする
Clash Verge Rev 2.x は URL、ローカルファイル、ドラッグ操作によるインポートに対応しています。まず手動で更新してください。
現在の Profile に設定する
ポリシーグループとノードが以前のキャッシュではないことを確認します。
ノードを一つ固定する
Rule モードを維持し、システムプロキシを有効にします。
ブラウザを開いて接続を確認する
ドメイン、ルール、出口がすべて表示されて初めて、デスクトッププロキシが正常と判断できます。
Profilesはどこに保存され、ターミナルではどうプロキシを使う？
ブラウザーは使えるのに apt や Git がタイムアウトする場合、端末がデスクトップのシステムプロキシを読んでいないことがあります。shell は端末のコマンド実行環境で、独自のプロキシ変数が必要です。以下の設定は現在の端末だけに作用し、終了後に解除できます。
Linux の標準の保存先：アプリから開いたディレクトリを基準にする
| 対象内容 | パス |
|---|---|
| verge.yaml | ~/.local/share/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
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export no_proxy="$NO_PROXY"
# 结束测试
# unset HTTP_PROXY HTTPS_PROXY NO_PROXY http_proxy https_proxy no_proxyログイン時の自動起動後も Profile、プロキシ、終了後の復旧は正常？
まず Clash Verge Rev の設定ページで「自動起動」または Auto Launch を有効にします。バージョンによって名称が少し異なる場合があります。これはデスクトップへのログイン後にアプリを起動する設定で、ログイン前からプロキシを利用できるという意味ではありません。権限確認なしに 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 -Ei 'clash.verge|clash-verge'自動起動を実際に一度検証する
まずログアウトし、デスクトップへログインし直す
Clash Verge Rev のプロセスが一つだけ表示され、以前のクライアントが同時に起動していないことを確認します。
現在の Profile とノードを確認する
アプリケーションの起動後も、サブスクリプションが選択済みで、実行時設定が直前に検証したものと同じであることを確認してください。
システムプロキシを確認する
自動的に有効にする設定の場合は、ブラウザからの接続が記録される必要があります。自動処理を望まない場合は、スイッチを無効のままにしてください。
終了後の復元をテストする
アプリケーションメニューから正常に終了した後、Ubuntu の HTTP、HTTPS、SOCKS プロキシがローカルポートを参照しなくなります。
TUNが起動しない、トレイアイコンが出ない、ウィンドウが落ちる場合は、それぞれどこを調べる？
TUN にはサービスと仮想ネットワークインターフェースの権限が必要です。まずシステムプロキシを安定させ、その後で現在のバージョンの設定ページからサービスをインストールしてください。以前のチュートリアルにあるサービススクリプトとインストールディレクトリは変わっている可能性があります。権限または IPC のエラーが発生した場合は、現在の Release と公式 FAQ を先に確認し、別のバージョンに残されたコマンドをそのまま実行しないでください。
システムトレイが表示されない場合は、デスクトップ環境に AppIndicator のサポートがないことがよくあります。ウィンドウがクラッシュする場合は、ターミナルからアプリケーションを起動して stderr を確認してください。どちらもサブスクリプションのノード品質とは関係ありません。
ダブルクリックしてもウィンドウが表示されない
ターミナルから起動して WebKit/グラフィックライブラリのエラーを保存し、現在のデスクトップセッションを確認します。
ブラウザは利用できるが、apt/Git は通信できない
該当するコマンドの環境変数またはツール設定を構成し、TUN は先に有効にしないでください。
TUN のスイッチがすぐに無効へ戻る
サービスのインストールと権限を確認し、DNS とノードを繰り返し変更しないでください。
終了後にブラウザが通信できない
デスクトップのネットワーク設定で残存するプロキシを無効にし、アプリケーションが強制終了されなかったか確認します。