安装服务端

本章介绍如何安装 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 将会从您的设备上彻底移除，执行完成后建议重启设备。