客户端安装：Windows 用安装包，其他设备一行命令

客户端装在你要暴露的那台设备上——服务跑在哪台机器，客户端就装哪台。它负责把这台设备上的服务接到蜻蜓映射，让外网能访问到。

安装方式取决于这台设备有没有图形界面，之后在哪里创建映射也跟着不同：

除 Windows 外，其余安装方式都要用一个 API Key 来认领设备。

登录控制台，在「个人设置」里复制它，形如 sk- 开头。下面命令里的 <你的 API Key> 全部换成它，引号不要删。

到官网下载页点「下载桌面客户端」，双击安装包按向导装完即可，结束后客户端会自动启动。

安装过程中系统可能弹出 SmartScreen 与 UAC 提示，这是 Windows 对下载文件的例行拦截，创建第一条映射第 1 步有逐屏截图说明怎么放行。

系统要求：Windows 10 及以上（64 位）。

在「终端」里执行：

curl -fsSL https://api.beesdc.com/api/v3/download/install.sh | FLYNAT_API_KEY="<你的 API Key>" sudo -E sh

脚本会自己识别你的芯片类型（Intel 或 Apple 芯片），装完即在后台运行。

系统要求：macOS 12 及以上。不知道怎么打开终端，见打开终端速查。

命令与 macOS 完全相同——脚本会自动识别系统和 CPU 架构，树莓派等 ARM 设备不需要换命令：

curl -fsSL https://api.beesdc.com/api/v3/download/install.sh | FLYNAT_API_KEY="<你的 API Key>" sudo -E sh

系统要求：glibc 2.31 及以上（对应 Ubuntu 20.04、Debian 11 及以上的发行版）。

先把镜像下载到本地：

curl -fsSL "https://api.beesdc.com/api/v3/download/docker?arch=$(uname -m)" | docker load

再启动容器：

docker run -d --name flynat \
  --network host --restart always \
  -e FLYNAT_API_KEY="<你的 API Key>" \
  -v flynat-data:/var/lib/flynat \
  -v flynat-bin:/opt/flynat \
  flynat/agent:latest

要求 Docker 20.10 及以上。--restart always 让容器随宿主机开机自动拉起；手动 docker stop 只管到下次开机，不想再跑就用 docker rm -f flynat 删掉容器。

群晖走的就是上面的 Docker 方式（DSM 里的套件叫 Container Manager 或 Docker，取决于系统版本）。完整步骤连同 DSM 的准备工作，见群晖 NAS 映射。

• 桌面客户端：登录后停在「内网穿透」页，能看到映射列表就说明已经连上。
• 命令安装：打开控制台的「映射管理」页——映射按客户端分组，你刚装的这台设备会出现在这里。控制台首页也能看到客户端数量。

新装的设备还没有任何映射是正常的，创建第一条之后就会挂在它下面。

• 客户端自带诊断：桌面客户端左侧「工具 → 工具箱」里的客户端诊断会逐段检查并给出修复建议，比手工排查快得多。完整排查路径见映射不通怎么办。
• 命令安装报错：确认命令里的 API Key 已经替换、引号完整，并且这台设备能正常访问互联网。

• 创建第一条映射 — 装好客户端之后的完整流程
• 安全指南 — 映射上线前该配的访问控制