Tailscale 远程访问 VPN 教程

如何设置 Tailscale 并从外面访问家庭网络

在手机和电脑上安装 Tailscale,把家里一台设备设为子网路由器,就能访问家庭网络里的所有设备。附常见问题的解决方法。

发布于 更新于

**快速回答:**Tailscale 的设置分三部分:手机和电脑上的 App,家里一台常开的设备负责共享您的网络,以及在管理控制台里的一次批准。

  1. 在 tailscale.com 创建一个免费账户。
  2. 在手机和电脑上安装 App,用同一个账户登录。
  3. 在家里一台常开的设备上安装 Tailscale。Linux 上请先开启 IP 转发,再运行 sudo tailscale set --advertise-routes=192.168.1.0/24(换成您自己的网段)。
  4. 在管理控制台的 Machines 页面批准这条路由,并为该设备关闭密钥过期。
  5. 关掉手机的 Wi-Fi,用局域网 IP 打开家里的某台设备。在任何地方都能用。

本教程覆盖每个平台、家庭服务器的各种选择、MagicDNS、出口节点、访问规则,以及大家常遇到的问题。如果您还在 Tailscale、Cloudflare Tunnel 和端口转发之间犹豫,我们的免费访问家庭设备方案对比解释了各自的取舍。步骤和界面名称已于 2026 年 10 月对照 Tailscale 文档核对。

开始之前

  • **一个账户。**Tailscale 通过身份提供方登录:Google、Microsoft、GitHub、Apple、Okta、OneLogin 或自定义 OIDC 提供方。Tailscale 没有自己的密码,也不能用普通邮箱地址直接注册。哪个账户创建了 tailnet,它就是所有者。
  • **套餐。**截至 2026 年 10 月,免费的 Personal 套餐最多支持 6 位用户、不限数量的用户设备,以及最多 50 个带标签的资源。子网路由器后面的设备不计入数量。当前数字请看 Tailscale 价格页。
  • **您家庭网络的网段。**在家时用手机打开 Wi-Fi 详情。IP 是 192.168.1.23、子网掩码是 255.255.255.0,说明您的网络是 192.168.1.0/24。很多 Android 手机不显示掩码,这时网关(路由器)是 192.168.1.1 几乎总是意味着 192.168.1.0/24。路由器的管理页面会显示准确的网段。

在手机上安装 Tailscale

iPhone 和 iPad

  1. 从 App Store 安装 Tailscale。需要 iOS 15 或更高版本。
  2. 打开它,点 Get Started。
  3. 接受添加 VPN 配置的提示,并允许通知。通知会在密钥过期前提醒您。
  4. 点 Log in 并登录。

Android

  1. 从 Google Play 安装 Tailscale。需要 Android 8.0 或更高版本。
  2. 打开它,接受 VPN 连接请求。
  3. 点 Sign in with Google,或点 Sign in with other 使用 Apple、Microsoft 或 GitHub 登录。使用和之前相同的账户,并允许通知,这样密钥过期前您会收到提醒。

手机会自动接受子网路由,所以家里那一端设好之后,这里就不用再改什么了。

在电脑上安装 Tailscale

Windows

  1. 从 tailscale.com/download/windows 下载安装程序。需要 Windows 10 或更高版本。
  2. 运行它。系统托盘里会出现一个 Tailscale 图标(看不到的话检查一下溢出箭头)。
  3. 右键点击图标,选择 Log in,在浏览器中登录。

Mac

Tailscale 为 macOS 12 Monterey 及更高版本提供三个版本。官方文档推荐从其自有下载服务器获取的 Standalone 版本;Mac App Store 版本也可以用。安装后按引导添加 VPN 配置,然后从菜单栏图标登录。Tailscale 对几个版本的区别有说明。

Linux

Tailscale 的安装脚本覆盖主流发行版,包括 Raspberry Pi OS:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

tailscale up 会打印一个登录链接。在浏览器中打开它并登录,这台机器就会出现在管理控制台里。

