この記事の概要

Linuxデスクトップを使うパソコンで、まずディストリビューションとプロセッサのアーキテクチャを確認します。DebianやUbuntuではシステムに対応したdeb、Fedoraでは対応するrpmを選びます。パッケージマネージャーに登録せず、動作要件を満たしている場合はAppImageも選べます。以下ではインストールまたは起動の手順と、依存関係・実行権限・接続に関する問題の見分け方を説明します。

インストールパッケージの選び方:ディストリビューションとアーキテクチャを確認

Shadowrocketを使うパソコンでターミナルを開きます。仮想マシンを使っている場合は、ホスト側ではなく仮想マシン内で実行してください。1つ目のコマンドでシステム名とディストリビューションの識別情報を表示し、2つ目で現在のシステムが報告するマシンアーキテクチャを確認します。

grep -E '^(PRETTY_NAME|ID|ID_LIKE)=' /etc/os-release
uname -m
システムまたは用途まず確認する形式インストール前の確認事項
Debian、Ubuntudebパッケージが現在のディストリビューションに対応し、必要な依存関係を利用中のソフトウェアリポジトリから取得できること
Fedoraなど、DNFを使用するディストリビューションrpmパッケージが現在のシステムに明確に対応していること。同じ拡張子でも、異なるディストリビューション間で共用できるとは限りません
プログラムをシステムのパッケージマネージャーに登録したくない場合AppImageパッケージのアーキテクチャが一致し、実行可能な場所に保存され、システムが動作要件を満たしていること

x86_64はdebのアーキテクチャ表記では通常amd64、aarch64は通常arm64に対応します。これはアーキテクチャ名の対応を示すもので、ダウンロードページに各アーキテクチャ向けのビルドが必ずあるという意味ではありません。Linuxのダウンロード欄に実際に掲載されているパッケージの中から、システムに合うものを選んでください。別のアーキテクチャ向けのパッケージしかない場合、ファイル名の変更や強制インストールで対処しないでください。ID_LIKEはディストリビューションの系統を示す情報であり、互換性の判断には使えません。

deb・rpmのインストールとAppImageの起動

以下のコマンドはBashを使用する場合の例です。まずファイルマネージャーでダウンロード済みのファイルを確認し、該当するコードブロックを実行してください。ターミナルに入力を求められたら、/から始まるファイルの絶対パスを貼り付けます。手動で引用符を追加する必要はありません。形式は1つだけ選び、すべてを順番に実行する必要はありません。

  1. インストールパッケージの場所を確認する

    ブラウザーのダウンロード一覧を開き、該当する項目からファイルの保存先フォルダーを表示します。ダウンロードが完了していることを確認し、インストールパッケージと一時ダウンロードファイルを見分けてください。ファイルマネージャーの「パスをコピー」機能を使うと、拡張子の入力漏れや、別アーキテクチャ向けの同名ファイルの選択を防げます。

  2. APTでdebをインストール

    apt installはローカルのdebファイルを受け取り、設定済みのソフトウェアリポジトリから依存関係を補います。実行前に処理内容の概要を確認してください。インストールの目的に関係のないパッケージが大量に削除される場合は、いったん中止してください。

    read -r -p 'debファイルの絶対パスを入力してください:' pkg
    sudo apt install -- "$pkg"
  3. DNFでrpmをインストール

    dnf installはローカルのrpmファイルを読み込み、有効になっているリポジトリから依存関係を解決します。自動確認のオプションは追加せず、実行予定の処理を先に確認してください。競合が発生した場合は、エラーに記載されたパッケージ名を控え、依存関係の確認を無効にしてインストールしないでください。

    read -r -p 'rpmファイルの絶対パスを入力してください:' pkg
    sudo dnf install -- "$pkg"
  4. AppImageを起動する

    自分が所有し、プログラムの実行が許可されたディレクトリにファイルを置き、一般ユーザー権限で実行権限を付与して起動します。AppImage自体が起動ファイルです。ターミナルにエラーが表示された場合は、出力を保存し、sudoを使って再試行しないでください。

    read -r -p 'AppImageファイルの絶対パスを入力してください:' pkg
    chmod +x -- "$pkg" && "$pkg"
  5. ウィンドウが開くことを確認する

    debまたはrpmのインストール後、デスクトップのアプリ一覧でShadowrocketを検索します。AppImageは保存場所から起動します。メニューに自動で追加されるとは限りません。ウィンドウが開けば、インストールまたは起動は完了です。ノードやサブスクリプションは利用中のサービス提供元から入手してください。ネットワークテストは設定を終えてから行います。

インストール後の起動・更新・削除

インストール形式によって、プログラムファイルの管理方法が異なります。トラブル対処の前に、パッケージマネージャーでインストールしたプログラムか、個別に保存したAppImageかを確認してください。両方を試した場合は、起動中のウィンドウを閉じてから、起動元を特定して起動します。古いファイルの動作を新しいパッケージの問題と取り違えないようにしてください。

deb / rpm

