跳到内容
Localtonet Localtonet 控制台

AuthToken

获取本页帮助
本页内容 8 个章节
  1. 什么是 AuthToken
  2. 创建令牌
  3. 打开“我的令牌”
  4. 为设备命名
  5. 将令牌复制到应用中
  6. 在“我的隧道”中选择设备
  7. 令牌列表
  8. IP 历史
  9. 令牌设置
  10. 删除令牌
  11. 使用二维码或 PIN 连接 Android 设备
  12. 打开“连接设备”
  13. 扫描二维码或输入 PIN
  14. 令牌组
  15. 创建组
  16. 选择其中的令牌
  17. 令牌的使用位置
  18. 故障排除
  19. 相关页面

AuthToken 将一台设备上的 Localtonet 应用连接到你的账户。请在“我的令牌”中为每台设备创建一个令牌,用它登录设备,然后在创建隧道时选择该令牌。

什么是 AuthToken #

Localtonet 应用使用 AuthToken 登录,而不是使用你的邮箱和密码。在控制台中,令牌代表使用它的设备:隧道是为某个令牌创建的,只有在使用该令牌的应用已连接时才能工作。

  • 请为每台设备使用各自的令牌。使用同一个令牌的新连接会替换之前的连接。
  • 令牌的名称只是一个标签。令牌本身由 Localtonet 生成。
  • AuthToken 用于让设备登录,不能保护隧道免受访客访问。如需保护隧道,请参见访问控制。

请妥善保管你的令牌。任何持有令牌的人都可以用它登录应用。令牌的二维码和 PIN 也是如此。

创建令牌 #

  1. 打开“我的令牌” #

    打开 我的令牌,然后展开创建令牌。

  2. 为设备命名 #

    在令牌名称中输入一个易于辨认的名称,例如 Office-PC,然后选择创建令牌。

    规则详情
    必填名称为空时会显示请输入自定义名称!
    长度最多 30 个字符。
    空格不允许。该字段不接受空格,粘贴的名称中的空格会被移除。
    唯一你的两个令牌不能同名。
  3. 将令牌复制到应用中 #

    新令牌会显示在你的令牌下。选择它即可复制完整令牌,然后用它启动 Localtonet 应用:

    终端
    localtonet --authtoken <YOUR_TOKEN>

    在 Android 上,请改用二维码或 PIN。参见下文的连接 Android 设备。

  4. 在“我的隧道”中选择设备 #

    创建隧道时,在设备令牌中选择此令牌。快速入门展示了完整流程。

令牌列表 #

你的令牌列出了你当前所在账户的每个令牌。使用搜索令牌按名称或令牌筛选,使用刷新重新加载列表。在窄屏上,部分列会移到每一行的详情按钮后面。

列显示内容你可以做什么
名称你为令牌起的名称。选择名称即可重命名令牌。新名称适用同样的规则。
状态在线表示 Localtonet 应用已连接。离线表示设备已断开连接,即使它的隧道仍然配置着。
令牌令牌,中间部分被隐藏。选择它即可复制完整令牌。二维码按钮会打开连接设备。
隧道与此令牌关联的活动隧道数 / 隧道总数。在线的设备不一定有活动的隧道。
客户端最近一次报告的应用版本及其更新状态。需要更新标记会链接到下载页面,方便你安装最新的 Localtonet 应用。连接设备即可刷新这些信息。
设备设备最近一次报告的线程使用情况、电池电量和电池温度。对于 Android 设备:Android 设备设置、(在支持时)短信设置以及设备操作日志。代理管理器为整个设备群提供相同的控制。
操作IP 历史、令牌设置、删除令牌。

IP 历史 #

IP 历史会打开为该令牌记录的公网 IP 地址列表,并附上各自的日期。列表上方有四个计数器:重复总数、重复 IP 总数、最近 1 小时重复 IP和最近 1 小时 IP 总数。选择刷新即可更新它们。这对 IP 会变化的设备最有用,例如会轮换移动网络 IP 的手机。

令牌设置 #

令牌设置会打开一个面板,其中有完整令牌、复制令牌按钮、二维码 / PIN按钮以及两项设置:

设置项作用取值
USB 设备模式当该令牌连接的是 USB 设备时使用此模式。你可以在我的 USB 设备中管理它的设备。是或否。更改时会要求确认。
客户端参数将客户端选项与令牌一起保存。选择管理,开启已启用,并填写参数。Localtonet 客户端不会应用这里保存的参数;它应用的是隧道上设置的参数。如需选择网络接口或本地 IP 地址,请在每个隧道上设置。开启已启用后,该字段不能为空。参见网络选择。