Linux(和其他只有命令行的安装一样)默认不接受子网路由。在一台会带出门的 Linux 笔记本上,运行 sudo tailscale set --accept-routes,它才能在外面访问您的家庭网络。千万不要在子网路由器本身或其他留在家里的 Linux 机器上开启这个选项:它们自己的家庭网络流量会被拉进 Tailscale,子网路由器甚至可能完全失去网络。笔记本上开着没问题,但在家时它到那些设备的流量会绕经子网路由器。这些路由要用 ip route show table 52 查看,而不是普通的 ip route。

添加更多设备和家庭成员

添加另一台设备

在 Machines 页面选择 Add device(添加设备)。手机或电脑:安装 App 并用您的账户登录。Linux 服务器:选 Linux server 选项,复制它给出的安装命令,命令里已经包含了密钥。电视或其他没有浏览器的设备在登录时会显示二维码或短代码;用手机扫码,或在 Add device 中输入代码。

设备加入后,就能从任何其他设备通过它的 Tailscale 地址(100.x.y.z,App 里或 tailscale status 会显示)或名称打开它(见 MagicDNS)。

添加家庭成员

没有邀请就直接登录的人会得到一个自己的空 tailnet,看不到您的任何设备。家人装了 Tailscale 后用自己的 Google 账户登录,就正好是这种情况。所以要先邀请:

  1. 打开管理控制台的 Users 页面,选择 Invite external users(邀请外部用户)。
  2. 输入对方的邮箱地址,或者用 Copy invite link 自己把链接发给对方。
  3. 让对方打开邀请并接受,然后再安装 App 并登录。

免费套餐最多 6 位用户。要限制每个人能访问什么,见访问规则。

把家里一台设备设为子网路由器

子网路由器会把您整个家庭网络共享给 tailnet,这样就能访问那些自身无法运行 Tailscale 的设备:灯光控制器、摄像头、打印机、路由器本身。尽量选一台常开并且有线接入网络的设备。然后批准路由(下一节)。

Raspberry Pi 或任何 Linux 机器

  1. 用 Raspberry Pi Imager 烧写 Raspberry Pi OS Lite。在 Imager 的自定义步骤中设置用户名、密码和主机名,启用 SSH,如果不用网线就再加上 Wi-Fi。
  2. 启动后,用您在 Imager 中设置的用户名和主机名连接:ssh -l yourname yourhostname.local。
  3. 用上面的两条 Linux 命令安装 Tailscale 并登录。
  4. 开启 IP 转发并通告您的网段:
echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
sudo sysctl -p /etc/sysctl.d/99-tailscale.conf

sudo tailscale set --advertise-routes=192.168.1.0/24

在已经连接的机器上改设置请用 tailscale set:它只改您指定的项,其余保持不变。tailscale up 则要求每次传参数时把所有选项都写全,tailscale up --reset 会清掉您没写的那些。两条命令的设置都会在重启后保留,tailscale get 显示当前的设置。如果机器用的是 firewalld(比如 Fedora),Tailscale 文档还建议运行 sudo firewall-cmd --permanent --add-masquerade。

Home Assistant

Tailscale 应用来自 Home Assistant Community Apps 仓库(Home Assistant 2026.2 之前这类应用叫 add-on)。

  1. 在 Home Assistant 中进入 Settings › Apps,打开应用商店,安装 Tailscale。
  2. 启动它,查看日志,然后打开它的 Web UI 并登录。该应用的文档建议这一步在电脑上用 Chrome 完成。
  3. 在应用的 Configuration 标签页,把您的网段加到 advertise_routes 下,例如 192.168.1.0/24。默认是一个空列表,所以不添加就什么都不会共享。
  4. 重启应用,然后在管理控制台批准路由。

该应用的文档还建议为 Home Assistant 这台机器关闭密钥过期。详情见 Tailscale 应用文档。

Unraid

Unraid 7 及更高版本请使用官方插件:

  1. 打开 Apps,搜索 Tailscale (Plugin) 并安装。忽略旧的 Docker 选项。
  2. 打开 Settings › Tailscale(在 Network Services 下),开启 Advanced View,选择 Reauthenticate,再选 Connect。
  3. 在插件的 Advertise Routes 部分,填入您的网段(192.168.1.0/24),或只以 /32 填入服务器自己的 IP,然后选择 Apply。

