LinuxデスクトップにShadowrocketをインストールする方向けのガイドです。まずディストリビューションとCPUアーキテクチャを確認し、ダウンロードページから適切な形式を入手します。debとrpmはシステムのパッケージマネージャーでインストールし、AppImageは実行権限を付与して起動します。最後にアプリの起動、既存のサブスクリプションの読み込み、Global Routingをそれぞれ確認し、インストールの問題と接続の問題を切り分けます。
ディストリビューション・アーキテクチャ・デスクトップ環境を確認
インストール形式はデスクトップのテーマではなく、ディストリビューションのパッケージ管理方式で決まります。同じGNOME環境でも、Ubuntuでは通常deb、Fedoraではrpmを選びます。ほかのディストリビューションではAppImageも選択肢になりますが、CPUアーキテクチャ、システムライブラリ、デスクトップ環境の条件に左右されます。すべてのLinuxシステムでそのまま動作するわけではありません。
cat /etc/os-release
uname -m
1つ目のコマンドでID、ID_LIKE、PRETTY_NAMEを確認し、2つ目でマシンのアーキテクチャを調べます。一般にx86_64はx64、aarch64はARM64に対応します。ダウンロード時はページに実際に掲載されているアーキテクチャを選んでください。deb、rpm、AppImageの拡張子を変更してもファイル形式は変わらず、アーキテクチャの不一致も解消されません。
- Debian / Ubuntu:debを選び、aptでローカルファイルをインストールします。利用可能なソフトウェアソースから依存関係も解決できます。
- Fedora:rpmを選び、dnfでインストールします。openSUSEもrpm形式ですが、パッケージ管理にはzypperを使います。
- その他のデスクトップディストリビューション:対応するAppImageがあるか確認してから、実行条件をチェックしてください。
- コマンドライン専用サーバー:この記事で扱うのはデスクトップアプリのインストールです。GUIプログラムをバックグラウンドサービスと同じものとして扱うことはできません。グラフィカルセッションがない環境では、ウィンドウが表示されないだけでインストールの破損と判断しないでください。
ダウンロード後、4つの手順で準備
以下のコマンドに記載したファイル名は入力しやすくするための例であり、本サイトのインストールファイルの固定名ではありません。ダウンロードが完了したら、ファイルマネージャーで該当する名前に変更してからコマンドを実行してください。元の名前を維持する場合は、ファイルをターミナルにドラッグしてフルパスを入力することもできます。ブラウザーでダウンロード中の一時ファイルをインストールファイルとして扱わないでください。
-
システムを確認
cat /etc/os-releaseとuname -mを実行し、ディストリビューションとアーキテクチャを確認します。Debian系ではdpkg --print-architectureを使って、パッケージマネージャーが使用するアーキテクチャ名を調べることもできます。 -
ファイルを入手
Linuxダウンロード欄を開き、ページに掲載されている形式とアーキテクチャに合ったファイルをダウンロードします。拡張子を変更してインストール形式を変えることはできません。
-
ファイルの場所を整える
ファイルを
~/Downloadsに置き、形式に合わせてShadowrocket.deb、Shadowrocket.rpm、またはShadowrocket.AppImageに名前を変更します。ダウンロードフォルダーの名前が異なる場合は、実際のパスを使ってください。 -
インストールして起動
選んだ形式に対応するコマンドだけを実行してください。debとrpmはインストール後にアプリメニューから起動します。AppImageはファイルを直接実行します。初回のトラブルシューティングに備え、ターミナルの出力を残しておきましょう。
deb・rpm:システムのパッケージマネージャーでインストール
ローカルパッケージのパスに付ける./には意味があります。現在のディレクトリにあるファイルをパッケージマネージャーに読み込ませ、ソフトウェアソースからパッケージ名で検索するのを防ぎます。インストールにはsudoで権限を付与しますが、日常的なGUIアプリの起動は一般ユーザーで行ってください。デスクトップ上での操作全体をrootで実行しないでください。
| ディストリビューション | ローカルパッケージのインストールコマンド | 説明 |
|---|---|---|
| Debian / Ubuntu | sudo apt install ./Shadowrocket.deb |
aptでローカルパッケージを処理し、ソフトウェアソースから取得できる依存関係を解決します。 |
| Fedora | sudo dnf install ./Shadowrocket.rpm |
まず処理内容の概要を確認し、インストールまたは変更されるパッケージをチェックしてください。 |
| openSUSE | sudo zypper install ./Shadowrocket.rpm |
同じrpm形式でも、依存関係の名称や利用可否は異なる場合があります。 |
Debian / Ubuntuでの操作
cd ~/Downloads
dpkg-deb -f ./Shadowrocket.deb Package Architecture Depends
sudo apt install ./Shadowrocket.deb
dpkg-deb -fはパッケージ内のメタデータを読み取るコマンドで、アプリをインストールするものではありません。aptからソフトウェアソースのインデックスが古いと表示された場合は、sudo apt updateを実行してから再試行してください。アーキテクチャのエラーが表示された場合は、正しいアーキテクチャを選び直し、強制インストールのオプションは追加しないでください。依存関係を解決できない場合は、依存パッケージ名とシステムのバージョンを記録し、システムの中核ライブラリを安易に削除しないでください。
Fedora / openSUSEでの操作
cd ~/Downloads
rpm -qp --queryformat '%{NAME} %{ARCH}\n' ./Shadowrocket.rpm
# Fedora
sudo dnf install ./Shadowrocket.rpm
# openSUSE:このコマンドを使い、上のdnfコマンドは実行しない
sudo zypper install ./Shadowrocket.rpm
rpmはパッケージ形式であり、rpmを使うすべてのディストリビューションで同じ実行環境が使われるとは限りません。パッケージマネージャーから依存関係を利用できないと明確に表示されたら、まずダウンロードページの対応条件を確認してください。依存関係を無視して、起動時のエラーにつながる状態を残さないでください。インストール完了は、ファイルと登録情報がシステムに追加されたことを示すだけで、設定やネットワーク接続が確認できたわけではありません。
AppImage:実行権限を付与してターミナルから起動
AppImageは通常、debやrpmのようにシステムのパッケージデータベースへ登録されません。ファイル単体で保存され、初回の実行前に実行権限を付与する必要があります。ファイルを移動または削除すると、既存のショートカットが使えなくなることがあります。自動削除されるダウンロードフォルダーに置いたままにせず、決まったディレクトリに保存することをおすすめします。
mkdir -p "$HOME/Applications"
mv "$HOME/Downloads/Shadowrocket.AppImage" "$HOME/Applications/"
cd "$HOME/Applications"
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage
ファイルの実行条件
- 保存先ディレクトリ
~/Applications- 権限の確認
ls -l ./Shadowrocket.AppImage- 起動方法
./Shadowrocket.AppImage- 実行ユーザー
- 現在のデスクトップにログイン中の一般ユーザー
chmodのu+xはファイル所有者に実行権限を追加します。すべてのユーザーに書き込みを許可する必要はありません。
起動エラーの切り分け
- Permission denied
- 実行権限とマウントオプションnoexecを確認してください。
- Exec format error
- ファイル形式とCPUアーキテクチャを確認してください。
- FUSE関連のエラー
- ディストリビューションのドキュメントで、対応する互換ランタイムを確認してください。
- 接続エラーが表示される
- 有効なデスクトップのグラフィカルセッション内で実行しているか確認してください。
AppImageによって実行条件は異なります。今回の起動時に表示されたエラーをもとに対処してください。
chmodが成功したのに権限不足と表示される場合は、findmnt -T ./Shadowrocket.AppImageでファイルシステムのマウント情報を確認してください。リムーバブルディスクや制限付きディレクトリではnoexecが設定されていることがあります。ファイルを実行可能なユーザーディレクトリに移すのが先決です。1つのアプリのためにディスク全体の制限を緩める必要はありません。FUSE関連のエラーが出た場合、別のディストリビューションでのライブラリ名をそのまま使ったり、システム全体をすぐにアップグレードしたりしないでください。
初回起動:設定を読み込んでからGlobal Routingを確認
ウィンドウが表示されたら、インストールはほぼ完了です。次に、ご自身の設定に沿って操作します。Homeではサーバーとサブスクリプション、Configではルール設定、Settingsではクライアントの設定を管理します。インストール形式で設定が代替されることはなく、接続可能なサービスが自動で提供されるわけでもありません。
- Homeで「+」をクリックし、TypeをSubscribeに設定します。ご自身がすでにお持ちのサブスクリプションURLを入力して保存してください。読み込み後にサブスクリプションを更新し、想定した項目が一覧に表示されることを確認します。サブスクリプションURLにはアクセス認証情報が含まれることが多いため、公開スクリーンショットに載せないでください。
- Homeで既存の項目を選択し、Connectivity Testを実行します。失敗した場合は、アドレス、ポート、認証情報、現在のネットワークを確認してください。インストールが成功しただけでは、リモート接続が可能とは判断できません。
- Configでご自身のルール設定を読み込み、選択したうえでGlobal Routingを確認します。初回の接続確認は手動で行ってください。自動接続が必要な場合は、Settings → On Demandで別途設定できます。この設定はプロトコルのパラメーターやルーティングルールの代わりにはなりません。
Global Routing → Config
推奨現在有効なConfigのルールに基づいてポリシーを選択します。ルールが有効で、参照先のポリシーが存在することを確認してから、実際のリクエストで適用結果をチェックしてください。
適した用途:設定済みのルールを使った日常的な通信の振り分け
Global Routing → Proxy
クライアントが処理する接続を、選択したプロキシ経由に統一して経路を確認できます。これだけでシステム内のすべてのプロセスの通信がクライアント経由になったとは判断できません。
適した用途:ルールによる振り分けの影響を一時的に除外
Global Routing → Direct
クライアントが処理する接続を直接接続にして、ローカルネットワークの到達性とプロキシ経路の問題を切り分けます。プロキシサーバーが正常かどうかを確認する方法ではありません。
適した用途:ローカルネットワークが利用できるか比較確認
現在の画面にSceneがある場合は、選択中のシーンの条件とポリシーを確認してください。SceneはConfigと同じものではありません。設定を変更したらリクエストを再実行し、ブラウザーに残った古い接続で新しい設定を判断しないようにしましょう。ルールの構文やDNSを確認する場合は、引き続きトラブルシューティングガイドをご覧ください。
インストール・アップデート・起動時によくある問題
aptでファイルが見つからないと表示されるのはなぜですか?
pwdとls -lを実行して、現在のディレクトリとファイル名が一致していることを確認します。Linuxではファイル名の大文字と小文字が区別されます。ローカルファイルのインストールには./を付けてください。パスに空白が含まれる場合は、パス全体を引用符で囲みます。
インストール後、アプリメニューにアイコンが表示されない場合は?
まず、パッケージマネージャーの処理が正常に完了したことを確認してください。debではdpkg-deb -f ./Shadowrocket.deb Packageで実際のパッケージ名を調べ、その後dpkgでインストール状態とファイル一覧を確認できます。rpmではパッケージのメタデータから名称を特定できます。実行ファイル名を推測したり、メニューにアイコンがないことを接続障害と同一視したりしないでください。
AppImageをダブルクリックしても起動しない場合は?
ターミナルでファイルのあるディレクトリに移動し、./Shadowrocket.AppImageを実行して最初のエラーを確認してください。実行権限、アーキテクチャ、ランタイム、グラフィカルセッションの問題を切り分けます。ウィンドウは表示されるのに接続できない場合は、Homeで既存の設定を確認してください。
次回のアップデート後もサブスクリプションを再読み込みする必要がありますか?
アップデート前にConfigと必要な設定をバックアップし、ご自身のサブスクリプションURLも安全に保管してください。debとrpmは、新しいパッケージを使って同じ手順でインストールします。AppImageはアプリを終了してからファイルを置き換え、実行権限を再確認してください。パッケージの更新とサブスクリプション内容の更新は別の操作です。アップデート後は、選択中の設定と接続状態も確認しましょう。
3種類の形式を同時に残しておけますか?
トラブルシューティング中に複数のコピーを同時に実行するのはおすすめしません。メニュー項目、デスクトップのショートカット、手動起動で別々のファイルが開くことがあり、変更が反映されたか判断しにくくなります。現在使用している形式を確認し、ほかのプロセスを終了してください。不要なパッケージは元のパッケージマネージャーでアンインストールし、使わなくなったAppImageファイルは削除します。