快速开始

全程约 20 分钟适用:Windows / Linux 源机最后更新:2026 年 10 月

从零接入分四步:装后端网关 → 添加源机 → 配置端口 → 打包客户端。下面用「演示客户端」和「演示服务端」两个示例程序说明流程,它们只代表普通的 PC 客户端与服务端,实际接入时按你自己的程序做同等配置即可。

0

先看清原来的连接方式

接入之前先确认:在没有防护的情况下,客户端和服务端是怎么通讯的。这样后面才知道要改哪里。

服务端

服务端目录:主程序与配置文件
服务端目录:主程序与配置文件

打开配置文件,重点是端口。实际业务可能有多个端口,这里只用一个做演示。

配置文件中的端口设置
配置文件中的端口设置

按默认配置启动服务端:

服务端启动后的界面
服务端启动后的界面

客户端

客户端目录:主程序与配置文件
客户端目录:主程序与配置文件

客户端配置里最关键的是服务端的 IP 和端口。图中打码部分就是真实的服务器 IP。

客户端配置:服务器 IP 与端口
客户端配置:服务器 IP 与端口

运行客户端,点击连接:

客户端连接界面
客户端连接界面

连接成功,并从服务端读到了欢迎文字:

连接成功,收到服务端返回内容
连接成功,收到服务端返回内容
关键结论:现在是客户端直连服务端 IP。接入防护后,这个 IP 会换成以 127 开头的本地地址,真实 IP 不再暴露在公网。
1

配置并安装后端网关

本产品采用双端隧道转发:客户端连本地 127 地址,防护节点中转,最后由你服务器上的网关把流量送到真实服务。所以必须在源机上安装后端网关,支持 Windows 与 Linux。

如果服务器不方便装第三方软件,可以把网关装在 Docker 容器里,或者单独开一台最小规格的虚拟机 / 云服务器专门跑网关。

Windows 系统按下面步骤:

  1. 登录控制台,点击「组件下载」。
  2. 把后端网关下载到服务器上。
  3. 解压到服务器任意位置。
  4. 运行安装脚本。这一步会把 NatSvr.exe 注册为系统服务,开机自动启动。
  5. 双击运行 NatUI.exe,这是网关的界面主程序,可以查看状态和修改配置。
控制台的「组件下载」入口
控制台的「组件下载」入口
下载后端网关
下载后端网关
解压到服务器任意位置
解压到服务器任意位置
运行安装脚本,注册为系统服务
运行安装脚本,注册为系统服务
双击运行 NatUI.exe 打开网关界面
双击运行 NatUI.exe 打开网关界面
网关界面主程序
网关界面主程序

如果是 Linux 系统,使用下载页提供的 Linux 安装脚本,按提示操作即可。安装过程没有图形界面,脚本提示安装成功就完成了。

2

添加需要防护的源机

源机就是你的业务服务器。它的 IP 始终处于防护之下,不会暴露给客户端。

  1. 在控制台的实例详情页找到「防护源机」,点击「添加源机」。
  2. 「源机地址」填后端服务器的公网 IP。
  3. 如果服务器有防火墙,必须放行 21088 端口——防护集群是通过这个端口把数据送到网关的。
实例详情中的「添加源机」入口
实例详情中的「添加源机」入口
填写源机地址,并放行 21088 端口
填写源机地址,并放行 21088 端口

添加完成后回到网关界面,状态应该显示为「链路已接通」。

网关显示链路已接通
网关显示链路已接通
如果状态没有变成「链路已接通」,先检查两件事:源机 IP 是否填对、防火墙是否真的放行了 21088。这两个占排查问题的九成。
3

配置转发端口

防护运行时,会在客户端本地以 127 开头的 IP 上开启对应端口做转发。所以你需要把业务实际用到的端口登记进去。

  1. 在实例详情页找到刚添加的「防护源机」,点击「端口规则」。
  2. 把需要转发的端口加进列表。多个端口点右侧加号;如果有大量连续端口,勾选「连续」后填一个区间即可。
源机行的「端口规则」入口
源机行的「端口规则」入口
添加端口,支持连续区间
添加端口,支持连续区间
注意区分 TCP 与 UDP,两种协议要分别添加。只加了 TCP,走 UDP 的业务照样连不上。
4

打包客户端

当前版本的 EXE 模式会生成一个入口启动文件,默认以「[盾].exe」结尾。启动后它会开启通讯转发,然后拉起原来的主程序。

这一步最容易出错。防护不会把子进程的网络请求强制转到 127 地址上。你必须手工改客户端配置文件,把原来填服务器真实 IP 的地方,全部换成分配的 127 开头地址。有些客户端可能有多处需要改。
  1. 点击右侧「打包封装」,按提示下载「打包工具」。
  2. 解压后运行「打包工具.exe」。
  3. 选择「EXE」模式。「接入码」是控制台显示的 32 位编码,复制粘贴过来;「客户端」选择要打包的入口文件;「图标」会自动匹配客户端里的图标,选中即可。
  4. 点击生成,保存到客户端相同文件夹。
  5. 查看盾机入口地址(这是后面要填进配置文件的关键信息)。
  6. 修改客户端配置:把服务器地址换成 127 开头的入口地址。
  7. 运行客户端验证。
「打包封装」入口与打包工具下载
「打包封装」入口与打包工具下载
打包工具目录,运行「打包工具.exe」
打包工具目录,运行「打包工具.exe」
选择 EXE 模式,填写接入码
选择 EXE 模式,填写接入码
点击生成并保存到客户端目录
点击生成并保存到客户端目录
查看盾机入口地址
查看盾机入口地址
把配置文件里的服务器地址改成 127 开头的入口地址
把配置文件里的服务器地址改成 127 开头的入口地址
运行客户端
运行客户端
客户端显示的连接地址已变为 127 开头
客户端显示的连接地址已变为 127 开头
连接成功,从服务器拿到返回结果
连接成功,从服务器拿到返回结果
如果生成时提示要覆盖原文件被阻止,可以先保存成别的名字,备份原文件后再改名替换。

接入完成后

到这里,客户端已经通过本地 127 地址走防护通道,源站真实 IP 不再暴露。后续可以:

  • 在控制台查看攻击清洗记录与流量曲线
  • 按需增加端口、增加源机
  • 需要对接自有业务系统时,参考 其他语言接入

连不上或者状态异常,直接看 端口连接失败诊断,那里按现象分了排查路径。

客户端 SDK 安装包含 Windows(x86 / x86_64)、Android、iOS 三个平台的库文件
下载 SDK