来源:Unraid 文档、Tailscale 的 Unraid 页面。

Synology

  1. 打开 Package Center,搜索 Tailscale 并安装。
  2. 打开应用并登录。
  3. DSM 默认关闭 SSH。在 Control Panel › Terminal & SNMP › Enable SSH service 开启,然后用管理员账户连接。
  4. 运行 sudo tailscale set --advertise-routes=192.168.1.0/24。如果找不到 tailscale,用完整路径 /var/packages/Tailscale/target/bin/tailscale。

在 DSM 7 上,NAS 上的其他应用无法主动发起 Tailscale 连接,除非您添加一个开机任务。只有在 NAS 本身需要访问其他 tailnet 设备时这才重要。进入 Control Panel › Task Scheduler › Create › Triggered Task › User-defined script,用户设为 root,事件设为 Boot-up,使用这段脚本:

/var/packages/Tailscale/target/bin/tailscale configure-host; synosystemctl restart pkgctl-Tailscale.service

每次 Tailscale 套件更新后再运行一次。Synology 可以通告路由但不能接受路由,通过它共享的设备可能不回应 ping,虽然网页能正常打开,而且 Tailscale SSH 不能在它上面运行。这些都写在 Tailscale 的 Synology 指南里。

QNAP

从 App Center 的 Communications 分类安装 Tailscale,打开它并选择 Connect。子网路由需要用命令行:SSH 登录后,在应用的套件目录下运行 tailscale set --advertise-routes=...,因为这个命令不在常规路径里。Tailscale 的 QNAP 页面说明了它的位置。

Docker

官方镜像通过环境变量读取设置。TS_ROUTES 通告子网,TS_STATE_DIR 配合一个卷让容器在重启后保持登录状态,TS_AUTH_ONCE=true 防止每次启动都重新登录(没有它,一旦密钥用完或过期,重启就可能失败)。镜像默认以 userspace 模式运行,不需要额外权限就能处理子网路由。

services:
  tailscale:
    image: tailscale/tailscale:latest
    container_name: tailscale
    environment:
      - TS_AUTHKEY=${TS_AUTHKEY}     # from an .env file, not committed anywhere
      - TS_HOSTNAME=home-router
      - TS_STATE_DIR=/var/lib/tailscale
      - TS_AUTH_ONCE=true
      - TS_ROUTES=192.168.1.0/24
    volumes:
      - ./tailscale-state:/var/lib/tailscale
    restart: unless-stopped

在管理控制台的 Settings › Keys 下创建 auth key。auth key 的有效期为 1 到 90 天(不选则为 90 天);有了状态卷和 TS_AUTH_ONCE,一次性密钥就够了,可重复使用的密钥一旦泄露风险更大。容器仍然会拿到常规的 180 天设备密钥,所以请在 Machines 页面为它关闭密钥过期,或者创建带标签的 auth key,因为带标签的设备不会过期。在 userspace 模式下,宿主机和其他容器无法使用 tailnet,只有通往您网络的路由可用。Docker 参数参考。

Windows 电脑或 Apple TV

一台常开的 Windows 电脑可以作为子网路由器。以管理员身份打开 PowerShell,运行 tailscale set --advertise-routes=192.168.1.0/24,然后右键托盘图标,在 Preferences 下开启 Run unattended(无人值守运行);否则您一退出 Windows 登录,Tailscale 就会停止。Mac 不太合适,因为它的 App 需要一个已登录的用户。无人值守运行。

Apple TV 对很多家庭来说是最省事的家庭设备。需要 tvOS 17 或更高版本(推荐 18)。在电视上从 App Store 安装 Tailscale,用手机扫二维码登录,然后打开 App 的 Subnet Router 界面,以 CIDR 格式输入您的网段,例如 192.168.1.0/24。在 Apple TV 的设置里保持它作为家庭中枢,否则它会休眠并掉线。Apple TV 只路由 IPv4 网络。Tailscale 的 Apple TV 页面。

您的路由器

