安裝伺服器端¶

本章介紹如何安裝 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；部分小米舊機型則為 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，請勿解壓後再壓縮，務必直接在壓縮軟體內透過拖曳操作完成，或者務必確保模組內檔案目錄層級一致，否則模組可能無法正常使用。

手動安裝¶

從發布頁面 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 指令切換身份；否則可直接使用目前 shell 身份執行以下指令：

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

錯誤輸出	說明
already running	服務已在運行
not run as root/shell	請使用 root 或者 shell 身份執行
unsupported sdk	不支援此 Android 系統版本
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 將會從您的裝置上徹底移除，執行完成後建議重新啟動裝置。