安装服务端¶
本章介绍如何安装 LAMDA 服务端,LAMDA 服务端是最重要的一环,也是最基础的底层服务。同样,也可能有一些需要您注意的安全问题。默认方式安装的 LAMDA 没有开启任何认证,其他人可以访问设备上的任意内容。请特别留意启用接口认证(加密证书)的部分,务必在可以信任的网络内使用。并且注意,即使开启了接口认证(加密证书),任何有权限登录远程桌面以及使用API的人仍然对您的设备有着完全的访问权限。由于安全性原因,我们不建议将任何相关文件放在 /data/local/*
目录下。
您可以选择以 Magisk 模块的方式(支持开机自启动)安装或者手动方式安装。
获取设备架构¶
因为 LAMDA 支持多种CPU架构,下载错误版本的服务端会无法正常执行,所以安装前,需要获取您当前设备的架构,您可以执行如下命令获取。
getprop ro.product.cpu.abi
通常情况下,对于现时代的真实手机,这条命令输出 arm64-v8a
,而对于模拟器如雷电,会在新建模拟器时选择32或64位版本的安卓系统,
32位模拟器系统对应 x86
,64位则对应 x86_64
,部分小米旧机型则是 armeabi-v7a
,现在请记住这个输出值。
启动配置文件¶
在继续前,我们先提前介绍一下启动配置文件 properties.local,您可能会不解,出现这种情况您也可以不必看。
此文件是 LAMDA 的启动配置文件,通常存储于设备之上,其中包含了 key=value
类型的字符串,
通过编写此文件,您可以实现在 LAMDA 启动时自动连接到 OpenVPN、代理、端口转发等。
LAMDA 在启动时,会从 /data/usr
查找该文件并载入(此目录在 LAMDA 首次启动前并不存在,所以根据实际情况您可能需要手动创建)。
您可以通过项目中的 properties.local.example
获取可配置的项目并酌情选择设置。
关于如何编写启动配置,在各个功能中也会有相关介绍。
通过 Magisk 安装¶
如果您的设备使用了 Magisk,那么您可以以最简单的方法完成安装,并且 LAMDA 可以开机自启动。需要确保 Magisk 版本 >= 20.4 且只支持在 Magisk App 中安装。
现在,从 lamda/releases 发布页下载 lamda-magisk-module.zip
,并将其 push 到 /sdcard
,打开 Magisk App,点击 模块->从本地安装,选择 lamda-magisk-module.zip 稍作等待即可。
如果中间报错任何 ERROR,并没有正常安装,请使用压缩软件打开并删除 server 目录中不需要的架构的服务端文件并重新安装。
刷入成功后,请重启设备。重启后,LAMDA 应该会在开机时自启动。但是为了避免可能的崩溃问题,lamda 会在 30 秒后启动而不是立即启动,您将有足够的时间去禁用 LAMDA 模块(请在开机后2分钟再连接使用 LAMDA)。
您也可以选择自定义配置,例如,您想要所有使用该 magisk 模块刷入后的 LAMDA 都启用接口认证(certificate 加密证书),或者希望这些设备都在启动时自动连接代理,您只需要编写 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 身份,随后执行如下命令
# 确保上传的 busybox 可执行
chmod 755 /data/local/tmp/busybox-arm64-v8a
# 解包服务端文件到 /data/server
/data/local/tmp/busybox-arm64-v8a tar -C /data -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz
# 删除安装包以及 busybox
rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/busybox-arm64-v8a
现在,您以安装完毕,请继续查看 启动服务端
章节了解如何启动服务程序。