跳到主要内容

Tailscale 远程访问

Linkr KVM 内置了 Tailscale 客户端,可将设备加入你的 Tailscale 虚拟专用网络(VPN),在任意地点通过加密隧道安全访问 KVM 管理界面,无需公网 IP 或手动配置端口转发。

Tailscale 基于 WireGuard 协议,由 Tailscale 协调服务器负责节点发现与密钥交换,设备之间建立点对点加密连接。

功能概述

能力说明
内置客户端固件预装 tailscale / tailscaled 二进制,无需额外安装
Web 界面管理在 KVM 管理界面中启用、登录、解绑 Tailscale 账号
开机自启启用后配置持久保存,设备重启后自动启动 tailscaled
安全组网流量经 WireGuard 加密,仅同一 Tailnet 内的设备可互通

使用前准备

  1. Tailscale 账号:在 tailscale.com 注册个人或团队账号(免费套餐即可满足个人使用)。
  2. 网络连接:KVM 设备需能访问互联网(RJ45有线或Wi-Fi均可),以便与 Tailscale 协调服务器通信。
  3. 浏览器:绑定账号时需在浏览器中完成 Tailscale 授权,请确保管理端浏览器允许弹出窗口。

操作步骤

1. 进入设置页面

  1. 打开 KVM 管理 Web 界面并登录。
  2. 在左侧边栏进入 系统高级设置
  3. 找到 Tailscale 配置项。

2. 启用 Tailscale

打开 Tailscale 开关。启用后,设备会启动 tailscaled 后台服务,并将该设置写入本地配置,重启后仍保持启用状态。

关闭开关将停止 tailscaled 服务,设备会从 Tailnet 中断开(已绑定的账号信息会保留,再次启用后需重新绑定)。

3. 绑定 Tailscale 账号

  1. 确认 Tailscale 已启用。
  2. 点击 绑定 按钮。
  3. 系统会自动弹出浏览器窗口,跳转至 Tailscale 登录/授权页面。
  4. 使用你的 Tailscale 账号登录,并在授权页面确认将本设备加入 Tailnet。
  5. 授权成功后,页面会显示已绑定的账号名称,状态变为已认证。

若弹窗被浏览器拦截,请允许当前站点的弹出窗口后重试,或手动复制授权链接到新标签页打开。

img

img

img

4. 通过 Tailscale 访问 KVM

绑定成功后,可在 Tailscale 管理后台 查看设备分配的 Tailscale IP(通常为 100.x.x.x 网段)。

在同一 Tailnet 内的任意设备上,使用以下地址访问 KVM:

https://<设备 Tailscale IP>

也可使用 Tailscale MagicDNS 主机名(若已在 Tailnet 中启用):

https://<设备主机名>.<你的-tailnet>.ts.net
提示

通过 Tailscale 访问时,仍需使用 KVM 的本地登录凭据(用户名与密码),Tailscale 仅提供网络层连通性,不替代 KVM 的身份认证。

5. 解绑账号

如需将设备从 Tailnet 移除或更换账号:

  1. 在 Tailscale 设置页点击 解绑
  2. 等待操作完成,账号信息将清空。
  3. 可重新点击 绑定 关联其他 Tailscale 账号。

界面状态说明

状态含义
开关关闭Tailscale 功能未启用,tailscaled 未运行
开关开启,未绑定服务已启动,等待绑定 Tailscale 账号
开关开启,已绑定设备已加入 Tailnet,可通过 Tailscale IP 远程访问
版本号显示当前固件内置的 Tailscale 客户端版本

技术说明

固件集成方式

Tailscale 客户端以内置二进制形式打包进固件:

与本地访问的关系

启用 Tailscale 不会影响 KVM 的本地网络访问方式。设备仍可通过局域网 IP、Wi-Fi 或 USB 网络等方式访问,Tailscale 作为额外的远程访问通道叠加使用。

常见问题

绑定失败或长时间无响应

  • 确认 KVM 设备已连接互联网。
  • 检查浏览器是否拦截了弹出窗口。
  • 确认 Tailscale 协调服务器(controlplane.tailscale.com)未被防火墙阻断。
  • 尝试关闭后重新启用 Tailscale,再次绑定。

启用后无法通过 Tailscale IP 访问

  • 在 Tailscale 管理后台确认设备在线(Online)。
  • 确认访问端与 KVM 在同一 Tailnet 内。
  • 检查访问端 Tailscale 客户端是否已连接。
  • 确认使用的是 https:// 协议及正确的 Tailscale IP。

重启后 Tailscale 未自动连接

  • 确认启用开关在重启前处于开启状态。
  • 若之前已完成账号绑定,重启后应自动恢复连接;若处于未绑定状态,需重新绑定。

解绑后设备仍出现在 Tailscale 后台

解绑操作会在设备端执行 tailscale logout。若设备在管理后台仍显示为离线节点,可在 Tailscale 管理后台 手动删除该设备记录。

相关链接

    您需要登录 GitHub 才能发表评论。如果您已登录,请忽略此消息。

    Radxa-docs © 2026 by Radxa Computer (Shenzhen) Co.,Ltd. is licensed under CC BY 4.0