Debian、Ubuntu、Fedoraでは、それぞれの環境に適したネイティブパッケージを優先してください。対応するパッケージがない場合は、AppImageの動作条件を確認しましょう。LinuxデスクトップにShadowrocketを初めてインストールする方向けに、ディストリビューションとCPUアーキテクチャの確認、ローカルパッケージのインストール、AppImageの起動、依存関係や権限エラーへの対処方法を解説します。
ディストリビューションとCPUアーキテクチャを確認する
Shadowrocketを使うLinuxデスクトップでターミナルを開き、次の2つのコマンドを実行します。1つ目でディストリビューションの識別情報とバージョン、2つ目で現在のカーネルが認識しているマシンアーキテクチャを確認できます。仮想マシンで使う場合は、ホスト側ではなく仮想マシン内で確認して、パッケージを選んでください。
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
システムを確認する
ID=debianまたはID=ubuntuならdeb、ID=fedoraならrpmが対応します。派生ディストリビューションではID_LIKEも参考になりますが、ディストリビューション間の関係を示すもので、パッケージの依存関係が満たされるとは限りません。ダウンロード前に、ページに記載された対応システムも確認してください。アーキテクチャを確認する
x86_64とdebで一般的なamd64は同じ系統のアーキテクチャです。同様に、aarch64と一般的なarm64も同じ系統です。DebianやUbuntuでは、dpkg --print-architectureを実行してパッケージマネージャーが使うアーキテクチャ名を確認できます。対応するビルドがない場合、拡張子を変更したり強制インストールしたりしないでください。ファイルを入手する
クライアントのダウンロードページを開き、Linuxの項目から対応する形式とアーキテクチャを選びます。ダウンロード後、デスクトップのファイルマネージャーで、ブラウザーが実際に使用している保存先を開き、ファイル名を最後まで確認してください。特に拡張子と、同名ファイルを区別するためにブラウザーが付けた番号に注意します。
保存先ディレクトリに移動する
ファイルマネージャーに「この場所でターミナルを開く」機能があれば利用できます。ない場合は、ターミナルで
cdを使って実際の保存先に移動します。pwdとls -lを実行し、場所とファイルを確認してください。以下では例としてlocal.deb、local.rpm、local.AppImageというファイル名を使います。実行時にはダウンロードしたファイルの完全な名前に置き換え、名前に空白がある場合は引用符を付けてください。
Debian/Ubuntu:aptでdebをインストール
パッケージがあるディレクトリで、次のコマンドを実行します。./を付けると、ソフトウェアリポジトリで同名のパッケージを検索するのではなく、現在のディレクトリにあるファイルをaptで処理できます。aptはローカルパッケージの依存関係を調べ、不足分を設定済みのリポジトリから取得しようとします。
dpkg-deb -f "./local.deb" Package Architecture Depends
sudo apt install "./local.deb"
1つ目のコマンドはパッケージ情報を表示するだけなので、パッケージ名、アーキテクチャ、依存関係の確認に使えます。2つ目のコマンドでインストールします。実行を確定する前に、ターミナルに表示される追加・更新・削除対象を確認してください。無関係なパッケージが大量に削除される場合は、操作を中止し、ディストリビューションの互換性とリポジトリの設定を見直しましょう。
- 依存関係を解決できない場合:リポジトリの設定に問題がなければ、まず
sudo apt updateを実行してパッケージ一覧を更新し、インストールをやり直してください。更新後も特定の依存パッケージに候補バージョンがないと表示される場合は、エラーメッセージにあるパッケージ名とバージョン条件を控え、現在のディストリビューションが要件を満たしているか確認します。 - アーキテクチャが一致しない場合:
dpkg-debの出力にあるArchitectureと、dpkg --print-architectureの結果を照らし合わせてください。対応するパッケージを入手して解決しましょう。デスクトップアプリをインストールするために、システムのアーキテクチャ設定を変更しないでください。
Fedora:dnfでrpmをインストール
Fedoraではdnfを使ってローカルのrpmをインストールします。依存関係を確認し、必要なパッケージを有効なリポジトリから取得しようとします。次のrpm -qpはファイル内のメタデータを照会するだけで、システムにはインストールしません。
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "./local.rpm"
sudo dnf install "./local.rpm"
どちらのネイティブパッケージも、それぞれのパッケージマネージャーに登録されます。インストール状態の確認やアンインストールには、ダウンロードしたファイル名ではなく、事前に調べたパッケージ名を使ってください。
debのインストール情報
- パッケージ情報
dpkg-deb -f "./local.deb" Package Architecture- インストール状態を確認
dpkg-query -s 実際のパッケージ名- アンインストールコマンド
sudo apt remove 実際のパッケージ名
コマンド内の「実際のパッケージ名」は、Packageフィールドの値に置き換えてください。
rpmのインストール情報
- パッケージ情報
rpm -qpi "./local.rpm"- インストール状態を確認
rpm -q 実際のパッケージ名- アンインストールコマンド
sudo dnf remove 実際のパッケージ名
コマンド内の「実際のパッケージ名」は、rpm -qpで確認したNAMEに置き換えてください。
dnfで依存関係を解決できないと表示されたら、まずエラーを読み、どのパッケージやライブラリが不足しているか確認します。次にdnf repolist --enabledでリポジトリが有効になっているか調べてください。競合が表示されても、依存関係を無視して強制インストールしないでください。インストール処理が完了しない問題と、アプリが正常にインストールされたのに起動しない問題は別です。
AppImage:実行権限を付与して起動する
対応するdebやrpmがない場合は、アーキテクチャと動作条件が合っていることを確認したうえで、AppImageを試せます。ファイルは、現在のユーザーが書き込み可能で、プログラムの実行も許可されている場所に保存し、固定のディレクトリで管理するのがおすすめです。以下ではu+xを使い、ファイルの所有者だけに実行権限を付与します。これはchmod +xの対象を限定した書き方です。2つのコマンドは一般ユーザーとして実行してください。
chmod u+x "./local.AppImage"
"./local.AppImage"
AppImageはターミナルから直接起動できます。実行権限を設定してもシステムのパッケージとして登録されるわけではなく、アプリケーションメニューに自動で追加されるとも限りません。以下ではShadowrocketの2つの導入方法を比較します。推奨する方法は、ダウンロードページに対応するネイティブパッケージがあることが前提です。
パッケージマネージャーに登録
おすすめaptまたはdnfでインストールすると、パッケージ名を使って状態を確認したりアンインストールしたりできます。リポジトリから更新できないローカルパッケージは、新しいファイルをダウンロードし、同じパッケージマネージャーで再度インストールしてください。
向いているケース:対応するdebまたはrpmがあり、システムのツールでインストール情報を管理したい
ユーザー権限で単独実行
AppImageをファイルの保存場所から直接起動します。新しいファイルに入れ替える前に、実行中のアプリを終了してください。その後、新しいファイルに実行権限を設定します。起動用ショートカットを自分で作成している場合は、新しいファイルの場所を参照するように変更してください。
向いているケース:対応するネイティブパッケージがなく、実行ファイルをユーザーディレクトリに置いて使いたい
インストール後に起動しない場合:エラーから原因を特定
まず、問題がどの段階で起きているかを切り分けます。パッケージマネージャーのインストールが完了しない場合は、インストール処理で最初に表示された具体的なエラーに対処します。インストール状態は正常なのにウィンドウが表示されない場合は、現在のデスクトップセッションで起動し、問題を再現してください。AppImageはターミナルから直接起動できるため、ダブルクリックでは見えないエラーも確認できます。
chmodを実行したのにPermission deniedと表示されるのはなぜ?
まずls -l "./local.AppImage"で、ファイル所有者の権限にxが付いていることを確認します。次にfindmnt -T "./local.AppImage" -o TARGET,OPTIONSでマウントオプションを調べてください。noexecと表示される場所では、ファイルの権限を変更しても実行できません。実行が許可されたユーザーディレクトリに移して、もう一度試してください。システムのマウント設定を変更する必要はありません。
ターミナルにlibfuse.so.2が見つからないと表示されたら?
現在のAppImageの実行時に必要なFUSE 2互換ライブラリが見つからない状態です。まず、ディストリビューションのリポジトリで提供されているパッケージがlibfuse2、libfuse2t64、または別の名称かを確認し、その環境に合ったパッケージ名で互換ライブラリをインストールしてください。既存のFUSE 3コンポーネントは削除しないでください。必要なFUSE機能を使用できない環境では、対応するネイティブパッケージがないか確認するのがおすすめです。
Exec format errorが表示される場合、権限不足?
通常はchmodを繰り返すのではなく、ファイル形式とアーキテクチャを確認します。fileコマンドが使える場合は、file "./local.AppImage"を実行し、uname -mの結果と照らし合わせてください。別のCPUアーキテクチャと認識された場合は、ダウンロードページで適切なものを選び直します。HTML文書と判定された場合は、実行可能なパッケージが保存されていません。ダウンロードをやり直してください。
パッケージはインストール済みなのに、アプリケーションメニューに表示されないのはなぜ?
まず、ログイン中のデスクトップセッションでShadowrocketを検索してください。見つからない場合は、dpkg-query -L 実際のパッケージ名またはrpm -ql 実際のパッケージ名を実行し、パッケージに.desktopの起動項目が含まれているか確認します。リモートターミナルのみの環境やデスクトップセッションのない環境では、インストール情報が正常でもグラフィカルウィンドウは表示されません。AppImageがメニューにない場合は、前のセクションにあるターミナルコマンドで起動してください。