隧道客户端

服务管理

使用交互菜单或指令注册、启动、停止及维护隧道客户端系统服务。

打开操作菜单

Windows 请使用管理员权限打开 PowerShell,并进入客户端所在目录:

.\zkipc-client.exe help

Linux 进入客户端所在目录后运行:

sudo ./zkipc-client help

help、--help 和 -h 均会打开同一个交互菜单。输入序号执行操作,操作结束后返回菜单:

序号操作
1注册系统服务
2启动系统服务
3停止系统服务
4重启系统服务
5卸载系统服务
6查询系统服务状态
7查看连接凭据;为空时生成并保存
0退出菜单

首次使用建议先选择 7,完成凭据登记,再依次选择 1 和 2。注册系统服务与在服务端登记连接凭据是两个步骤,注册服务本身不会让服务端接受凭据。

直接执行服务指令

也可以直接运行指令,无需打开菜单:

操作WindowsLinux
注册服务.\zkipc-client.exe installsudo ./zkipc-client install
启动服务.\zkipc-client.exe startsudo ./zkipc-client start
停止服务.\zkipc-client.exe stopsudo ./zkipc-client stop
重启服务.\zkipc-client.exe restartsudo ./zkipc-client restart
卸载服务.\zkipc-client.exe uninstallsudo ./zkipc-client uninstall
查询状态.\zkipc-client.exe statussudo ./zkipc-client status

例如,在 Windows 注册并启动服务:

.\zkipc-client.exe install
.\zkipc-client.exe start
.\zkipc-client.exe status

系统服务名称及显示名称均为 zkipc-client。install 注册服务,start 启动已注册的服务;查询服务“正在运行”只表示本机进程运行,是否成功连接还需查看日志和云平台节点状态。

配置调整与升级

服务注册后请保留可执行文件及配置所在目录,避免移动或删除。修改配置后可重启服务使新配置生效。

升级时先停止服务,用新安装包中的可执行文件替换原文件,保留原有配置和连接凭据,再启动服务并确认节点在线。后续连接协议升级由新的客户端安装包提供。

需要迁移程序目录时,先停止并卸载旧服务,在新目录重新注册。卸载服务后仍可直接运行客户端;不要同时启动多个使用同一凭据的实例。

客户端支持上述六个服务指令和三个帮助入口。其他启动参数不开放,连接凭据及可调整设置请写入配置文件。

© 2026 飞鸟智联