Shadowrocket Linux版のインストール方法｜deb・rpm・AppImageの選び方とapt・dnfコマンド

1. ディストリビューション・アーキテクチャ・入手方法を確認

DebianやUbuntuではdeb、Fedoraではrpmとdnfを使うのが一般的です。システムのパッケージデータベースに登録せず使いたい場合は、AppImageも選択肢になります。パッケージ形式とプロセッサアーキテクチャは別々に確認してください。拡張子が合っていても、プログラムが現在のCPUに対応しているとは限りません。

全プラットフォームのダウンロードページからLinuxの項目に進み、ページに実際に掲載されているパッケージとアーキテクチャを選んでください。Linux版は無料です。iPhone / iPad版はApp Storeで2.99ドルの買い切り、Mac（Appleシリコン・Intel）、Windows、Android版も無料です。iPhone / iPadのシステム要件はApp Storeの掲載内容をご確認ください。

1. システムを確認

   ターミナルを開いて cat /etc/os-release を実行し、ID、ID_LIKE、PRETTY_NAMEを確認します。デスクトップの見た目だけでディストリビューションを判断しないでください。同じデスクトップ環境でも、異なるパッケージ体系を使っている場合があります。

2. アーキテクチャを確認

   uname -mを実行します。出力がx86_64なら一般的な64ビットIntel / AMDアーキテクチャ、aarch64なら64ビットARMです。ダウンロードページで対応が明記されているファイルを選んでください。

3. パッケージを選択

   ダウンロードページのLinux項目から、ディストリビューションに適した形式を選びます。rpmを使うからといって、必ずdnfを使うとは限りません。ほかのrpm系ディストリビューションでは、各システムのパッケージマネージャーの説明に従い、Fedora向けのコマンドをそのまま使わないでください。

4. ファイルの保存場所を確認

   ブラウザーのダウンロード履歴からファイルの保存先を開き、ダウンロードが完了していることを確認します。以下のコマンドは、ファイルが$HOME/Downloadsにあることを前提としています。別のダウンロード先を使っている場合は、コマンド内のディレクトリを実際の場所に置き換えてください。

cat /etc/os-release
uname -m

2. Debian / Ubuntu：aptでdebをインストール

ローカルのdebをapt installでインストールする場合、ファイルはパスとして指定します。相対パスの先頭に付ける./は省略できません。省略すると、aptが入力をパッケージ名として扱う場合があります。aptは有効なソフトウェアソースから依存関係を取得できますが、古いディストリビューションにプログラムが必要とするライブラリがすべて揃うとは限りません。

以下のコマンドはBashで実行します。ダウンロードフォルダー内のdebを一覧表示し、番号で実際のファイルを選択するため、ファイル名を決め打ちする必要はありません。フォルダー内に別のソフトウェアのインストールパッケージがある場合もあります。本站からダウンロードしたShadowrocketのファイルを選んでください。一致するファイルがなければ、インストールは実行されません。

