如何设置 Tailscale 并从外面访问家庭网络
在手机和电脑上安装 Tailscale,把家里一台设备设为子网路由器,就能访问家庭网络里的所有设备。附常见问题的解决方法。
**快速回答:**Tailscale 的设置分三部分:手机和电脑上的 App,家里一台常开的设备负责共享您的网络,以及在管理控制台里的一次批准。
- 在 tailscale.com 创建一个免费账户。
- 在手机和电脑上安装 App,用同一个账户登录。
- 在家里一台常开的设备上安装 Tailscale。Linux 上请先开启 IP 转发,再运行
sudo tailscale set --advertise-routes=192.168.1.0/24(换成您自己的网段)。 - 在管理控制台的 Machines 页面批准这条路由,并为该设备关闭密钥过期。
- 关掉手机的 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
- 从 App Store 安装 Tailscale。需要 iOS 15 或更高版本。
- 打开它,点 Get Started。
- 接受添加 VPN 配置的提示,并允许通知。通知会在密钥过期前提醒您。
- 点 Log in 并登录。
Android
- 从 Google Play 安装 Tailscale。需要 Android 8.0 或更高版本。
- 打开它,接受 VPN 连接请求。
- 点 Sign in with Google,或点 Sign in with other 使用 Apple、Microsoft 或 GitHub 登录。使用和之前相同的账户,并允许通知,这样密钥过期前您会收到提醒。
手机会自动接受子网路由,所以家里那一端设好之后,这里就不用再改什么了。
在电脑上安装 Tailscale
Windows
- 从 tailscale.com/download/windows 下载安装程序。需要 Windows 10 或更高版本。
- 运行它。系统托盘里会出现一个 Tailscale 图标(看不到的话检查一下溢出箭头)。
- 右键点击图标,选择 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 账户登录,就正好是这种情况。所以要先邀请:
- 打开管理控制台的 Users 页面,选择 Invite external users(邀请外部用户)。
- 输入对方的邮箱地址,或者用 Copy invite link 自己把链接发给对方。
- 让对方打开邀请并接受,然后再安装 App 并登录。
免费套餐最多 6 位用户。要限制每个人能访问什么,见访问规则。
把家里一台设备设为子网路由器
子网路由器会把您整个家庭网络共享给 tailnet,这样就能访问那些自身无法运行 Tailscale 的设备:灯光控制器、摄像头、打印机、路由器本身。尽量选一台常开并且有线接入网络的设备。然后批准路由(下一节)。
Raspberry Pi 或任何 Linux 机器
- 用 Raspberry Pi Imager 烧写 Raspberry Pi OS Lite。在 Imager 的自定义步骤中设置用户名、密码和主机名,启用 SSH,如果不用网线就再加上 Wi-Fi。
- 启动后,用您在 Imager 中设置的用户名和主机名连接:
ssh -l yourname yourhostname.local。 - 用上面的两条 Linux 命令安装 Tailscale 并登录。
- 开启 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)。
- 在 Home Assistant 中进入 Settings › Apps,打开应用商店,安装 Tailscale。
- 启动它,查看日志,然后打开它的 Web UI 并登录。该应用的文档建议这一步在电脑上用 Chrome 完成。
- 在应用的 Configuration 标签页,把您的网段加到
advertise_routes下,例如192.168.1.0/24。默认是一个空列表,所以不添加就什么都不会共享。 - 重启应用,然后在管理控制台批准路由。
该应用的文档还建议为 Home Assistant 这台机器关闭密钥过期。详情见 Tailscale 应用文档。
Unraid
Unraid 7 及更高版本请使用官方插件:
- 打开 Apps,搜索 Tailscale (Plugin) 并安装。忽略旧的 Docker 选项。
- 打开 Settings › Tailscale(在 Network Services 下),开启 Advanced View,选择 Reauthenticate,再选 Connect。
- 在插件的 Advertise Routes 部分,填入您的网段(
192.168.1.0/24),或只以/32填入服务器自己的 IP,然后选择 Apply。
来源:Unraid 文档、Tailscale 的 Unraid 页面。
Synology
- 打开 Package Center,搜索 Tailscale 并安装。
- 打开应用并登录。
- DSM 默认关闭 SSH。在 Control Panel › Terminal & SNMP › Enable SSH service 开启,然后用管理员账户连接。
- 运行
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 做子网路由器更简单。
批准路由并让它一直可用
- 打开管理控制台的 Machines 页面。通告了路由的设备带有 Subnets 标记。
- 选中该设备,进入它的 Subnets 部分,选择 Edit。
- 在 Subnet routes 下勾选您的路由,选择 Save。
- 回到 Machines 页面,打开该设备的菜单,选择 Disable Key Expiry(关闭密钥过期)。
密钥默认 180 天过期。子网路由器的密钥一过期,远程访问就会中断,直到有人重新登录它,而这种事偏偏总发生在您出门在外的时候。
从外面测试
- 在手机上关掉 Wi-Fi,确认 Tailscale 显示为已连接。
- 打开子网路由器的 Tailscale 地址(在 App 里或用
tailscale ip -4查看)。能打开说明 Tailscale 本身没问题。 - 用局域网 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 下完全一样。
故障排除
无法访问家庭网络里的设备
按顺序逐项检查:
- **路由批准了吗?**Machines 页面上,该设备的 Subnets 部分应显示这条路由,且没有待处理标记。
- **Tailscale IP 能通吗?**打开子网路由器的
100.x.y.z地址。连这个都不行,问题就在连接本身,不在路由。 - **IP 转发开了吗?**在 Linux 路由器上运行
sysctl net.ipv4.ip_forward,应该打印= 1。新版 Linux 客户端在它关闭时也会显示健康警告。 - **网段对吗?**路由必须覆盖目标设备。
192.168.1.0/24并不覆盖192.168.0.50。 - **Linux 客户端?**在外面的 Linux 笔记本需要
sudo tailscale set --accept-routes才能使用路由。留在家里的 Linux 机器请保持关闭(原因)。 - **两端网段相同?**如果您所在的 Wi-Fi 也用
192.168.1.x,您的设备会看到两个地址相同的网络。试试移动数据,或者把家庭网络改成一个不那么常见的网段。 - **访问规则?**如果您编辑过策略,确认它允许您访问这个子网。
- **密钥过期?**子网路由器一过期,所有人的路由都会停。到 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、策略文件语法、对等中继和价格的页面。