运营商提供的路由器大多不能运行 Tailscale,Fritz!Box 以及 TP-Link Archer 和 Deco 系列的原厂固件也不行。可以运行的有:

  • GL.iNet 路由器内置了 Tailscale(固件 4.2 或更高,GL.iNet 仍标为 beta),有一个共享局域网的开关(叫“Allow Remote Access LAN”,固件 4.9 及更高版本叫“Advertise LAN Subnets”)。GL.iNet 的 Tailscale 页面。
  • pfSense 在 Package Manager 中有 Tailscale 软件包。
  • OPNsense 在 System › Firmware › Plugins 下有社区插件 os-tailscale(勾选 Show community plugins;需要 OPNsense 24.7.11 或更高版本)。Tailscale 的 OPNsense 页面。
  • OpenWrt 有 tailscale 软件包(25.12 上用 apk add tailscale,旧版本用 opkg install tailscale)。它大约需要 30 MB 存储空间,比很多零售路由器的容量都大,而且子网路由还需要一个 tailscale0 接口和对应的防火墙区域。这两步请按 OpenWrt wiki 操作。

UniFi 只能通过非官方的社区脚本运行它,MikroTik 只能在 RouterOS 容器里运行。对于这几种情况,用 Raspberry Pi、NAS 或 Apple TV 做子网路由器更简单。

批准路由并让它一直可用

  1. 打开管理控制台的 Machines 页面。通告了路由的设备带有 Subnets 标记。
  2. 选中该设备,进入它的 Subnets 部分,选择 Edit。
  3. 在 Subnet routes 下勾选您的路由,选择 Save。
  4. 回到 Machines 页面,打开该设备的菜单,选择 Disable Key Expiry(关闭密钥过期)。

密钥默认 180 天过期。子网路由器的密钥一过期,远程访问就会中断,直到有人重新登录它,而这种事偏偏总发生在您出门在外的时候。

从外面测试

  1. 在手机上关掉 Wi-Fi,确认 Tailscale 显示为已连接。
  2. 打开子网路由器的 Tailscale 地址(在 App 里或用 tailscale ip -4 查看)。能打开说明 Tailscale 本身没问题。
  3. 用局域网 IP 打开家里的某台设备,例如 http://192.168.1.50。能打开说明子网路由工作正常。

用名字代替数字:MagicDNS

每台运行 Tailscale 的设备都有一个名字。有了 MagicDNS(2022 年 10 月之后创建的 tailnet 默认开启),您可以输入 ping pi 或打开 http://homeassistant:8123,不必记 100.x.y.z 地址,也可以用以 .ts.net 结尾的完整名称。如果您的 tailnet 更早,请在管理控制台的 DNS 页面开启它。

MagicDNS 只给运行 Tailscale 的设备命名。子网路由器后面的设备保持它们的局域网 IP。像 printer.local 这样的名字来自 mDNS,它只在家庭网络内部有效,所以从外面无法解析。如果您在家里运行自己的 DNS 服务器,DNS 页面上 Tailscale 的 split DNS 设置可以把您家庭域名的查询转给它。MagicDNS 文档。

出口节点:在任何地方使用家里的网络出口

出口节点会把您的全部互联网流量经由家里的一台设备转出,在公共 Wi-Fi 上很有用。访问家里的设备并不需要它。Linux 上先按上文开启 IP 转发,然后:

sudo tailscale set --advertise-exit-node
sudo tailscale up

如果 tailscale up 提示缺少参数,跳过它即可;单独的 set 就会生效。在管理控制台批准出口节点(Edit route settings,然后 Use as exit node),再在手机 App 的 Exit Node 下选中它。Allow LAN access(Android)或 Allow Local Network Access 可以让您在出口节点开启时仍能访问当前 Wi-Fi 上的打印机和其他设备。开启期间耗电会多一些。出口节点文档。

谁能访问什么:访问规则

新建的 tailnet 自带一条策略,允许每台设备访问其他所有设备。只有您自己用时这没问题。邀请家人之后,可以在 Access controls 页面收窄权限。Tailscale 的文档现在推荐用 grants 写规则。下面的示例让所有者和管理员访问一切,让每个人访问自己的设备,让其他成员只能访问家里的两台灯光控制器:

