在极空间(Zspace)上安装 Tailscale,目前最主流且稳定的方式是通过 Docker 部署。极空间系统虽然目前已有内建的远程访问功能,但使用 Tailscale 可以实现更强大的虚拟内网组网。
以下是为您准备的详细保姆级教程:
第一步:准备 Tailscale Auth Key
在安装之前,建议先获取一个授权密钥,这样可以让 Docker 容器启动后自动关联你的账号。
-
登录 Tailscale 管理控制台。
-
进入 Settings → Keys。
-
点击 Generate auth key。
-
建议勾选 Reusable(可重复使用)和 Ephemeral(临时设备,若容器删除则设备自动离线),然后点击生成并复制保存该 Key(格式通常为
tskey-auth-xxx)。
第二步:极空间 Docker 安装步骤
-
打开 Docker 管理器:进入极空间桌面,点击“Docker”图标。
-
下载镜像:
-
在“镜像仓库”中搜索
tailscale/tailscale。 -
选择
latest版本下载。
-
-
配置容器:
-
在“本地镜像”中找到下载好的镜像,点击添加到容器。
-
基础设置:
-
容器名称:
tailscale -
勾选“能力”中的
NET_ADMIN(非常重要,否则无法修改网络路由)。
-
-
路径设置(存储卷):
-
在极空间上创建一个文件夹(例如:
/docker/tailscale)。 -
装载路径设置为:
/var/lib/tailscale(用于持久化保存登录状态和配置)。
-
-
网络设置:
- 切换为 host 模式(主机网络)。
-
环境设置(点击添加变量):
-
TS_AUTHKEY:填入你刚才在第一步申请的tskey-auth-xxx。 -
TS_STATE_DIR:/var/lib/tailscale。 -
TS_USERSPACE:建议设置为false。
-
-
-
应用启动:点击完成,启动容器。
第三步:验证与后续配置
-
验证状态:回到 Tailscale Machines 页面,你应该能看到名为
tailscale的新设备(极空间)已上线。 -
设置子网路由(可选但强烈建议):
如果你想通过 Tailscale 访问极空间所在局域网的其他设备(如路由器、摄像头),需要在极空间 Docker 的“终端”中执行以下命令:
Bash
tailscale up --advertise-routes=192.168.x.0/24 --accept-dns=false(注:将
192.168.x.0/24替换为你家里的实际网段) -
管理后台开启路由:在 Tailscale 官网后台,点击该设备旁边的三个点
...→ Edit route settings,勾选你刚才发布的子网段并保存。
常见问题说明
-
权限问题:极空间部分机型可能需要开启“特权模式”,在容器创建时的“基础设置”中可以找到该开关。
-
断连恢复:因为使用了路径挂载(
/var/lib/tailscale),即使你重启极空间或更新 Docker 镜像,也不需要重新扫码登录。