AuthToken
本页内容 8 个章节
AuthToken 将一台设备上的 Localtonet 应用连接到你的账户。请在“我的令牌”中为每台设备创建一个令牌,用它登录设备,然后在创建隧道时选择该令牌。
什么是 AuthToken #
Localtonet 应用使用 AuthToken 登录,而不是使用你的邮箱和密码。在控制台中,令牌代表使用它的设备:隧道是为某个令牌创建的,只有在使用该令牌的应用已连接时才能工作。
- 请为每台设备使用各自的令牌。使用同一个令牌的新连接会替换之前的连接。
- 令牌的名称只是一个标签。令牌本身由 Localtonet 生成。
- AuthToken 用于让设备登录,不能保护隧道免受访客访问。如需保护隧道,请参见访问控制。
请妥善保管你的令牌。任何持有令牌的人都可以用它登录应用。令牌的二维码和 PIN 也是如此。
创建令牌 #
-
打开“我的令牌” #
打开 我的令牌,然后展开创建令牌。
-
为设备命名 #
在令牌名称中输入一个易于辨认的名称,例如
Office-PC,然后选择创建令牌。规则 详情 必填 名称为空时会显示请输入自定义名称! 长度 最多 30 个字符。 空格 不允许。该字段不接受空格,粘贴的名称中的空格会被移除。 唯一 你的两个令牌不能同名。 -
将令牌复制到应用中 #
新令牌会显示在你的令牌下。选择它即可复制完整令牌,然后用它启动 Localtonet 应用:
终端localtonet --authtoken <YOUR_TOKEN>在 Android 上,请改用二维码或 PIN。参见下文的连接 Android 设备。
-
在“我的隧道”中选择设备 #
创建隧道时,在设备令牌中选择此令牌。快速入门展示了完整流程。
令牌列表 #
你的令牌列出了你当前所在账户的每个令牌。使用搜索令牌按名称或令牌筛选,使用刷新重新加载列表。在窄屏上,部分列会移到每一行的详情按钮后面。
| 列 | 显示内容 | 你可以做什么 |
|---|---|---|
| 名称 | 你为令牌起的名称。 | 选择名称即可重命名令牌。新名称适用同样的规则。 |
| 状态 | 在线表示 Localtonet 应用已连接。离线表示设备已断开连接,即使它的隧道仍然配置着。 | |
| 令牌 | 令牌,中间部分被隐藏。 | 选择它即可复制完整令牌。二维码按钮会打开连接设备。 |
| 隧道 | 与此令牌关联的活动隧道数 / 隧道总数。在线的设备不一定有活动的隧道。 | |
| 客户端 | 最近一次报告的应用版本及其更新状态。 | 需要更新标记会链接到下载页面,方便你安装最新的 Localtonet 应用。连接设备即可刷新这些信息。 |
| 设备 | 设备最近一次报告的线程使用情况、电池电量和电池温度。 | 对于 Android 设备:Android 设备设置、(在支持时)短信设置以及设备操作日志。代理管理器为整个设备群提供相同的控制。 |
| 操作 | IP 历史、令牌设置、删除令牌。 |
IP 历史 #
IP 历史会打开为该令牌记录的公网 IP 地址列表,并附上各自的日期。列表上方有四个计数器:重复总数、重复 IP 总数、最近 1 小时重复 IP和最近 1 小时 IP 总数。选择刷新即可更新它们。这对 IP 会变化的设备最有用,例如会轮换移动网络 IP 的手机。
令牌设置 #
令牌设置会打开一个面板,其中有完整令牌、复制令牌按钮、二维码 / PIN按钮以及两项设置:
| 设置项 | 作用 | 取值 |
|---|---|---|
| USB 设备模式 | 当该令牌连接的是 USB 设备时使用此模式。你可以在我的 USB 设备中管理它的设备。 | 是或否。更改时会要求确认。 |
| 客户端参数 | 将客户端选项与令牌一起保存。选择管理,开启已启用,并填写参数。Localtonet 客户端不会应用这里保存的参数;它应用的是隧道上设置的参数。如需选择网络接口或本地 IP 地址,请在每个隧道上设置。 | 开启已启用后,该字段不能为空。参见网络选择。 |
删除令牌 #
选择删除令牌并确认。控制台会先向你发出警告:
使用此令牌的隧道将被停止并删除。仍在使用该令牌的设备将无法再用它连接。如果还需要该设备,请为它创建一个新令牌。
使用二维码或 PIN 连接 Android 设备 #
在手机上无需输入令牌。每个令牌都有一个二维码和一个短 PIN。
-
打开“连接设备” #
在我的令牌中,选择令牌旁边的二维码按钮。连接设备对话框随即打开。
-
扫描二维码或输入 PIN #
打开 Android 版 Localtonet。可以扫描扫描二维码下的二维码,也可以将改为输入 PIN下显示的六位 PIN 输入应用的登录字段,然后选择 Connect。
- PIN 的有效期为一分钟。对话框会倒计时,随后显示PIN 已过期。请生成新 PIN 以继续。
- PIN 只能使用一次。如需用于另一台设备或再试一次,请选择生成新 PIN。
- 二维码不会过期。它包含令牌本身,因此请像对待令牌一样对待它的照片。
- 你也可以将令牌粘贴到应用中。对话框会连同复制按钮一起显示它。
令牌组 #
令牌组包含设备令牌。组将设备整理成池:轮换代理使用你所选组中的设备,令牌 Webhook 也是为某个组创建的。
-
创建组 #
在我的令牌中,展开令牌组,输入组名称,然后选择创建组。名称最多 30 个字符,不能含空格,且在你的组中必须唯一。
-
选择其中的令牌 #
管理令牌组对话框会打开,并列出你所有的令牌。勾选属于该组的设备令牌,然后选择保存更改。
之后若要更改某个组,请选择它所在行的管理。该对话框专为长列表设计:
- 按名称搜索。多个名称用逗号分隔。
- 按设备状态筛选:任意状态、在线或离线。
- 在全部、在组内和不在组内之间切换。
- 使用全选勾选所有显示的令牌,然后取消勾选要排除的令牌。按住 Shift 点击可选择一个范围。
- 页脚会显示将要发生的更改,例如+3 待添加。重置会放弃你的更改。
从组中移除令牌时,对话框会要求你确认,因为使用该组的轮换代理会在这些设备上停止。一次保存最多可以更改 5000 个令牌。
删除组会移除该组及其成员关系。令牌本身会保留。
令牌的使用位置 #
| 位置 | 令牌的用法 |
|---|---|
| 隧道创建表单 | 设备令牌用于选择为该隧道提供服务的设备。若要将现有隧道移到另一台设备,请在该隧道上使用更换 AuthToken:正在运行的隧道会停止,等待 2 秒,然后使用所选令牌重新启动。 |
| 轮换代理 | 使用令牌组而不是单个令牌。所选组中每台已连接的设备都会成为共享端点的一个出口。 |
| Webhook | 令牌 Webhook 是为认证令牌组设置的。 |
| VPN 管理器 | 将设备添加到网络时,你需要选择该设备上用于登录 Localtonet 的令牌。每台设备都需要各自的令牌。 |
| 设备终端 | 令牌将一台计算机关联到“我的设备”中你的账户。 |
| USB 设备 | 处于USB 设备模式的令牌连接的是插有 USB 调制解调器或手机的计算机。 |
| 代理管理器 | 每部 Android 手机都使用各自的令牌登录。 |
你还可以通过 API 和 MCP 服务器列出、创建和删除令牌及令牌组。
在控制台中选择了团队时,“我的令牌”显示并创建的是该团队的令牌。参见团队管理。
故障排除 #
名为 … 的令牌已存在
令牌名称是唯一的。请选择另一个名称,或先重命名现有令牌。
名称不能超过 30 个字符
请将令牌名称或组名称缩短到 30 个字符以内。
令牌显示为离线
设备已断开连接。请在该设备上打开 Localtonet 应用以连接。如果另一台设备使用同一个令牌启动,它会替换此连接:请为每台设备创建单独的令牌。
客户端提示 Wrong Token!
该值不是完整的令牌。请从“我的令牌”重新复制完整令牌:列表会隐藏中间部分,因此请使用复制按钮,而不要选取可见的文字。
PIN 已过期
PIN 的有效期为一分钟,且只能使用一次。请选择生成新 PIN,或改为扫描二维码。
无法加载二维码和 PIN
在对话框中选择重试。如果持续失败,请复制令牌并将其粘贴到应用中。