{
  "hosts": {
    "porch-lights": "192.168.1.57",
    "kitchen-lights": "192.168.1.58"
  },
  "grants": [
    // owner and admins: everything, including exit nodes
    { "src": ["autogroup:owner", "autogroup:admin"], "dst": ["*", "autogroup:internet"], "ip": ["*"] },
    // everyone: their own devices
    { "src": ["autogroup:member"], "dst": ["autogroup:self"], "ip": ["*"] },
    // family members: two light controllers
    { "src": ["autogroup:member"], "dst": ["porch-lights", "kitchen-lights"], "ip": ["*"] }
  ]
}

策略文件是 HuJSON 格式,所以允许写这样的注释。替换默认策略会移除允许全部的规则和默认的 SSH 规则,所以保存前请用 Preview rules 标签页预览,保存后确认您自己的设备仍然能连接。使用出口节点需要一条到 autogroup:internet 的 grant,这就是第一行包含它的原因。Grants 文档。

不安装 Tailscale 能用吗?

基本上不能:您发起连接的那台设备需要装 Tailscale。有几种变通办法,各有限制。

  • Serve(tailscale serve 3000)把那台机器上运行的一个网页应用放到一个以 .ts.net 结尾的 HTTPS 地址后面。它仍然只能从您的 tailnet 访问,但地址更好记,而且有真实的证书。
  • Funnel(tailscale funnel 3000)把一个网页服务发布到整个互联网,地址为 https://<name>.<tailnet>.ts.net。它需要 MagicDNS、HTTPS 证书和策略中的 funnel 属性,只能使用 443、8443 或 10000 端口,只能在有 Tailscale 命令行的地方运行,而且仍处于 beta。任何人都能访问您发布的内容,所以只用于自带登录的应用,绝不要用于智能家居设备。Funnel 文档。
  • 把设备共享给 tailnet 之外的人,对方仍需安装 Tailscale,但可以保留自己的账户,并且只看到这一台设备。共享文档。

想要一个完全不用 App 的公开仪表盘,另一个常见选择是前面加一层登录的 Cloudflare Tunnel;我们的对比文章有介绍。

另一端的智能灯

像 WLED 这样的灯光控制器是设置子网路由器的典型原因:它们不能运行 Tailscale,也绝不应该做端口转发。在路由器里给每台控制器一个固定 IP(DHCP 地址保留,MAC 地址在哪里找),然后在 Tailscale 连接的状态下用手机按这个 IP 打开它。自动发现在外面看不到这些灯,因为它依赖您的家庭网络。

要用 WLED Max,我们为 iOS 和 Android 开发的 WLED App在外面控制 WLED 灯,先按 IP 把每盏灯添加一次(按 IP 地址添加)。之后只要 Tailscale 连着,App 在移动数据下访问这些灯的方式和在您家 Wi-Fi 下完全一样。

故障排除

无法访问家庭网络里的设备

按顺序逐项检查:

  1. **路由批准了吗?**Machines 页面上,该设备的 Subnets 部分应显示这条路由,且没有待处理标记。
  2. **Tailscale IP 能通吗?**打开子网路由器的 100.x.y.z 地址。连这个都不行,问题就在连接本身,不在路由。
  3. **IP 转发开了吗?**在 Linux 路由器上运行 sysctl net.ipv4.ip_forward,应该打印 = 1。新版 Linux 客户端在它关闭时也会显示健康警告。
  4. **网段对吗?**路由必须覆盖目标设备。192.168.1.0/24 并不覆盖 192.168.0.50。
  5. **Linux 客户端?**在外面的 Linux 笔记本需要 sudo tailscale set --accept-routes 才能使用路由。留在家里的 Linux 机器请保持关闭(原因)。
  6. **两端网段相同?**如果您所在的 Wi-Fi 也用 192.168.1.x,您的设备会看到两个地址相同的网络。试试移动数据,或者把家庭网络改成一个不那么常见的网段。
  7. **访问规则?**如果您编辑过策略,确认它允许您访问这个子网。
  8. **密钥过期?**子网路由器一过期,所有人的路由都会停。到 Machines 页面查看。

