LinuxデスクトップでShadowrocketを使う準備ができている方向けの記事です。まずディストリビューションとCPUアーキテクチャを確認し、当サイトのダウンロードページからdeb、rpm、AppImageを選んで、実際のファイルパスを指定してインストールします。最後に、アプリの起動、サブスクリプションの読み込み、通信のプロキシ経由化をそれぞれ確認します。コマンドでは特定のインストーラーファイル名や、端末のプロキシポートを決め打ちしません。
1. ディストリビューション・アーキテクチャ・パッケージ形式を確認
deb、rpm、AppImageはアプリの配布形式であり、プロキシプロトコルの種類ではありません。形式を選ぶ際は、まずシステムのパッケージ管理ツールを確認し、次にダウンロードページに記載されたアーキテクチャを確認します。DebianとUbuntuでは通常deb、Fedoraではrpmを選びます。その他のディストリビューションでは、AppImageの動作要件を満たしているか確認してください。ファイルを展開できても、別のパッケージ管理方式向けのソフトウェアを適切にインストールできるとは限りません。
ターミナルで次の2つのコマンドを実行します。1つ目はディストリビューションの識別情報、2つ目はマシンのアーキテクチャを確認します。デスクトップの見た目だけで判断しないでください。同じデスクトップ環境を使っていても、基盤となるディストリビューションやパッケージ形式が異なる場合があります。
cat /etc/os-release
uname -m
システム情報
- NAME / ID
- /etc/os-releaseでディストリビューションを確認します。
- ID_LIKE
- ディストリビューションの系統を確認するための参考情報です。互換性の説明に代わるものではありません。
- uname -m
- x86_64とaarch64は異なるCPUアーキテクチャです。
パッケージ形式とアーキテクチャの両方を確認してください。拡張子だけでは判断できません。
ダウンロードと実行
- deb
- aptでローカルファイルをインストールし、依存関係を解決します。
- rpm
- Fedoraではdnfでローカルファイルをインストールします。
- AppImage
- 実行権限を付与し、現在のデスクトップユーザーで起動します。
ダウンロードページで実際に提供されている形式とアーキテクチャを選び、パッケージ形式の変換は行わないでください。
インストールファイルはすべてダウンロードガイドのLinuxセクションから入手できます。インストーラーは当サイトの/dl/ダウンロード機能から提供されます。この記事のコマンドをもとにダウンロードURLを組み立てないでください。Shadowrocketはクローズドソースの商用アプリです。iPhone / iPad版はApp Storeから入手でき、$2.99の買い切りです。Mac(Appleシリコン・Intel)、Windows、Android、Linux版は無料です。
2. Debian / Ubuntu:aptでローカルのdebをインストール
以下のコマンドはBashで実行します。1行目でダウンロード済みファイルの完全なパスを対話形式で入力します。入力時に余分な引用符は付けないでください。後続のコマンドでは二重引用符がパス内の空白を保護します。まずパッケージのメタデータを確認し、その後インストールします。ここではローカルファイルを指定するため、同名のソフトウェアを検索することはありません。
read -r -e -p "ダウンロード済みdebファイルの完全なパスを入力: " pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb --field "$pkg" Package Architecture Depends
dpkg --print-architecture
sudo apt install "$pkg"
Packageはパッケージ内部の名前で、ファイル名と異なる場合があります。以降の検索やアンインストールにはこのフィールドを使い、ダウンロードしたファイル名をそのまま指定しないでください。Architectureがシステムと互換性のあることを確認します。一般的にamd64はx86_64、arm64はaarch64に対応します。表記が違っても、アーキテクチャが異なるとは限りません。Dependsには依存条件が記載されています。aptは設定済みのソフトウェアソースから依存関係を解決します。実行前に処理内容を確認し、特に他のソフトウェアを削除する予定がないか注意してください。
完全なパスを指定するのは、aptにローカルファイルを処理させるためです。パスなしでソフトウェア名だけを指定すると、ソフトウェアソースからパッケージを検索する意味になります。dpkg -iだけを実行するより、aptでローカルのdebをインストールすれば、同じ処理内で依存関係を解決しやすくなります。ただし、端末からソフトウェアソースにアクセスでき、依存条件を満たせる必要があります。
Unable to locate packageと表示された場合は、指定したものが実際のファイルパスか確認してください。依存関係を解決できない場合は、ディストリビューションとの互換性とソフトウェアソースの状態を確認します。依存関係を強制的に無視してエラーを回避したり、インストール処理が完了していないのに成功と判断したりしないでください。
3. Fedora:dnfでローカルのrpmをインストール
rpmパッケージも、まずアーキテクチャとパッケージ情報を確認します。以下はFedoraのdnf環境を対象としています。rpmを使う他のディストリビューションでは、パッケージ管理コマンドや依存関係が異なる場合があります。拡張子が同じという理由だけで互換性があると判断しないでください。
read -r -e -p "ダウンロード済みrpmファイルの完全なパスを入力: " pkg
pkg="$(realpath -- "$pkg")"
rpm -qpi "$pkg"
rpm -qp --requires "$pkg"
uname -m
sudo dnf install "$pkg"
rpm -qpiは未インストールのパッケージファイル情報を表示し、rpm -qp --requiresは必要な機能や依存関係を一覧表示します。dnfでインストールする場合は、トランザクションの概要を確認してから実行してください。ローカルパッケージをダウンロードしても、依存関係がすべてダウンロード済みとは限りません。依存関係の解決には、端末で設定済みのソフトウェアソースへのアクセスが必要になる場合があります。
- アーキテクチャ非対応と表示された場合は、ダウンロードページに戻ってアーキテクチャを再確認してください。強制インストールのオプションで回避しないでください。
- 依存関係が不足している場合は、依存パッケージの名前をすべて記録し、ソフトウェアソースとシステムの対応状況を確認してください。不明な配布元から共有ライブラリを個別に追加しないでください。
- 処理が完了してもランチャーに表示されない場合は、デスクトップのアプリ一覧を閉じて開き直し、パッケージが実際にインストールされているか確認します。デスクトップのインデックス更新の問題とインストール失敗を切り分けてください。
4. AppImage:実行権限の付与はシステムへのインストールとは別
AppImageは通常、1つの実行ファイルとして保持し、aptやdnfで一般的なパッケージとして登録しません。長期間保存する場所にファイルを移動してから、実行権限を付与してください。一時ダウンロードフォルダーから起動すると、後でフォルダーを整理した際に、元の起動パスが使えなくなります。
read -r -e -p "ダウンロード済みAppImageファイルの完全なパスを入力: " app
app="$(realpath -- "$app")"
file -- "$app"
chmod u+x -- "$app"
"$app"
chmod u+xはファイルの所有者に実行権限を追加します。最後の行は現在のユーザーでアプリを起動し、診断情報を現在のターミナルに表示します。デスクトップアプリの起動時に、安易にsudoを付けないでください。依存関係のインストールに必要な管理者権限と、アプリを日常的に実行するユーザー権限は別のものです。
Permission deniedと表示された場合は、まずls -lで実行権限を確認し、次にファイルのあるパーティションがnoexecオプションでマウントされていないか確認してください。実行権限を付与しても、マウント時の制限は回避できません。- エラーにFUSEまたは
libfuse.so.2が含まれる場合、現在のAppImageをマウントして実行するための条件が満たされていません。お使いのディストリビューションのパッケージ情報に従って、必要な実行時依存関係をインストールしてください。パッケージ名はディストリビューションによって異なる場合があります。 Exec format errorと表示された場合は、まずダウンロードしたアーキテクチャが正しいか確認してください。ファイルの判定結果が想定した実行ファイルと異なる場合は、インストールファイルを再取得してください。- ウィンドウが表示されない場合は、ターミナルに出力された内容をそのまま保存してください。AppImageはあらゆる環境に対応する互換レイヤーではありません。グラフィカルセッション、システムライブラリ、安全ポリシーが起動に影響する場合があります。
安全機能を無効にすることを一般的な解決策にしないでください。また、AppImageが必ずデスクトップアイコンを自動作成したり、ログイン時に起動するよう登録されたりするとは限りません。こうした連携機能の有無は、実際の画面とインストール結果で確認してください。
5. 初回起動:インストール・サブスクリプション・接続を分けて確認
ウィンドウが表示されても、アプリが起動したことしか確認できません。サブスクリプションが利用可能か、アプリの通信がプロキシ経由になっているかは別途確認が必要です。以下の手順は、利用者自身がサービス事業者とサブスクリプションを用意していることを前提とします。当サイトではノードやサブスクリプションを提供・販売・推奨していません。クライアントのインストールと通信サービスは別のものです。
-
起動を確認
デスクトップランチャーからShadowrocketを起動します。AppImageの場合は、まずターミナルから実行してください。Homeが表示されることを確認してから接続を設定し、アプリの終了とネットワークのタイムアウトを混同しないようにします。
-
サブスクリプションを読み込む
Home右上の「+」からTypeをSubscribeに設定し、利用者自身が用意したサブスクリプションURLを入力して保存します。例の
https://example.com/sub?token=xxxxはダミー値であり、実際の接続には使えません。 -
設定を確認
Homeで更新後に項目が表示されることを確認し、Configで現在使用中の設定を確認してから、Global Routingを確認します。ノード一覧の読み込みとルール設定の有効化は別の操作です。
-
通信を確認
接続を有効にして、同じアプリから同じアドレスにアクセスし、タイムアウトや名前解決エラーの有無を比較して記録します。ブラウザーだけが使えてターミナルのツールが使えない場合は、各プログラムのプロキシ設定と環境変数を確認してください。
Linuxデスクトップアプリがシステムプロキシに従う方法は、アプリによって異なります。HTTPまたはSOCKSプロキシを設定する場合は、端末で実際に待ち受けているアドレスとポートを確認し、インターネット上にある固定値をそのまま使わないでください。アプリが該当する通信の取り込み方式を明示的に提供し、有効にしている場合に限り、その方式に沿って切り分けます。「接続」がオンでも、すべてのプロセスの通信が取り込まれるわけではありません。
6. Global Routing:ルールと接続の問題をモードで切り分ける
インストール形式を変えてもGlobal Routingの意味は変わりません。切り分けの際はテスト対象と接続項目を固定し、一度に変更する設定は1つだけにしてください。以下の比較はShadowrocketの処理経路に入った通信を対象とするもので、システム内のすべてのプログラムを自動的に対象とするものではありません。
Config
推奨現在の設定に含まれるルールに従って接続方針を決定します。DOMAIN-SUFFIX、IP-CIDR、GEOIPなどのルールの優先順位と、最終フォールバックとなるFINALの方針を確認してください。Configでは、どのルールにも一致しない通信が必ずDirectになるわけではありません。
適した用途:ルール設定を使った日常的な利用。
Proxy
処理経路に入った通信を、Configのドメインやアドレスルールで振り分けず、選択したプロキシ方針に送ります。Configと結果が異なる場合は、ルールの一致状況と方針の選択を確認してください。
適した用途:一時的にプロキシ接続の問題とルールの問題を切り分ける。
Direct
処理経路に入った通信をDirect方針で接続します。他のプログラムに個別設定されたプロキシは無効にならず、テスト対象に現在のネットワークからアクセスできることを保証するものでもありません。
適した用途:Directの状態と比較し、テスト対象に到達できるか確認する。
設定にDOMAIN-SUFFIX,example.com,DIRECTが含まれている場合は、該当するドメインを使ってテストしてください。IPアドレスに直接アクセスすると、そのドメインルールに一致しないことがあります。Sceneを使う場合は、設定したシーン条件と対応する方針に沿って確認し、固定のグローバルプロキシモードとして扱わないでください。診断後は通常の設定に戻し、一時的なテストがその後の判断に影響しないようにします。
7. 更新・アンインストール・よくあるインストールの問題
debとrpmはパッケージ管理ツールにインストール状態が記録されますが、ローカルファイルを手動でインストールしても、Shadowrocketを自動更新するソフトウェアソースが追加されたことにはなりません。更新する際は当サイトのダウンロードページに戻り、現在のシステムに合ったパッケージを取得して、同じパッケージ管理ツールで処理してください。AppImageは通常、実行中のファイルを置き換えて更新します。古いデスクトップショートカットが以前のパスを参照していないかも確認してください。
debをインストールしたのに自動更新されないのはなぜですか?
該当する更新元がシステムに設定されているか確認してください。ローカルのdebをインストールしただけでは、更新元があるとは限りません。手動で更新する場合は、ダウンロードページからファイルを再取得し、実際の完全なパスを指定してsudo apt installを実行し、トランザクションの概要を確認してください。
アンインストール時に指定するパッケージ名は?
debではdpkg-deb --field "$pkg" Package、rpmではrpm -qp --queryformat '%{NAME}\n' "$pkg"で名前を確認します。表示された実際の名前をapt removeまたはdnf removeに指定してください。ファイル名から推測しないでください。
AppImageを削除すると設定も消えますか?
必ずしもそうではありません。アプリ本体とユーザー設定は別々に保存されることが多く、AppImageを削除しても設定が消えるとは限りません。設定も整理する場合は、アプリに用意された設定管理機能を使い、ユーザー設定をバックアップしてください。保存場所を推測してユーザーディレクトリ内のファイルを一括削除しないでください。
アプリは起動するのに、サブスクリプションが空のままなのはなぜですか?
まずHomeでSubscribeタイプとして保存したことを確認します。URLが完全か、意図しない空白が含まれていないか、更新時にエラーが出ていないかも確認してください。利用中のサービス事業者にURLの状態を問い合わせる際は、公開スクリーンショットにtokenが写らないようにします。debやrpmを入れ替えても、無効なサブスクリプションURLは修復できません。
問題を報告する際は、ディストリビューション名、uname -mの出力、使用した形式、失敗した段階、ターミナルに表示されたエラーを記録してください。サブスクリプションURL、パスワード、PrivateKeyなどは機密情報です。ログを送信する前に削除してください。「Linuxで使えない」とだけ伝えるより、「パッケージ管理ツールでインストールに失敗」「AppImageの起動に失敗」「起動後の接続に失敗」のように状況を特定すると、原因を調べやすくなります。