LinuxデスクトップにShadowrocketをインストールする方向けの記事です。ご利用のサービス事業者とサブスクリプションをすでにお持ちの方を対象としています。まずディストリビューションとCPUアーキテクチャを確認し、deb・rpm・AppImageから適切な形式を選びます。インストール後は、アプリの起動、サブスクリプションの追加、リクエストの接続を個別に確認し、インストールの問題と設定の問題を切り分けましょう。
1. ディストリビューション・アーキテクチャ・パッケージ形式を確認する
deb・rpm・AppImageはLinuxの異なるソフトウェア配布形式であり、プロキシプロトコルの違いではありません。ディストリビューションで使われているパッケージマネージャーを確認し、ダウンロードページに記載されたアーキテクチャと動作要件を照合して選びます。ファイルの拡張子を.rpmから.debに変更しても、パッケージ形式は変換されず、アーキテクチャの不一致も解消しません。
ターミナルを開き、次のコマンドを実行します。/etc/os-releaseでディストリビューションを、uname -mでアーキテクチャを確認できます。それぞれを個別に確認し、デスクトップの見た目だけで判断しないでください。
cat /etc/os-release
uname -m
| インストール形式 | 主な対象環境 | インストール方法 | 注意点 |
|---|---|---|---|
| deb | Debian、Ubuntu、およびaptを使う派生ディストリビューション | aptでローカルファイルをインストール | パッケージマネージャーに登録され、依存関係は設定済みのソフトウェアリポジトリから解決されます。 |
| rpm | Fedora、およびdnfを使うディストリビューション | dnfでローカルファイルをインストール | rpm形式を使うディストリビューションが、すべてdnfを使うとは限りません。 |
| AppImage | 該当ファイルの動作要件を満たすLinuxデスクトップ | 実行権限を付与して起動 | CPUアーキテクチャ、システムライブラリ、FUSE、マウントオプションの影響を受けます。 |
たとえば、x86_64はダウンロードページのx64またはamd64に、aarch64はarm64に対応することが一般的です。これはアーキテクチャ名の対応関係を示すもので、すべての組み合わせを当サイトが提供しているという意味ではありません。利用可能なファイルは全プラットフォームのダウンロードページでご確認ください。アーキテクチャが合わない場合、実行権限を何度も付け直しても解決しません。
2. ファイルをダウンロードし、インストール前の情報を控える
ダウンロードページでLinuxを選び、ディストリビューションに合った形式を指定します。この記事で案内するファイルの入手先は当サイトのダウンロードページです。インストールパッケージのURLを自分で組み立てる必要はありません。ダウンロードしたファイルの保存先と正確なファイル名を控えておきましょう。インストールやトラブルシューティング、パッケージ情報の確認に使います。
-
システムを確認する
ターミナルを開き、前のセクションにある2つのコマンドを実行して、ディストリビューション名とアーキテクチャを控えます。リモートターミナルのシステムが、現在デスクトップを使用しているシステムと同じとは限りません。操作対象を確認してください。
-
形式を選ぶ
全プラットフォームのダウンロードページを開き、Linuxの項目を確認します。aptを使うシステムではdeb、dnfを使うシステムではrpmを選びます。AppImageを使う場合は、事前に対応する動作要件を確認してください。
-
ファイルのパスを控える
ファイルマネージャーでファイルのプロパティを開き、実際の絶対パスをコピーします。以下のターミナル操作でパスを入力する際、余分な引用符を付けたり、ホームディレクトリを未展開のチルダで置き換えたりしないでください。
-
入手元を確認する
当サイトのダウンロードページから入手したファイルであり、ダウンロードが完了していることを確認します。ブラウザーの一時ダウンロード用拡張子が付いたままの場合は、完了するまで待ってください。拡張子を手動で削除して無理に実行しないでください。
3. deb・rpm・AppImageをそれぞれインストールする
以下のコマンドはBashで実行します。選択した形式に対応するものを、1回につき1組だけ実行してください。コマンドではファイルの実際のパスを入力し、インストールパッケージのファイル名は指定しません。変数の外側にある二重引用符は、パスに空白が含まれる場合に必要です。インストール前に、起動中のShadowrocketを終了してください。
deb:aptでローカルファイルと依存関係を処理する
DebianやUbuntuなど、aptを使う環境で次のコマンドを実行します。ファイルの絶対パスを入力した後、aptが表示するインストール・アップグレード・削除の内容を確認してから、続行するか判断してください。依存関係のエラーを回避するために、強制インストールのオプションを使わないでください。
read -r -p "debファイルの絶対パスを入力してください: " pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
dpkg-debはパッケージ名とアーキテクチャを表示します。選択したファイルが正しいか確認する際に利用できます。aptで依存関係が見つからないと表示された場合は、まずシステムのソフトウェアリポジトリが利用可能か確認してください。パッケージインデックスを更新する必要がある場合は、sudo apt updateを実行してから再度試します。インデックスの更新はシステム全体のアップグレードではなく、非対応のディストリビューション要件を自動で解決するものでもありません。
rpm:dnf環境でローカルファイルをインストールする
Fedoraなどdnfを使うシステムでは、次のコマンドを実行できます。まずパッケージ情報を読み取り、その後dnfで依存関係を解決します。rpm形式を使っていてもdnfを使わないシステムでは、そのディストリビューションのパッケージ管理方法に従ってください。コマンドをそのまま使うために、パッケージマネージャーを変更する必要はありません。
read -r -p "rpmファイルの絶対パスを入力してください: " pkg
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
nothing providesと表示された場合は、続けて表示される依存パッケージ名を確認し、システムの対応条件と有効なリポジトリを照合してください。依存関係を無視するオプションで、インストール状態だけを強制的に成功にしないでください。パッケージが登録されても、アプリの実行に必要なライブラリが揃っているとは限りません。
AppImage:実行権限を付与して起動する
ファイルを、通常のユーザーがアクセスでき、不要に削除されない場所に置いてから次のコマンドを実行します。AppImageはaptやdnfに登録されないため、初回起動時にパッケージマネージャーの更新・アンインストール機能が自動で用意されることはありません。
read -r -p "AppImageファイルの絶対パスを入力してください: " pkg
chmod u+x "$pkg"
"$pkg"
chmod u+xはファイルの所有者にだけ実行権限を追加します。すべてのユーザーに書き込み権限を付与する必要はありません。- 普段の起動には一般ユーザーを使ってください。ウィンドウが表示されないからといって、グラフィカルアプリ全体を
sudoで実行しないでください。 - 正常に実行できたらファイルをそのまま保管します。デスクトップショートカットを自分で作成する場合は、実際の保存先を起動対象に指定してください。
- AppImageにはアプリケーションのファイルをまとめられますが、データもすべて同じディレクトリに保存される、またはシステム依存関係がすべて含まれているとは限りません。
4. 初回起動後、設定と接続を分けて確認する
ウィンドウが開いても、アプリが起動したことを示すだけで、サブスクリプション、サーバー、ルーティングルールの設定が完了したとは限りません。初回確認では、Home、Config、Settingsの順に各画面の役割を確認します。Homeでは接続とサーバー、Configでは使用中の設定、Settingsでは関連項目を確認してください。システムネットワークの許可を求められた場合は、内容を確認してから承認します。
アプリ内の確認項目
- Home
- 追加済みのサーバーと現在選択されているサーバーを確認します。
- Config
- 有効な設定ファイルとRuleセクションを確認します。
- Global Routing
- 現在のモードがConfig、Proxy、Directのどれかを確認します。
- Connectivity Test
- 選択中のサーバーへの接続を確認してから、実際のリクエストをテストします。
設定は一度に1つだけ変更し、変更前の状態を記録して結果を比較できるようにします。
システム側の確認項目
- CPUアーキテクチャ
- uname -mの出力を、ダウンロードページに記載されたアーキテクチャと照合します。
- システム時刻
- タイムゾーンと日付を確認します。大きくずれているとTLS検証に影響することがあります。
- ネットワーク環境
- まず通常のネットワークと、ログインが必要なネットワーク認証ページが利用できることを確認します。
- サーバーのポート
- サービス事業者の案内に従って入力します。すべてのプロトコルで443を使うと決めつけないでください。
システムがインターネットに接続できることと、プロキシ接続が使えることは別の確認項目です。相互に代用できません。
サブスクリプションをお持ちの場合は、Homeの右上にある「+」から追加画面を開き、TypeでSubscribeを選びます。サービス事業者から入手したサブスクリプションURLを入力して保存してください。続けてサブスクリプションを更新し、Homeにサーバーが表示されることを確認します。通常、サブスクリプションの更新はサーバー情報を取得し直すための操作です。Config内のルーティングルールがすべて置き換わるとは限りません。
手動で追加する場合、Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuardでは入力する項目が異なります。サービス事業者から提供されたプロトコル、アドレス、ポート、認証情報を個別に入力してください。サブスクリプションURLを特定のプロトコルのサーバーアドレスとして使わないでください。トラブルシューティング情報を共有する際は、サブスクリプショントークン、パスワード、Private Keyを隠してください。
5. Global Routingでインストールの問題とルーティングの問題を切り分ける
インストール後、一部のWebサイトだけ開けない場合は、すぐに再インストールせず、まずGlobal Routingを確認します。以下で説明するのはShadowrocket内での処理方法です。対象となるのは、実際にアプリで処理される通信に限られます。Proxyに切り替えても、システム内のすべてのプロセスが必ず対象になるわけではありません。
Config
推奨現在の設定に従ってリクエストを処理します。Ruleセクションの順序とポリシーを確認し、対象ドメインに最終的にどのルールが適用されるかを調べます。ルール設定が正しい場合の日常的な使用に適しています。
適した用途:ドメインとアドレスに基づく通常のルーティング。
Proxy
アプリで処理されるリクエストをプロキシ経由で処理します。一部のルーティングルールの影響を一時的に切り分ける際に使えます。切り替え後に状況が変わった場合も、それだけでシステムのインストール不良と判断せず、設定を引き続き確認してください。
適した用途:ルールとポリシー選択の短時間の切り分け。
Direct
リクエストを直接接続として処理し、プロキシサーバーを経由しません。元のネットワーク状態の確認に使えます。このモードでプロキシが必要な宛先に接続できなくても、サーバーが利用できない証拠にはなりません。
適した用途:直接接続とプロキシ接続の違いの確認。
Configでは、DOMAIN-SUFFIXはドメインのサフィックスに、IP-CIDRはIPアドレスの範囲に、GEOIPはIPアドレスの所在地に基づいて照合します。FINALは最終的なフォールバックルールです。ルールは通常、上から順に評価されます。対象が先にあるルールに一致している場合、後続のルールを変更しても、そのリクエストの判定結果は変わりません。変更前に現在の設定をバックアップし、一時的な診断設定は確認後に元に戻してください。
6. 初回起動時によくあるエラーと対処の順序
トラブルシューティングでは、エラーメッセージ全文と発生手順を記録し、「開かない」だけで済ませないでください。以下はLinuxでのインストールと実行時によくある問題の分類ですが、すべてのディストリビューションで発生するわけではありません。まずファイルの実行と依存関係を確認し、次にアプリの設定、最後に具体的なリクエストを検証します。
AppImageでPermission deniedと表示されます。ダウンロード後はどうすればよいですか?
まず実際のファイルに対してchmod u+x "$pkg"を実行し、同じターミナルから起動します。それでも失敗する場合は、findmnt -T "$pkg" -o TARGET,OPTIONSを実行して、保存先のファイルシステムにnoexecが設定されていないか確認します。設定されている場合は、実行可能なユーザーディレクトリにファイルを移動してください。システムのマウント設定を直接変更しないでください。
Exec format errorが表示されます。実行権限が足りないのでしょうか?
多くの場合、権限ではなくファイル形式やアーキテクチャの確認が必要です。uname -m、ダウンロードページに記載されたアーキテクチャ、file "$pkg"の出力を照合してください。fileの結果がHTMLドキュメントの場合、エラーページなどを取得した可能性があります。ダウンロードページに戻って正しいファイルを入手してください。
AppImageでlibfuse.so.2が見つからないと表示されます。何をインストールすればよいですか?
まずエラーメッセージ全文を記録し、ご利用のディストリビューションにあるパッケージ検索ツールで、該当ファイルを提供するFUSE互換ランタイムを探してください。パッケージ名はディストリビューションやバージョンによって異なる場合があります。既存のFUSE関連コンポーネントを安易に削除しないでください。適切な依存関係をインストールした後、一般ユーザーとしてターミナルから起動します。
アイコンをクリックしてもウィンドウが表示されません。原因を確認するには?
AppImageは前の手順で設定したパス変数を使い、ターミナルから直接起動できます。debまたはrpmの場合は、デスクトップランチャーのプロパティで実際の起動コマンドを確認してから、ターミナルで実行します。不足しているライブラリ、グラフィカルセッション、権限に関する出力を記録してください。実行ファイル名を推測したり、セキュリティ機能を安易に無効化したりしないでください。
インストールは成功したのに、サブスクリプションを更新できないのはなぜですか?
まず通常のネットワークが使えること、システム時刻が正しいこと、サブスクリプションURLに空白や改行が混入していないことを確認し、サービス事業者側で有効な状態かも確認してください。特定のサブスクリプションだけ失敗する場合は、まずURLとネットワーク経路を調べます。アプリを再インストールしても、無効なトークンが修復されることは通常ありません。
7. 更新・削除の前に情報をバックアップする
今後の更新でも当サイトのダウンロードページから、同じアーキテクチャに対応した適切な形式のファイルを入手してください。debとrpmは通常、パッケージメタデータに基づいて各パッケージマネージャーがアップグレードを処理します。AppImageはアプリを終了してから新しいファイルに置き換え、実行権限とショートカットのパスを再確認します。ダウンロードフォルダーにファイルを置くだけで自動的に更新されるとは限りません。
- 更新前に、自分で編集したConfigファイルをバックアップし、有効な設定とGlobal Routingの状態を記録します。
- サービス事業者から受け取った元の設定情報を保管してください。バックアップに含まれるサブスクリプションURL、パスワード、キーは機密情報として取り扱います。
- debまたはrpmを削除する場合は、まず実際のパッケージ名を調べます。その後、aptまたはdnfの削除コマンドを使い、確認対象を読んでから実行してください。
- AppImageファイルを削除しても、ユーザー設定が消えるとは限りません。データを整理する場合は実際の保存場所を確認し、推測したパスにあるディレクトリをまとめて削除しないでください。
- 更新後は「アプリを起動 → Homeを確認 → Configを確認 → リクエストをテスト」の順に再確認すると、どの段階で変化したかを特定しやすくなります。
形式選びの基本は、現在のシステムの管理方法に合わせることです。apt環境では対応するdeb、dnf環境では対応するrpmを使います。AppImageを選ぶ場合は、ファイルの保存先、実行権限、動作に必要な依存関係をご自身で確認してください。インストール後、利用中のサービス事業者から提供された情報に基づいて、サブスクリプションと接続を設定します。