隧道客户端

安装与连接

完成 Windows 或 Linux 客户端解压、连接凭据登记及首次连接。

获取安装包

点击此处进行下载,访问密码:9527。请按支持平台选择安装包。

现场主机需要能够访问互联网,并能连接云端隧道服务。

Windows 解压与启动

  1. 使用解压工具打开 windows_amd64_zkipc-client.tar.gz,将全部文件解压到固定目录。
  2. 确认目录中同时存在 zkipc-client.exe 和 conf/zkipc-client.conf。
  3. 在该目录打开 PowerShell,运行以下指令进入菜单:
.\zkipc-client.exe help

输入 7 查看连接凭据。完成下方的凭据登记后,输入 0 退出菜单,再直接运行客户端:

.\zkipc-client.exe

不带参数时会直接连接服务器,不会打开菜单。前台运行期间请保持终端开启,按 Ctrl+C 停止客户端。长期运行建议注册系统服务。

Linux 解压与启动

以下示例使用 AMD64 安装包,其他架构请替换为对应的包名。在安装包所在目录运行:

sudo mkdir -p /opt/zkipc-client
sudo tar -xzf linux_amd64_zkipc-client.tar.gz -C /opt/zkipc-client
cd /opt/zkipc-client
sudo ./zkipc-client help

输入 7 查看连接凭据。完成凭据登记后,输入 0 退出菜单,再直接运行:

sudo ./zkipc-client

客户端需要写入配置和 /var/log 中的日志文件,以上示例使用超级用户权限运行。前台运行按 Ctrl+C 停止。

连接凭据登记

安装包中的 token 默认留空。首次直接启动、注册系统服务或在菜单中选择“查看连接凭据”时,客户端会自动生成 UUID 并保存到配置文件,后续启动复用同一凭据。

菜单中选择 7 后,将显示当前连接凭据。请登录飞鸟智联云平台,用户名为提供的手机号,初始密码为 123456。首次登录后请及时修改密码。

进入“隧道管理 → 节点管理”,按照节点管理说明新增或编辑节点,将客户端显示的凭据填写为对应节点的连接密钥并保存。随后启动客户端,等待节点状态变为在线,再按端口映射或域名代理说明配置访问方式。

自动生成凭据并不代表已在云平台完成节点登记,未登记时无法通过连接认证。

如果已经获得分配给该节点的连接密钥,可先将其填入 conf/zkipc-client.conf 的 token 配置项,再启动客户端。已有凭据不会被自动替换。

连接凭据用于隧道认证,与下载页面访问密码、云平台登录密码无关。每个节点应使用自己的凭据,升级或重启时保留原配置。

确认连接成功

连接成功时,终端或日志文件会显示:

2026-10-13 15:09:32 [信息] 已连接服务器:gateway.zkipc.cn

随后在云平台“隧道管理 → 节点管理”中确认对应节点在线,再配置端口映射或域名代理。连接成功仅表示客户端已接入云端,目标服务和访问映射仍需单独配置。

遇到认证、域名解析或网络问题时,参阅配置与排查。

© 2026 飞鸟智联