サーバーのインストール¶
この章では、FIRERPA サーバーのインストール方法について説明します。FIRERPA サーバーは最重要コンポーネントであり、最も基本的な基盤サービスです。提供する APP（自動起動対応）、Magisk モジュール（自動起動対応）、または手動によるインストール方法を選択できます。インストールの複雑さはこの順に増します。
重要
デフォルトでインストールされた FIRERPA には認証が設定されていないため、第三者がデバイス上の任意のコンテンツにアクセスできてしまいます。APP を使用してインストールした場合は、設定 で認証を有効にできます。その他の方法でインストールした場合は、サーバー証明書 の章を参照して、証明書の有効化方法を確認してください。認証を有効にしない場合は、必ず信頼できるネットワーク内でのみ使用してください。そうしないと、デバイスが侵害されるリスクが高まります。
APP によるインストール¶
まず最も簡単なインストール方法を紹介します。この方法では特別な操作は不要で、提供する自動インストールおよび自動起動 APK をインストールするだけです。具体的なインストール手順については、クイックスタート の章を参照してください。
注釈
以降の内容は手動デプロイに関するドキュメントであり、サーバーを ROM に組み込んだり、FIRERPA サービスを自分で起動したりする必要がある場合に該当します。APP を使用してサーバーを既に起動しており、該当する要件がない場合は、この章を読む必要はありません。
デバイスアーキテクチャの取得¶
FIRERPA は複数の CPU アーキテクチャをサポートしているため、間違ったバージョンのサーバーをダウンロードすると正常に実行できません。そのため、インストール前に現在のデバイスのアーキテクチャを取得する必要があります。以下のコマンドを実行してください。
getprop ro.product.cpu.abi
最新の実機スマートフォンの場合、このコマンドは通常 arm64-v8a を出力します。エミュレーター（例: 雷电）の場合、エミュレーターを作成する際に 32 ビットまたは 64 ビットの Android システムを選択でき、32 ビットシステムは x86、64 ビットシステムは x86_64 に対応します。一部の Xiaomi の旧型機種では armeabi-v7a となります。この出力値を記憶しておいてください。
サービス設定¶
サービスの起動項目の設定方法については、サービス設定 の章を参照してください。各機能の紹介の中でも関連する内容が説明されています。
Magisk によるインストール¶
お使いのデバイスで Magisk を使用している場合、最も簡単な方法でインストールを完了でき、FIRERPA は起動時に自動起動します。Magisk のバージョンは 20.4 以上が必要で、Magisk App からのインストールのみをサポートしています。
lamda/releases リリースページから lamda-magisk-module.zip をダウンロードし、/sdcard にプッシュします。Magisk App を開き、「モジュール」→「ローカルからインストール」を順にタップし、lamda-magisk-module.zip を選択して、しばらく待ちます。
豆知識
インストール中にエラーが発生して失敗した場合、モジュールの圧縮ファイルが大きすぎることが原因である可能性があります。圧縮ソフトウェアを使用して該当の zip を直接開き、server ディレクトリ内の、必要ないアーキテクチャに対応するサーバーファイルを削除した後、再インストールしてください。解凍してから再圧縮しないでください。
サービス起動時にプロキシを自動設定したり、FRP 転送に接続したりする場合は、サービス設定 の章を参照して該当する設定を作成し、標準の ini 形式の設定ファイルを properties という名前に変更して、モジュールの zip ファイル lamda-magisk-module.zip 内の common フォルダに配置してください。Magisk モジュールのインストール時にサービス証明書を事前に配置する必要がある場合は、サーバー証明書 の章を参照して PEM 証明書を生成し、lamda.pem という名前に変更して、モジュールの common フォルダにドラッグしてください。デフォルトで 組み込み ADB を認証する必要がある場合は、お使いのマシンの adbkey.pub ファイルの内容を adb_keys ファイルに書き込み、common フォルダにドラッグしてください。
注目
圧縮ソフトウェアを使用して lamda-magisk-module.zip を開くことを推奨します。解凍してから再圧縮しないでください。必ず圧縮ソフトウェア内でドラッグ操作により完了するか、モジュール内のファイルディレクトリ階層が一致することを確認してください。そうしないと、モジュールが正常に機能しない可能性があります。
手動インストール¶
リリースページ lamda/releases から最新バージョンの lamda-server-arm64-v8a.tar.gz をダウンロードし、adb push コマンドでファイルをデバイスの一時ディレクトリ /data/local/tmp にプッシュします。
adb push lamda-server-arm64-v8a.tar.gz /data/local/tmp
完了したら、adb shell に入ります。デバイスが root 権限を持っている場合は、まず su コマンドを実行してユーザーを切り替えてください。それ以外の場合は、現在のシェルユーザーで以下のコマンドを順に実行します。
INSTALLDIR=$( [ $(id -u) -eq 0 ] && echo /data/ || echo /data/local/tmp )
echo "Server install directory: $INSTALLDIR/server"
tar -C $INSTALLDIR -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz
注目
一部の古いデバイスでは、システム付属の tar コマンドで .tar.gz ファイルを解凍できない場合があります。そのため、補助として busybox が提供されています。場合によっては、この busybox もダウンロードする必要があります。lamda/releases/tag/v10.0 から busybox-arm64-v8a をダウンロードし、ファイルを一時的に /data/local/tmp にプッシュして、/data/local/tmp/busybox-arm64-v8a tar を使用して解凍してください。
手動起動¶
注目
Magisk または APP でインストールされた FIRERPA は、起動時に自動的に起動します。
ヒント
初回起動時に、リモートデスクトップが読み込み中のままになることがあります。このような状況が発生した場合は、まずデバイスを再起動し、FIRERPA サービスを再起動してみてください。長時間待っても正常に使用できない場合は、この問題を報告してください。
ヒント
FIRERPA サービスは root ユーザーまたは shell ユーザーとして実行できます。すべての機能を使用する必要がある場合は、root ユーザーでサーバーを実行してください。
adb shell に入り、現在のデバイスの状況に応じて shell ユーザーまたは root ユーザーを選択して、以下のコマンドを実行してください。実行後、コマンドの戻りを待ち、llllaamDaa started と出力されれば、サービスが正常に起動し、バックグラウンドモードに入ったことを示します。通常通り adb shell を終了し、FIRERPA サービスにアクセスできます。そうでない場合は、以下のエラーメッセージに従ってトラブルシューティングを行ってください。
sh /data/server/bin/launch.sh
サービスのアンインストール¶
FIRERPA は自身のデータの配置を非常に厳格に管理しており、システム内にファイルを無造作に配置することは決してありません。Magisk でインストールしたユーザーは、モジュールから直接削除できます。APP でインストールしたユーザーは、APP 内のアンインストール機能を使用してアンインストールできます。
危険
これらの機能は慎重に使用してください。これらのディレクトリには FIRERPA サービスの使用に関連するデータが含まれています。アンインストール操作により、FIRERPA と FIRERPA が生成したすべてのデータが完全に削除され、復元できなくなります。
アンインストールする前に、まず サービスの終了 を行い、サービスが正常に終了するのを少なくとも 30 秒待ってください。
rm -rf /data/server /data/usr # /data/local/tmp/usr
これにより、FIRERPA はデバイスから完全に削除されます。実行が完了したら、デバイスの再起動を推奨します。