サーバーのインストール¶
この章では、FIRERPA サーバーのインストール方法を説明します。FIRERPA サーバーは最も重要な要素であり、最下層の基盤サービスです。弊社が提供する APP（自動起動対応）、Magisk モジュール（自動起動対応）、または手動でのインストール方法から選択できます。インストールの複雑さは、この順に高くなります。
重要
デフォルトでインストールされる FIRERPA は認証が一切有効化されておらず、他者がデバイス上の任意のコンテンツにアクセスできます。APP を使用してインストール・展開する場合は、設定 で認証を有効にすることを選択できます。それ以外の方法でインストールする場合は、サービス証明書 の章を参照し、証明書の有効化方法を確認してください。有効にしない場合は、必ず信頼できるネットワーク内でのみ使用してください。そうしないと、デバイスへの侵入リスクが高まります。
APP によるインストール¶
まず、最も簡単なインストール方法を紹介します。この方法では余分な操作は一切不要で、弊社の自動インストールおよび自動起動 APK をインストールするだけです。具体的なインストール手順は クイックスタート の章を参照してください。
注釈
以降の内容は手動展開に関するドキュメントで、サーバーを ROM に組み込んだり、FIRERPA サービスを自前で起動したりする場合に適しています。APP を使用して既にサーバーを起動しており、そのような要件がない場合は、この章を読み進める必要はありません。
デバイスアーキテクチャの取得¶
FIRERPA は複数の CPU アーキテクチャをサポートしているため、誤ったバージョンのサーバーをダウンロードすると正常に実行できません。そのため、インストール前に現在のデバイスのアーキテクチャを取得する必要があります。以下のコマンドを実行します。
getprop ro.product.cpu.abi
最新の実機スマートフォンの場合、通常このコマンドは arm64-v8a を出力します。エミュレーター（たとえば LDPlayer）では、新規作成時に 32 ビットまたは 64 ビットの Android システムを選択でき、32 ビットは x86、64 ビットは x86_64 に対応します。一部の旧型 Xiaomi 端末では armeabi-v7a となります。この出力値を覚えておいてください。
サービス設定¶
サービスの起動項目の設定方法については サービス設定 の章を参照してください。各機能の説明の中でも関連する内容が触れられています。
Magisk によるインストール¶
Magisk を使用しているデバイスであれば、最も簡単な方法でインストールでき、FIRERPA を自動起動させることができます。Magisk のバージョンは 20.4 以上が必要で、Magisk アプリからのインストールにのみ対応しています。
lamda/releases のリリースページから lamda-magisk-module.zip をダウンロードし、/sdcard に転送します。Magisk アプリを開き、「モジュール」→「ストレージからインストール」を順にタップし、lamda-magisk-module.zip を選択してしばらく待つだけで完了します。
豆知識
エラーが表示されてインストールに失敗した場合、モジュールの圧縮パッケージが大きすぎる可能性があります。圧縮ソフトウェアを使用して直接その zip を開き、server ディレクトリ内の不要なアーキテクチャに対応するサーバーファイルを削除してから再インストールしてください。決して解凍後に再圧縮しないでください。
サービス起動時に自動的にプロキシを設定したり、FRP 転送を組み込んだりしたい場合は、サービス設定 の章を参照して設定を作成し、標準的な ini 形式の設定ファイルを properties という名前に変更して、モジュールの zip ファイル lamda-magisk-module.zip 内の common フォルダに配置します。Magisk モジュールのインストール時にサービス証明書を事前に配置する必要がある場合は、サービス証明書 の章に従って PEM 証明書を生成し、lamda.pem という名前に変更して、この lamda.pem もモジュールの common フォルダにドラッグします。同様に、組み込み ADB をデフォルトで認証させる必要がある場合は、手元の adbkey.pub ファイルの内容を adb_keys ファイルに書き込み、それを common フォルダにドラッグします。
注目
lamda-magisk-module.zip は圧縮ソフトウェアで開くことを推奨します。解凍してから再圧縮しないでください。必ず圧縮ソフトウェア内でドラッグ操作を行い、モジュール内のファイル構成をそのままにしてください。さもないとモジュールが正常に動作しない可能性があります。
手動インストール¶
一部の古いデバイスでは、システム付属の tar コマンドで .tar.gz ファイルを解凍できないことがあります。そのため、busybox を補助ツールとして提供しています。場合によってはこの busybox も同時にダウンロードする必要があります。デバイスアーキテクチャが arm64-v8a であると想定し、デバイスをコンピューターに接続して ADB が許可されていることを確認します。
リリースページ lamda/releases から lamda-server-arm64-v8a.tar.gz と busybox-arm64-v8a をダウンロードし、それらのファイルを一時的に /data/local/tmp に転送します。
adb push lamda-server-arm64-v8a.tar.gz /data/local/tmp
adb push busybox-arm64-v8a /data/local/tmp
完了したら、adb shell へ入ります。デバイスが root 権限を持っている場合は、まず su コマンドを実行してユーザーを切り替えます。持っていない場合は、現在のシェルユーザーのまま以下のコマンドを実行できます。
chmod 755 /data/local/tmp/busybox-arm64-v8a
/data/local/tmp/busybox-arm64-v8a tar -C /data -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/busybox-arm64-v8a
すべてのコマンドが正しく実行されれば、インストールは完了です。
手動起動¶
注目
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 でインストールしたユーザーは、アプリ内のアンインストール機能を使用してアンインストールできます。
危険
これらの機能は十分に注意して使用してください。これらのディレクトリには FIRERPA サービスの利用に関連するデータが含まれています。アンインストール操作は FIRERPA 本体とそれが生成したすべてのデータを完全に削除し、復元はできません。
アンインストール前に、まず サービスの終了 を行い、少なくとも 30 秒待ってサービスが正常に終了したことを確認してください。
rm -rf /data/server /data/usr # /data/local/tmp/usr
これにより FIRERPA はデバイスから完全に削除されます。実行後、デバイスの再起動をお勧めします。