客户端接入（Windows / macOS / Linux / Android / iOS）

使用 Tailscale 连接 Cloudog 服务器

本文档说明如何在 Windows、macOS、Linux、Android、iOS 上通过 Tailscale 连接到 Cloudog 内网服务器。

Cloudog 服务器信息

• Cloudog 服务器地址（Login Server）
  https://connect.cloudog.net

• 预授权 Key（Auth Key）
  8c5204314bexxxxxxxxxxb17e3468cc64a

请勿将以上信息对外公开。

---

一、Windows 客户端

Windows 视频教程

如何使用Cloudog三分钟搭建完成十几毫秒超低延迟的异地组网——Windows篇

1. 下载并安装 Tailscale

• 下载地址：从 Tailscale 官网下载 Windows 安装包
  https://tailscale.com/download

或从 Cloudog 内部下载页面获取：

• Cloudog 下载地址：https://cloudog.net/download
• 安装包文件名示例：tailscale-setup-latest.exe（约 1.4MB）

双击运行安装包并完成安装。

2. 通过命令行连接 Cloudog 服务器

1. 打开 PowerShell 或 命令提示符 (cmd)。
2. 执行以下命令：

tailscale up --login-server=https://connect.cloudog.net --authkey=8c5204314be63xxxxxxxbdb17e3468cc64a --accept-routes

3. 检查连接状态

tailscale status

看到自己的节点在线、并且可以看到 Cloudog 内部节点，即表示连接成功。

---

二、macOS 客户端

macOS 视频教程

如何使用Cloudog三分钟搭建完成十几毫秒超低延迟的异地组网——mac篇

1. 安装 Tailscale

可以通过以下任一方式安装：

• 从官网下载安装包：https://tailscale.com/download
• 使用 Homebrew：

brew install --cask tailscale

安装完成后，确保 Tailscale 已经启动（菜单栏会出现 Tailscale 图标）。

2. 通过 CLI 连接 Cloudog 服务器

在 终端 (Terminal) 中执行：

sudo tailscale up --login-server=https://connect.cloudog.net --authkey=8c5204314be63xxxxxxxbdb17e3468cc64a --accept-routes

3. 检查连接状态

tailscale status

如果可以看到 Cloudog 内部节点，说明连接成功。

---

三、Linux 客户端

以下示例以常见的 Debian/Ubuntu 系为例，其他发行版请参考 Tailscale 官方文档。

Linux 视频教程

如何使用Cloudog三分钟搭建完成十几毫秒超低延迟的异地组网——linux篇

1. 安装 Tailscale

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

2. 通过 CLI 连接 Cloudog 服务器

sudo tailscale up --login-server=https://connect.cloudog.net --authkey=8c5204314be63xxxxxxxbdb17e3468cc64a --accept-routes

3. 检查连接状态

tailscale status

如能看到 Cloudog 内部服务节点，代表接入成功。

---

四、Android 客户端

1. 安装 Tailscale App

在 Google Play 商店 搜索 “Tailscale” 并安装官方应用。

2. 登录并连接 Cloudog

1. 打开 Tailscale App。
2. 使用分配的账号登录（如果组织已配置单点登录，按页面提示完成授权）。
3. 在登录后，客户端会从 Cloudog 的管理端获取路由和访问策略。
4. 打开 Tailscale 开关，等待状态变为已连接。

※ 如果需要自定义登录服务器为 https://connect.cloudog.net，请根据你们的组织设置进行配置（通常由管理员提前配置好）。

---

五、iOS 客户端（iPhone / iPad）

1. 安装 Tailscale App

在 App Store 搜索 “Tailscale” 并安装官方应用。

2. 登录并连接 Cloudog

1. 打开 Tailscale App。
2. 使用公司账号登录并完成授权。
3. 确认连接启用，看到状态为已连接。
4. 此时可以访问通过 Cloudog 暴露的内网服务。

如需指定登录服务器为 https://connect.cloudog.net，请遵循运维侧提供的具体配置流程。

---

六、常见问题

• Q: 命令中的 Auth Key 是否可以长期使用？
  A: 出于安全考虑，建议定期轮换预授权 Key，并在文档和脚本中及时替换。

• Q: 连接成功但无法访问内部服务？
  A: 请检查是否启用了 --accept-routes，以及 Cloudog 侧路由和 ACL 是否允许访问目标服务。

• Q: 更换设备后如何处理？
  A: 可以在 Cloudog/Tailscale 管理后台中移除旧设备，重新在新设备上按照对应平台步骤重新接入。