安装服务端¶
本章介绍如何安装 FIRERPA 服务端,FIRERPA 服务端是最重要的一环,也是最基础的底层服务。您可以选择以 AUTORUN APP 安装(支持开机自启动),Magisk 模块的方式(支持开机自启动)安装、或者手动方式安装。他们的安装难度也分别对应他们的排序。
重要
默认方式安装的 FIRERPA 没有开启任何认证,其他人可以访问设备上的任意内容。请留意启用加密证书的部分选择性启用证书,如您不启用,请务必在可以信任的网络内使用。
注意
由于安全性原因,我们不建议将任何相关文件如服务端或者配置等放在 /data/local 目录下。
通过 APP 安装¶
最简单的我们会在最前面介绍,这个安装方法是最简单的,并不需要您做任何多余的操作,您只需要安装好我们的自动安装和自启动 APK 即可,但是您仍然需要注意,您的手机具备 root 权限(su),并且对于一些国产机型,APK 默认自启动行为可能被禁止,对于这种情况,您可能需要查找相关设置并允许我们的 APK 自启动。
点击下载我们的 FIRERPA 自启动应用 lamda-autorun.apk 安装后,打开 APP 并授权 root 权限,打开自启动开关,等待安装完成后重启设备即可。如果您顺利的完成了,那么您无需继续本章剩余内容。
获取设备架构¶
因为 FIRERPA 支持多种CPU架构,下载错误版本的服务端会无法正常执行,所以安装前,需要获取您当前设备的架构,您可以执行如下命令获取。
getprop ro.product.cpu.abi
通常情况下,对于现时代的真实手机,这条命令输出 arm64-v8a
,而对于模拟器如雷电,会在新建模拟器时选择32或64位版本的安卓系统,
32位模拟器系统对应 x86
,64位则对应 x86_64
,部分小米旧机型则是 armeabi-v7a
,现在请记住这个输出值。
启动配置文件¶
在继续前,我们先提前介绍一下启动配置文件 properties.local。此文件是 FIRERPA 的启动配置文件,通常存储于设备之上,其中包含了 key=value
类型的字符串,通过编写此文件,您可以实现在 FIRERPA 启动时自动连接到 OpenVPN、代理、端口转发等。FIRERPA 在启动时,会从 /data/usr
查找该文件并载入。您可以通过项目中的 properties.local.example
获取可配置项目并酌情选择。
备注
目录 /data/usr 是 FIRERPA 的用户数据目录,首次启动前并不存在,如您需要预置 properties.local 配置,需要您手动创建此目录。
关于如何编写启动配置,在各个功能中也会有相关介绍。
通过 Magisk 安装¶
如果您的设备使用了 Magisk,那么您可以以最简单的方法完成安装,并且 FIRERPA 可以开机自启动。需要确保 Magisk 版本 >= 20.4 且只支持在 Magisk App 中安装。
现在,从 lamda/releases 发布页下载 lamda-magisk-module.zip
,并将其 push 到 /sdcard
,打开 Magisk App,点击 模块->从本地安装,选择 lamda-magisk-module.zip 稍作等待即可。
小技巧
如果中间报错任何 ERROR,并没有正常安装,可能因为我们的模块压缩包太大了。使用压缩软件打开并删除 server 目录中不需要的架构的服务端文件再重新安装,请勿解压再压缩,直接在压缩软件内操作。
刷入成功后,请重启设备。重启后,FIRERPA 应该会在开机时自启动。但是为了避免可能的崩溃问题,lamda 会在 30 秒后启动而不是立即启动,您将有足够的时间去禁用 FIRERPA 模块(请在开机后2分钟再连接使用 FIRERPA)。
您也可以选择自定义配置,例如,您想要所有使用该 magisk 模块刷入后的 FIRERPA 都启用接口加密证书,或者希望这些设备都在启动时自动连接代理,您只需要编写 properties.local 或者生成PEM证书并重命名为 lamda.pem
(请查看 tools/ 中的工具使用方法),随后使用压缩软件打开 lamda-magisk-module.zip
,并将您要设置的(lamda.pem
或者 properties.local
)拖入 common
文件夹即可实现启动时自动配置。
注意
请勿解压再压缩,直接在压缩软件上进行拖拽操作,否则模块将无法正常使用。
安装完成后,您无需再看下段手动安装的内容,跳过即可。
手动安装¶
由于部分老旧设备可能无法通过系统的 tar
命令来解压 tar.gz 后缀的文件,所以提供了 busybox
用来作为补充,您可能需要同时下载提供的 busybox。现在已知设备架构为 arm64-v8a
,现在将设备连接到当前电脑并确保已授权 ADB、可以正常切换 root。
从发布页面 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
,执行 su
切换为 root 身份,随后执行如下命令
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
全部正确无误的执行完后即为安装完毕,请继续查看 启动服务端
章节了解如何启动服务程序。