安裝服務端¶

本章介紹如何安裝 FIRERPA 服務端。FIRERPA 服務端是最重要的一環，也是最基礎的底層服務。您可以選擇透過我們提供的 APP（支援開機自啟動）、Magisk 模組（支援開機自啟動）或手動方式進行安裝。它們的安裝複雜度依序遞增。

重要

預設安裝的 FIRERPA 沒有開啟任何認證，其他人可以存取裝置上的任意內容，如您使用 APP 安裝部署，您可以在配置中選擇開啟認證。其他方式安裝請留意服務憑證章節，瞭解如何啟用憑證。如您選擇不啟用，請務必在可信任的網路內使用，否則會增加裝置被入侵風險。

透過 APP 安裝¶

首先介紹最簡單的安裝方式。這種方式無需任何多餘操作，您只需安裝好我們的自動安裝和自啟動 APK 即可。具體的安裝流程請參照快速開始章節。

備註

後續內容為手動部署相關文件，適用於您需要將服務端內建到 ROM 或者自行啟動 FIRERPA 服務的情況，如您已使用 APP 啟動了服務端並且無相關需求則無需再檢視本章節。

取得裝置架構¶

由於 FIRERPA 支援多種 CPU 架構，下載錯誤版本的服務端將無法正常執行。因此，安裝前需要取得目前裝置的架構。您可以執行以下命令：

getprop ro.product.cpu.abi

對於現代的真實手機，該命令通常輸出 arm64-v8a；而對於模擬器（如雷電），在新建模擬器時可以選擇 32 位元或 64 位元的安卓系統，32 位元系統對應 x86，64 位元系統對應 x86_64；部分小米舊機型則為 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 目錄下不需要的架構所對應的服務端檔案後重新安裝，切勿解壓縮後再重新壓縮。

刷入成功後，請重新啟動裝置。重新啟動後，FIRERPA 服務會在開機 30 秒後才啟動而非立即啟動，請在開機 1~2 分鐘後再嘗試連接 FIRERPA。

如果您希望在服務啟動時自動設定代理或接入 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 命令切換身分；否則可直接使用目前 shell 身分執行以下命令：

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

錯誤輸出	說明
already running	服務已經在執行
not run as root/shell	請使用 root 或者 shell 身分執行
unsupported sdk	不支援此安卓系統版本
abi not match	使用了錯誤架構的 tar.gz 套件
file broken	檔案損壞，請重新安裝

解除安裝服務¶

FIRERPA 對於自身資料的規劃非常規範，絕對不會在您的系統中隨意放置檔案。Magisk 安裝的使用者直接在模組中移除即可，APP 安裝的使用者則可使用 APP 內的解除安裝功能來解除安裝。

危險

請謹慎使用相關功能，這些目錄包含著您使用 FIRERPA 服務的相關資料，解除安裝操作會完全移除 FIRERPA、FIRERPA 產生的所有資料且不可恢復。

解除安裝前請先退出服務，並等待至少 30 秒以確保服務正常退出。

rm -rf /data/server /data/usr # /data/local/tmp/usr

這樣 FIRERPA 將會從您的裝置上徹底移除，執行完成後建議重新啟動裝置。