删除令牌 #

选择删除令牌并确认。控制台会先向你发出警告:

使用此令牌的隧道将被停止并删除。仍在使用该令牌的设备将无法再用它连接。如果还需要该设备,请为它创建一个新令牌。

使用二维码或 PIN 连接 Android 设备 #

在手机上无需输入令牌。每个令牌都有一个二维码和一个短 PIN。

  1. 打开“连接设备” #

    在我的令牌中,选择令牌旁边的二维码按钮。连接设备对话框随即打开。

  2. 扫描二维码或输入 PIN #

    打开 Android 版 Localtonet。可以扫描扫描二维码下的二维码,也可以将改为输入 PIN下显示的六位 PIN 输入应用的登录字段,然后选择 Connect。

  • PIN 的有效期为一分钟。对话框会倒计时,随后显示PIN 已过期。请生成新 PIN 以继续。
  • PIN 只能使用一次。如需用于另一台设备或再试一次,请选择生成新 PIN。
  • 二维码不会过期。它包含令牌本身,因此请像对待令牌一样对待它的照片。
  • 你也可以将令牌粘贴到应用中。对话框会连同复制按钮一起显示它。

令牌组 #

令牌组包含设备令牌。组将设备整理成池:轮换代理使用你所选组中的设备,令牌 Webhook 也是为某个组创建的。

  1. 创建组 #

    在我的令牌中,展开令牌组,输入组名称,然后选择创建组。名称最多 30 个字符,不能含空格,且在你的组中必须唯一。

  2. 选择其中的令牌 #

    管理令牌组对话框会打开,并列出你所有的令牌。勾选属于该组的设备令牌,然后选择保存更改。

之后若要更改某个组,请选择它所在行的管理。该对话框专为长列表设计:

  • 按名称搜索。多个名称用逗号分隔。
  • 按设备状态筛选:任意状态、在线或离线。
  • 在全部、在组内和不在组内之间切换。
  • 使用全选勾选所有显示的令牌,然后取消勾选要排除的令牌。按住 Shift 点击可选择一个范围。
  • 页脚会显示将要发生的更改,例如+3 待添加。重置会放弃你的更改。

从组中移除令牌时,对话框会要求你确认,因为使用该组的轮换代理会在这些设备上停止。一次保存最多可以更改 5000 个令牌。

删除组会移除该组及其成员关系。令牌本身会保留。

令牌的使用位置 #

位置令牌的用法
隧道创建表单设备令牌用于选择为该隧道提供服务的设备。若要将现有隧道移到另一台设备,请在该隧道上使用更换 AuthToken:正在运行的隧道会停止,等待 2 秒,然后使用所选令牌重新启动。
轮换代理使用令牌组而不是单个令牌。所选组中每台已连接的设备都会成为共享端点的一个出口。
Webhook令牌 Webhook 是为认证令牌组设置的。
VPN 管理器将设备添加到网络时,你需要选择该设备上用于登录 Localtonet 的令牌。每台设备都需要各自的令牌。
设备终端令牌将一台计算机关联到“我的设备”中你的账户。
USB 设备处于USB 设备模式的令牌连接的是插有 USB 调制解调器或手机的计算机。
代理管理器每部 Android 手机都使用各自的令牌登录。

你还可以通过 API 和 MCP 服务器列出、创建和删除令牌及令牌组。

在控制台中选择了团队时,“我的令牌”显示并创建的是该团队的令牌。参见团队管理。

故障排除 #

名为 … 的令牌已存在

令牌名称是唯一的。请选择另一个名称,或先重命名现有令牌。

名称不能超过 30 个字符

请将令牌名称或组名称缩短到 30 个字符以内。

令牌显示为离线

设备已断开连接。请在该设备上打开 Localtonet 应用以连接。如果另一台设备使用同一个令牌启动,它会替换此连接:请为每台设备创建单独的令牌。

客户端提示 Wrong Token!

该值不是完整的令牌。请从“我的令牌”重新复制完整令牌:列表会隐藏中间部分,因此请使用复制按钮,而不要选取可见的文字。

PIN 已过期

PIN 的有效期为一分钟,且只能使用一次。请选择生成新 PIN,或改为扫描二维码。

无法加载二维码和 PIN

在对话框中选择重试。如果持续失败,请复制令牌并将其粘贴到应用中。

支持