名字无法解析

  • 子网路由器后面的设备请用 IP。MagicDNS 和 .local 名字找不到它们。
  • 确认客户端在使用 Tailscale DNS:Linux 上运行 tailscale set --accept-dns=true,Windows 上在管理员 PowerShell 中运行同一命令;Mac 上在菜单栏菜单中开启 Use Tailscale DNS settings。
  • 有些路由器和运营商会拦截指向私有地址的 DNS 应答(DNS 重绑定保护)。Tailscale 的 DNS 故障排除有对应的解决办法。

之前好用,几个月后不行了

这是密钥过期。重新登录该设备(Linux 上 sudo tailscale up --force-reauth,或在 App 里登录),然后为它关闭密钥过期。不要在一个经由 Tailscale 的 SSH 会话里运行 --force-reauth,因为它会断开那条连接。如果密钥已经过期,Machines 页面上该设备的菜单提供 Temporarily extend key(临时延长密钥),给您 30 分钟;利用这段时间选择 Disable Key Expiry。手机上 Tailscale 会在密钥过期前发通知,这正是允许通知的一个好理由。

手机耗电变快

Tailscale 文档指出,最常见的原因是用出口节点承载全部流量,所以不需要时请关掉出口节点。除此之外,我们自己的建议是:保持 App 更新,在家里用不到时就关掉 Tailscale。耗电说明。

连接很慢

在电脑上运行 tailscale ping <device>。最初几条回复经常是“via DERP”,这时两台设备还在寻找直连路径。如果每条回复都是 via DERP,并且最后显示“direct connection not established”,说明流量在走中继,这会增加延迟。tailscale netcheck 会显示您的网络是否拦截 UDP;酒店或办公室 Wi-Fi 上严格的防火墙是常见原因。

两个办法有帮助。在家里的路由器上开启 UPnP 或 NAT-PMP,直连会更容易建立。或者在家里一台常开的设备上运行对等中继(peer relay):sudo tailscale set --relay-server-port=40000,确保这个 UDP 端口可达(大多数家用路由器需要转发它),并按 Tailscale 的对等中继文档添加一条带 relay 能力的 grant。之后 tailscale status 会把连接显示为 peer-relay,通常比 Tailscale 的共享中继快得多。连接类型。

值得记住的命令

tailscale status                 # devices in your tailnet and how you're connected
tailscale ip -4                  # this device's Tailscale IPv4 address
tailscale ping <device>          # direct or relayed, and the latency
tailscale netcheck               # what your current network allows
sudo tailscale set --advertise-routes=192.168.1.0/24   # share a subnet
sudo tailscale set --accept-routes                     # use subnets (Linux laptops only)
tailscale down                   # disconnect
tailscale up                     # connect again

Tailscale 设置常见问题

**设置 Tailscale 要多久?**手机和电脑各需要几分钟。Raspberry Pi 子网路由器要久一些,主要花在烧写存储卡上。

**Tailscale 家用免费吗?**是的。截至 2026 年 10 月,Personal 套餐对非商业用途免费,最多 6 位用户,用户设备数量不限(价格)。

**家里每台设备都要装 Tailscale 吗?**不用。一台子网路由器就能共享整个网络。只在您想按名字访问的设备,或会带出门的设备上直接安装 Tailscale。

**需要做端口转发吗?**不需要。Tailscale 从两端向外发起连接,在 CGNAT 后面也能用。

**该用 tailscale up 还是 tailscale set?**用 up 登录或恢复连接。用 set 修改选项,它会保持其他设置不变。

**子网路由器会拖慢我的家庭网络吗?**只有您通过 Tailscale 发送的流量会经过它。Wi-Fi 上的其他一切不受影响。

**可以有两台子网路由器吗?**可以,一台掉线时另一台接替。在两台上通告完全相同的网段并都批准。切换需要一小段时间,不是瞬间完成。

**Tailscale 是开源的吗?**核心客户端代码在 GitHub 上开源。协调服务器是 Tailscale 自己的服务。Headscale 是该服务器的自托管替代方案。

来源:Tailscale 文档中关于子网路由器、Linux 安装、iOS、Android、macOS、Windows、Apple TV、邀请用户、密钥过期、auth key、MagicDNS、出口节点、grants、策略文件语法、对等中继和价格的页面。

这篇指南有帮助吗?

看看更多指南,或者在需要时联系我们。