インストールの管理方法
システムのパッケージマネージャーに登録される
パッケージ名を確認する
ローカルファイルの場合はdpkg-deb -f "$pkg" Packageまたはrpm -qp --queryformat '%{NAME}\n' "$pkg"を使います
更新方法
ローカルからインストールしても、更新用リポジトリが設定されるとは限りません。手動で更新する場合は、現在のシステムに対応した新しいパッケージを使ってください
削除方法
sudo apt removeまたはsudo dnf removeの後に、確認したパッケージ名を指定します。処理内容を確認してから実行してください

削除時に指定するのはパッケージ名で、ダウンロードしたファイル名ではありません。ダウンロード済みパッケージを削除しても、インストール済みのプログラムはアンインストールされません。

AppImage

起動方法
実行権限を付与したAppImageファイル
ファイルの保存場所
実行可能な個人用ディレクトリに保存し、定期的に削除される一時ディレクトリに長期間置かないでください
更新方法
古いプログラムを終了し、新しいファイルに実行権限を付与します。起動できることを確認してから古いファイルを削除してください
削除方法
プログラムを終了してからAppImageファイルを削除します。手動でショートカットを作成している場合は、古い起動項目も削除してください

起動ファイルを削除しても、個人設定は削除されません。パッケージを入れ替えてトラブルを調べるときは、複数の条件を同時に変えないよう、設定を残してください。

よくあるインストールエラー:ターミナルの表示から原因を特定

APTでファイルを処理できないと表示されたら、まず何を確認する?

入力したものがファイルの絶対パスであり、ブラウザーのダウンロードURLではないことを確認してください。pkgには入力済みのパスをそのまま使い、file -- "$pkg"でファイルの種類を確認します。結果がHTMLドキュメントの場合、取得したのはdebではなくWebページの内容です。ダウンロードページに戻ってファイルを取得し直してください。拡張子を変更しても解決しません。

アーキテクチャ不一致やExec format errorが表示されたら?

uname -mを再実行し、ダウンロードしたパッケージのアーキテクチャ表記と照合します。debはdpkg-deb -f "$pkg" Architecture、rpmはrpm -qp --queryformat '%{ARCH}\n' "$pkg"でパッケージ情報を確認できます。アーキテクチャを間違えていた場合は、適切なパッケージを選び直してください。一致している場合は、ファイル形式とダウンロードの完了状況を確認します。

依存関係の不足が表示されたら、ソフトウェアリポジトリを変更するべき?

エラーに表示された最初の未解決依存関係の名前とバージョン条件を控え、パッケージが現在のディストリビューションに対応していることを確認します。DebianまたはUbuntuでは、まずsudo apt updateを実行してリポジトリのインデックスを更新できます。DNFではdnf repolist --enabledで有効なリポジトリを確認します。使用中のディストリビューションの通常のリポジトリで依存関係を満たせない場合、別のディストリビューションのリポジトリを追加しないでください。

AppImageに実行権限を付けてもPermission deniedになるのはなぜ?

ls -l -- "$pkg"で現在のユーザーに実行権限があることを確認し、findmnt -no OPTIONS --target "$pkg"でファイルシステムのマウントオプションを調べます。noexecが表示された場合は、実行が許可された個人用ディレクトリにファイルを移動し、パスを更新してから再試行してください。1つのアプリのためにディスク全体のマウント設定を変更しないでください。

AppImageでlibfuse.so.2が見つからないと表示される。FUSEがインストール済みの場合は?

このエラーはFUSE 2のユーザー空間ライブラリを示しています。FUSE 3がインストール済みでも、システムにlibfuse.so.2があるとは限りません。現在のディストリビューションのリポジトリで、このライブラリを提供する互換パッケージを探し、インストールによって既存のシステムコンポーネントが削除されないことを確認してください。対応する互換パッケージがない場合は、ダウンロードページに掲載された、現在のシステムに対応するdebまたはrpmを使用してください。

ウィンドウは開くのにWebページに接続できない:ルーティングとインストールの問題を切り分ける

ウィンドウが正常に開いたら、ネットワークを確認するために再インストールする必要はありません。まず通常のネットワーク接続で同じテスト用Webページを開けるか確認し、次にクライアントのGlobal Routingを確認してください。以下は、画面にこれらの選択肢がある場合の比較です。切り替え中は、テスト用Webページやほかの設定を変えないでください。

Config

おすすめ

現在の設定ルールに基づいて接続方法を選びます。テストでは、プロキシルールに一致することが分かっているアドレスと、直結する想定のアドレスをそれぞれ選びます。直結するアドレスが開けただけでは、プロキシ経由の接続が使えるかどうかは判断できません。

用途:設定後に、プロキシルールと直結ルールをそれぞれ確認する

Direct

クライアントが処理する通信を、プロキシを経由せず直接接続します。同じアドレスがDirectでは開き、Configでは開かない場合は、インストール形式ではなく、ルールの一致状況と選択中のポリシーを確認してください。テスト後は元のルーティング設定に戻します。

用途:同じテスト用アドレスで直結時の比較を行う