在 Android 上安装 Localtonet
本页内容 9 个章节
Localtonet 应用可以把 Android 手机或平板变成你账户中的一台设备。你可以从 Google Play 或以 APK 文件安装它,用二维码、PIN 或令牌登录,然后在控制台中为这部手机创建并启动隧道。
开始之前 #
- 一个 Localtonet 账户。如果还没有,请免费创建一个。
- 一部 Android 手机或平板。该应用要求的最低 Android 版本为 5.0(API 级别 21)。
- 手机使用的令牌。请在我的令牌下用创建令牌创建一个,并起一个便于识别的名称。每部手机请使用单独的令牌。
安装应用 #
| 来源 | 下载 | 说明 |
|---|---|---|
| Google Play | Google Play 上的 Localtonet | Google Play 会安装应用并使其保持最新。 |
| APK 文件 | localtonet-mobile.apk | 适用于没有 Google Play 的设备。Android 会要求你允许用打开该文件的浏览器或文件管理器安装应用。 |
| APK 文件(.zip) | localtonet-mobile.zip | 同一个 APK,放在 ZIP 压缩包中。先解压,再打开 APK。 |
同样的三种选择也在下载页面的 Android 下。
登录 #
应用打开后显示 Sign in to Localtonet 界面,其中有一个字段 Authtoken or PIN,旁边有一个扫描按钮,以及 Connect 按钮。你可以用三种方式登录。二维码和 PIN 来自控制台。
-
在控制台中打开连接对话框 #
在另一台设备上,打开我的令牌,选择这部手机的令牌旁边的二维码按钮。它的提示文字是通过二维码或 PIN 连接 Android 应用。连接设备对话框会打开,其中包含二维码、PIN 和令牌。
-
用二维码、PIN 或令牌登录 #
方式 在控制台中 在应用中 扫描二维码 让二维码保持显示在屏幕上。 点按字段旁边的扫描按钮,并把相机对准二维码。应用首次会请求相机权限。令牌会显示在字段中。 改为输入 PIN 查看 6 位 PIN。对话框会倒计时显示 PIN 还剩多久有效。过期后请选择生成新 PIN。 把 PIN 输入字段。 复制令牌 复制令牌并发送到手机,或者直接在手机上打开控制台。 把令牌粘贴到字段中。如果剪贴板中有令牌或 PIN,应用会在界面打开时或你点按字段时自动填入。 PIN 的有效期为一分钟,并且只能使用一次。
-
选择 Connect #
点按 Connect。应用会显示
Checking...,完成登录并切换到主界面。在我的令牌下,该令牌现在显示为在线。
请保管好你的令牌和 PIN。它们允许 Localtonet 应用以此设备的身份连接。
控制台上的设置向导提供同样的登录方式:在其最后一步,Android 标签页会显示令牌;当向导在电脑上打开时,还会显示二维码,并提示扫码即可在手机上获取 AuthToken。
应用显示的内容 #
登录后,应用会显示令牌的名称、连接状态和手机的 IP 地址,一个包含隧道数量、延迟、上传和下载的概览,以及运行在这部手机上的隧道列表。当列表显示 No active tunnels 时,请在控制台中为该令牌创建并启动隧道,参见快速入门。
| 控件 | 作用 |
|---|---|
| Sign Out | 要求确认后断开连接,从应用中移除令牌,并返回登录界面。 |
| Quit Localtonet | 要求确认后停止隧道并关闭应用。此后应用不会自行启动,直到你再次打开它。 |
应用保持连接期间,Android 会显示一条常驻的 Localtonet 通知,文字为 Tunnels are working。它属于后台服务,在应用不在屏幕上时让隧道保持运行。手机重启后,应用会自动再次打开,除非你用 Quit Localtonet 关闭了它。
应用请求的权限 #
| 请求 | 何时 | 原因 |
|---|---|---|
| Stop optimizing battery usage | 应用启动时,只要它仍开启了电池优化。 | 电池优化会让 Android 在后台停止应用,从而断开隧道。 |
| Permission Required:在其他应用上层显示 | 应用来到屏幕前时,只要缺少该权限。Continue 会打开 Android 设置。 | 如果你选择 Cancel,应用会警告:Your tunnels may not work properly (Settings-Apps-Localtonet-Advanced- Draw over other apps)。 |
| 通知 | 在 Android 13 及更高版本上,应用来到屏幕前时。 | 用于后台服务的常驻通知。 |
| 相机 | 你第一次点按扫描按钮时。 | 用于扫描令牌的二维码。没有该权限时,应用会显示 Camera permission required;请改用 PIN 或粘贴令牌。 |
| VPN 连接 | 手机加入你账户的 VPN 网络时。 | Android 要求在任何应用建立 VPN 之前先征得这一许可。参见 VPN 管理器。 |
Android 设备在控制台中增加的功能 #
Android 手机提供的隧道与其他任何设备相同。此外,我的令牌会为 Android 设备显示一个设备列:它们提供设备设置、受支持时的短信,以及操作日志。线程使用情况、电量和温度显示的是设备最近一次上报的值。
| 功能 | 说明 | 了解更多 |
|---|---|---|
| 移动代理 | 当每部手机都有自己的 AuthToken 时,每部手机都会成为拥有各自移动 IP 的独立代理。 | 代理服务器 |
| 手机集群 | 代理管理器会列出运行 Localtonet 应用的 Android 手机。你可以在一处检查它们的健康状况、在其上开启代理并轮换它们的 IP。 | 代理管理器 |
| 设备设置 | 设备列中的 Android 设备设置,包含飞行模式、更换 IP和重启设备等部分。其中一些标明仅适用于已获取 root 权限或设备所有者模式的手机。 | 代理管理器 |
| 短信 | 设备列中的短信设置,在设备支持短信时显示。 | 短信机器人 |
| 操作日志 | 设备列中的设备操作日志。 | AuthToken |
对于手机上的文件服务器隧道,始终使用应用目录作为共享文件夹,参见文件服务器。
更新 #
Google Play 会更新应用。如果你安装的是 APK,请从下载页面下载最新的 APK,并覆盖安装到现有应用上。
在我的令牌下,客户端列显示设备最近上报的应用版本;有更新的版本时,还会显示需要更新标记。
故障排除 #
Pin or authtoken is not valid.
应用无法把你的输入转换为令牌。PIN 的有效期为一分钟,且只能使用一次:请在控制台中选择生成新 PIN,并输入新的 PIN。令牌必须完整包含 33 个字符;请用复制令牌再复制一次。
PIN expired. Generate a new PIN to continue.
一分钟结束后,控制台中的对话框会显示这条提示。请选择生成新 PIN。
Please enter an authtoken or PIN.
你点按 Connect 时,字段是空的。
Camera permission required
应用没有相机权限,因此无法扫描二维码。请在 Android 设置中允许 Localtonet 使用相机,或者用 PIN 或令牌登录。
令牌在控制台中显示为离线
设备已断开连接。请在设备上打开 Localtonet 应用以连接。如果每当手机空闲时就出现这种情况,请检查 Localtonet 的电池优化是否已关闭,以及应用是否被允许在其他应用上层显示。
手机重启后应用没有恢复
用 Quit Localtonet 关闭应用后,它不会自行启动。请手动打开一次。