使用 Tailscale 连接您的服务器
在 Debian 或 Ubuntu 上安装 Tailscale,将多台服务器接入同一私有网络,编写访问规则,并通过 UFW 将 SSH 限定在该网络内。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何使用 Tailscale 连接您的服务器和工作电脑。每台机器都会获得一个 100.x.y.z 形式的私有地址,并通过加密的 WireGuard 隧道与其他机器通信,您无需管理密钥,也无需为每条连接开放端口。
完成本指南后,您的服务器将在这个称为 tailnet 的私有网络中互相通信,只有您定义的访问才会被允许,并且 SSH 将无法再从公网地址访问。
订购服务器
本指南适用于由您自行管理的服务器:
前提条件
- 一台或多台运行 Debian 12 或 13,或 Ubuntu 22.04 或 24.04 的服务器
- 使用具有
sudo权限的用户进行 SSH 访问 - 一个 Tailscale 账户
- 在您的工作电脑上通过下载页面安装 Tailscale
- 服务器的备用访问方式,例如 VPS 的 VNC 控制台或救援模式
本指南将服务器命名为 web-1 和 db-1。
使用的端口
Tailscale 通常不需要任何入站端口:各机器会主动发起出站连接。
| 端口 | 方向 | 作用 |
|---|---|---|
| 443/tcp | 出站 | 协调服务和 DERP 中继 |
| 41641/udp(源端口) | 出站 | 直连 WireGuard 隧道 |
| 3478/udp | 出站 | STUN,用于发现公网地址 |
| 41641/udp | 入站,可选 | 有利于建立直接连接 |
步骤 1:安装 Tailscale
在每台服务器上,添加与您的系统对应的官方软件源,然后安装软件包:
. /etc/os-release
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.noarmor.gpg" | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.tailscale-keyring.list" | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update
sudo apt-get install -y tailscale
tailscale version步骤 2:连接服务器
发起连接,然后在浏览器中打开显示的 URL 以授权该机器:
sudo tailscale up接着为每台服务器指定一个清晰的名称,此处第一台命名为 web-1,第二台命名为 db-1:
sudo tailscale set --hostname=web-1查看其 Tailscale 地址,并列出 tailnet 中的机器:
tailscale ip -4
tailscale status步骤 3:验证连接
在 web-1 上测试 db-1:
tailscale ping db-1
ping -c 3 db-1tailscale ping 的响应会指明所用的路径。via DERP(...) 表示经过了中继,而 IP:port 形式的地址表示直接连接。短名称依赖 MagicDNS,在较新的 tailnet 上该功能默认启用。如果无法解析 db-1,请使用其 100.x.y.z 地址。
步骤 4:避免服务器密钥过期
机器的密钥默认在 180 天后过期。密钥过期的服务器会退出 tailnet,如果没有其他方式访问 SSH,这就会造成阻塞。
在机器页面中,打开每台服务器右侧的菜单,然后选择 Disable Key Expiry。
步骤 5:为服务器打标签
标签让服务器拥有独立于您账户的身份,便于编写易读的规则。
打开页面 Access controls。将下面两个部分添加到现有文件中;如果文件中已有这些部分,请补充完整,不要删除其余内容。将 TAILSCALE_EMAIL 替换为您账户的确切邮箱地址,然后保存:
"groups": {
"group:admins": ["TAILSCALE_EMAIL"]
},
"tagOwners": {
"tag:server": ["group:admins"]
},返回 Machines。在每台服务器的菜单中选择 Edit tags,添加 tag:server,然后保存。
步骤 6:限制访问
默认情况下,tailnet 中的所有机器都可以互相访问。请将策略文件的内容替换为下面的内容,只允许必要的访问:
{
"groups": {
"group:admins": ["TAILSCALE_EMAIL"]
},
"tagOwners": {
"tag:server": ["group:admins"]
},
"acls": [],
"grants": [
{
"src": ["group:admins"],
"dst": ["tag:server"],
"ip": ["tcp:22", "icmp:*"]
},
{
"src": ["tag:server"],
"dst": ["tag:server"],
"ip": ["tcp:5432", "icmp:*"]
}
],
"tests": [
{
"src": "group:admins",
"proto": "tcp",
"accept": ["tag:server:22"]
},
{
"src": "tag:server",
"proto": "tcp",
"accept": ["tag:server:5432"],
"deny": ["tag:server:22"]
}
]
}| 部分 | 作用 |
|---|---|
groups |
将获得授权的账户归为一组 |
tagOwners |
指明谁可以分配每个标签 |
acls |
规则的旧式写法。此处留空,可避免回退到允许一切访问的默认策略 |
grants |
推荐的访问规则写法。未在其中列出的一切都会被拒绝 |
tests |
每次保存时执行的检查。只要其中一项失败,文件就会被拒绝 |
按此示例,您的设备可以通过 SSH 访问服务器,服务器之间则通过端口 5432(PostgreSQL 的端口)通信。请将该端口替换为您自己服务的端口。若有多个端口,可以写成例如 "ip": ["tcp:5432", "tcp:6379"]。
然后在 web-1 上检查结果。端口 22 的命令应当失败:
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 db-1 5432
nc -vz -w 3 db-1 22只有当某个服务在 Tailscale 可访问的地址上监听端口 5432 时,该端口的测试才会成功。在您的电脑上,ssh 您的用户名@web-1 应当可以正常工作。
步骤 7:将 SSH 限定在私有网络内
首先在您的电脑上通过 Tailscale 打开一个会话:
ssh 您的用户名@web-1在该会话中,允许 Tailscale 接口并应用默认策略:
sudo ufw allow in on tailscale0
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status numbered请回答 y 以确认启用 UFW。tailnet 内机器之间的过滤由步骤 6 的规则负责。如果服务器发布网站,请保留或添加 80/tcp 和 443/tcp 规则。
然后删除公网的 SSH 规则(如果存在):
sudo ufw delete allow 22/tcp
sudo ufw status verbose如果您的规则名称不同,例如 OpenSSH,请使用 sudo ufw delete allow OpenSSH。
验证结果
通过 Tailscale 打开一个新的会话。它应当成功:
ssh 您的用户名@web-1在 tailnet 之外的机器上,或在您的电脑上停止 Tailscale 之后,连接公网地址应当超时:
ssh -o ConnectTimeout=5 您的用户名@您的服务器IP可选:使用 Tailscale SSH
使用 Tailscale SSH 时,认证基于您的 Tailscale 身份,而不是 SSH 密钥。OpenSSH 及其文件不会被修改,但 Tailscale 会接管 Tailscale 地址上的 22 端口。
将下面这一部分添加到策略文件中,并指明获得授权的 Linux 账户:
"ssh": [
{
"action": "accept",
"src": ["group:admins"],
"dst": ["tag:server"],
"users": ["您的用户名"]
}
],步骤 6 中的 tcp:22 规则仍然需要保留。然后在服务器上启用该功能。已在 Tailscale 地址上打开的 SSH 会话会卡住:之后请重新连接。
sudo tailscale set --ssh若要还原,请使用 sudo tailscale set --ssh=false。
无需浏览器添加服务器
使用认证密钥可以免去打开 URL 的步骤。请在控制台的 Keys 页面创建它,最好设为一次性使用并带有标签 tag:server,然后在新服务器上使用:
sudo tailscale up --auth-key=TAILSCALE_AUTH_KEY请像对待密码一样对待这个密钥,不要将其留在脚本或 shell 历史记录中。其有效期最长为 90 天。
更新
使用 APT 更新软件包:
sudo apt-get update
sudo apt-get install --only-upgrade -y tailscale
tailscale version您也可以启用自动更新:
sudo tailscale set --auto-update重启 Tailscale 会中断 Tailscale SSH 会话,并可能影响经由 tailnet 的会话。如果 Tailscale 是您唯一的访问方式,请在 tmux 或 screen 中执行更新。
备份
服务器将其身份保存在 /var/lib/tailscale/tailscaled.state 中。该文件包含密钥:无需备份,因为重新安装后只需使用 sudo tailscale up 重新连接该机器即可。请勿将其复制到其他机器上。
需要保留的是您的策略文件。请在私有仓库或文档保险库中保存一份最新的副本。
故障排除
Failed to connect to local Tailscale daemon
服务尚未启动:
sudo systemctl enable --now tailscaled
sudo journalctl -u tailscaled --no-pager -n 50如果日志中提到 /dev/net/tun,说明系统无法访问 TUN 设备。这种情况主要出现在容器中运行的系统。
Logged out. 或 Tailscale is stopped.
机器已断开连接,或其密钥已过期。请重新运行 sudo tailscale up,然后按步骤 4 的说明禁用密钥过期。
changing settings via 'tailscale up' requires mentioning all non-default flags
tailscale up 要求给出所有已自定义的参数。若只想修改某一项设置,请使用 tailscale set,例如 sudo tailscale set --hostname=web-1。
连接经过了中继
在 tailscale status 中,出现 relay 表示流量没有直连。服务仍可使用,只是性能有时会稍差。请分析网络,必要时再开放可选端口:
tailscale netcheck
sudo ufw allow 41641/udpping 正常,但服务无法访问
- 请确认有一条
grants规则允许这些机器之间使用该端口。 - 请确认服务不是只监听
127.0.0.1:sudo ss -ltnp。 - 请在控制台中检查该机器的标签。
策略文件被拒绝
请阅读控制台显示的消息。它会指出语法错误,或指出 tests 部分中有某个测试与规则不一致。此外,标签必须先在 tagOwners 中声明才能使用。
服务器的 DNS 名称不再能解析
Tailscale 可以接管机器的 DNS。如果这妨碍了您的配置,请禁用该功能。禁用后短名称在这台服务器上将不再可用:此时请使用 100.x.y.z 地址。
sudo tailscale set --accept-dns=false无法再通过 SSH 访问
请通过备用访问方式登录,然后临时恢复公网规则。修复 Tailscale 后,再删除该规则:
sudo ufw allow 22/tcp
sudo tailscale status
sudo tailscale up