(
  cd "$HOME/Downloads" || exit 1
  shopt -s nullglob
  packages=(./*.deb)
  if ((${#packages[@]} == 0)); then
    printf '%s\n' 'このディレクトリにdebファイルがありません。ダウンロード先を確認してください。'
    exit 1
  fi
  PS3='Shadowrocketのdebファイルに対応する番号を入力してください：'
  select pkg in "${packages[@]}"; do
    if [[ -n "$pkg" ]]; then
      sudo apt install "$pkg"
      break
    fi
    printf '%s\n' '一覧にある有効な番号を入力してください。'
  done
)

• まずトランザクションの概要を確認：インストール、アップグレード、削除される項目を確認します。予期しない大量の削除が表示された場合は、nを入力して中止し、ディストリビューションの互換性を確認してください。そのまま確定しないでください。
• 依存関係のダウンロードに失敗した場合：システムのソフトウェアソースが利用可能か確認します。必要に応じてsudo apt updateを実行してインデックスを更新し、同じファイルで再試行してください。インデックスを更新しても、互換性のないパッケージが互換性のあるものに変わるわけではありません。
• 依存関係を解決できない場合：具体的な依存パッケージ名と必要条件を記録し、現在のディストリビューションがダウンロードページでサポートされているか確認します。別のディストリビューションのソフトウェアソースを安易に追加したり、依存関係を強制的に無視したりしないでください。
• インストールが完了したら：デスクトップのアプリケーションメニューからShadowrocketを検索します。インストールコマンドが成功したことと、GUIプログラムが起動することは別々に確認してください。

3. Fedora：dnfでrpmをインストール

Fedoraではdnfを使ってローカルのrpmをインストールでき、依存関係や競合を同じトランザクション内で確認できます。拡張子が同じでも、別のディストリビューション向けにビルドされたrpmが使えるとは限りません。ライブラリ名、依存条件、デスクトップとの連携方法が異なる場合があります。

(
  cd "$HOME/Downloads" || exit 1
  shopt -s nullglob
  packages=(./*.rpm)
  if ((${#packages[@]} == 0)); then
    printf '%s\n' 'このディレクトリにrpmファイルがありません。ダウンロード先を確認してください。'
    exit 1
  fi
  PS3='Shadowrocketのrpmファイルに対応する番号を入力してください：'
  select pkg in "${packages[@]}"; do
    if [[ -n "$pkg" ]]; then
      sudo dnf install "$pkg"
      break
    fi
    printf '%s\n' '一覧にある有効な番号を入力してください。'
  done
)

アーキテクチャの不一致、依存関係の競合、パッケージ検証エラーが発生した場合は、トランザクションを中止し、表示されたメッセージをすべて保存してください。検証を省略したり、ファイルを強制的に上書きしたりするオプションは追加しないでください。ターミナルに同じパッケージがすでにあると表示された場合も、現在のインストール状態を先に確認します。接続の失敗を解決するためにインストールコマンドを繰り返さないでください。

4. AppImage：実行権限を付与して起動

AppImageは通常、単一の実行ファイルとして動作するため、debやrpmのようなインストールトランザクションへの登録は不要です。ただし、システム依存関係が一切不要という意味ではありません。プロセッサアーキテクチャ、グラフィカル環境、ランタイムライブラリ、マウント条件によって起動できない場合があります。ダウンロードフォルダーの整理で起動ファイルを失わないよう、長期保存する場所に移してから使ってください。

以下のコマンドもBashで実行します。選択したファイルに、現在のユーザーの実行権限だけを付与して、同じユーザーとして起動します。ダウンロードフォルダー全体に再帰的に権限を付与したり、グラフィカルプログラム全体をsudoで起動したりしないでください。

(
  cd "$HOME/Downloads" || exit 1
  shopt -s nullglob
  packages=(./*.AppImage)
  if ((${#packages[@]} == 0)); then
    printf '%s\n' 'このディレクトリにAppImageファイルがありません。ダウンロード先を確認してください。'
    exit 1
  fi
  PS3='ShadowrocketのAppImageファイルに対応する番号を入力してください：'
  select pkg in "${packages[@]}"; do
    if [[ -n "$pkg" ]]; then
      chmod u+x -- "$pkg" && "$pkg"
      break
    fi
    printf '%s\n' '一覧にある有効な番号を入力してください。'
  done
)

• Permission deniedが表示される場合：ファイルの実行権限と保存先のパーティションを確認します。chmod u+xを実行済みでも、noexecマウントオプションのパーティションでは実行できないことがあります。実行可能なユーザーディレクトリに移して再試行してください。
• libfuse.so.2関連のエラーが表示される場合：通常、FUSE 2互換ライブラリが不足しています。Debian / Ubuntuでは、まずapt-cache policy libfuse2 libfuse2t64を実行して、このディストリビューションで利用可能なパッケージを確認してください。その後、ディストリビューションの説明に従って対処し、別のシステムのライブラリ名をそのまま使わないでください。
• Exec format errorが表示される場合：uname -mの結果と、ダウンロードページに記載されたアーキテクチャを確認してください。実行権限を付与しても、アーキテクチャの不一致は解消されません。
• ダブルクリックしてもウィンドウが表示されない場合：まずターミナルからファイルを実行し、エラーを確認します。GUIセッションのないリモートターミナルから起動した場合は、権限を何度も変更するのではなく、ローカルのデスクトップセッションで確認してください。

5. 初回起動：インストールと接続を分けて確認

ウィンドウが開けば、プログラムの起動は確認できています。接続できるかどうかは、利用者自身の設定、ネットワーク、名前解決、選択したポリシーにも左右されます。当サイトではノードやサブスクリプションを提供、販売、推奨していません。接続タイムアウトだけで、インストールパッケージの不具合と判断しないでください。

1. 通常ユーザーで起動していることを確認：アプリケーションメニューまたはAppImageからShadowrocketを起動します。プログラムから必要なシステム権限を求められた場合は、表示内容を一つずつ確認してください。クライアント全体をあらかじめrootで実行しないでください。
2. 手元の接続情報を準備：サービス提供元から案内されたアドレス、ポート、プロトコル、認証情報を確認します。利用中のサブスクリプションを読み込む場合、URLは認証情報として扱い、公開の問い合わせ内容に貼り付けないでください。
3. 設定箇所を確認：Homeで既存の接続項目、Configで使用する設定、Settingsで関連項目を確認します。各プラットフォームで表示される選択肢は、現在の画面に実際に表示されている内容に従ってください。
4. ルーティングの状態を確認：画面にGlobal Routingがある場合、現在の状態がConfig、Proxy、Directのどれか確認します。Directは、プロキシが動作しているかどうかを判断するための設定ではありません。
5. 一つずつテスト：同じ接続先を使ってテストし、一度に変更する項目は一つにします。接続前後のタイムアウト、名前解決エラーの有無、特定の接続先だけ失敗するかを記録してください。プロトコル、ルール、DNSを同時に変更しないでください。

ルールの動作を確認する場合は、Configで以下の最小限のルール例を使って適用順を確認できます。example.comは説明用のドメインで、接続先のアドレスではありません。PROXYは現在の設定で利用可能なポリシーに対応させてください。この例で既存の完全な設定を上書きしないでください。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

ルールは上から順に照合され、一致した行のポリシーが適用されます。FINALは末尾に置き、一致しなかったリクエストを処理します。上の例は192.168.0.0/16だけを使ってLANへの直接接続を示しており、すべてのプライベートアドレスを対象にするものではありません。no-resolveは、そのIPルールのためにドメイン名を積極的に解決しない指定です。あらゆるDNS問題を解決する設定ではありません。

6. Global Routing：目的に応じてテスト時の状態を選ぶ

インストール後のトラブルシューティングでは、ルーティングの状態を使って原因の範囲を絞り込みます。特定の状態が常に優れていると判断するためのものではありません。以下の比較はShadowrocket自体の設定に関するものです。実際に制御される通信の範囲は、プラットフォームの権限やネットワーク接続方法にも左右され、システムの全通信を無条件に制御するという意味ではありません。

7. よくある質問：エラーが発生した段階ごとに対処

問い合わせの前に、問題がダウンロード、パッケージマネージャーでのインストール、プログラムの起動、接続のどの段階で起きたか確認してください。「開かない」とだけ説明するより、エラー全文、ディストリビューション名、プロセッサアーキテクチャを添えると役立ちます。ログを共有する前に、認証情報、サブスクリプションURL、個人のアドレスを削除してください。