隧道客户端
服务管理
使用交互菜单或指令注册、启动、停止及维护隧道客户端系统服务。
打开操作菜单
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。注册系统服务与在服务端登记连接凭据是两个步骤,注册服务本身不会让服务端接受凭据。
直接执行服务指令
也可以直接运行指令,无需打开菜单:
| 操作 | Windows | Linux |
|---|---|---|
| 注册服务 | .\zkipc-client.exe install | sudo ./zkipc-client install |
| 启动服务 | .\zkipc-client.exe start | sudo ./zkipc-client start |
| 停止服务 | .\zkipc-client.exe stop | sudo ./zkipc-client stop |
| 重启服务 | .\zkipc-client.exe restart | sudo ./zkipc-client restart |
| 卸载服务 | .\zkipc-client.exe uninstall | sudo ./zkipc-client uninstall |
| 查询状态 | .\zkipc-client.exe status | sudo ./zkipc-client status |
例如,在 Windows 注册并启动服务:
.\zkipc-client.exe install
.\zkipc-client.exe start
.\zkipc-client.exe status
系统服务名称及显示名称均为 zkipc-client。install 注册服务,start 启动已注册的服务;查询服务“正在运行”只表示本机进程运行,是否成功连接还需查看日志和云平台节点状态。
配置调整与升级
服务注册后请保留可执行文件及配置所在目录,避免移动或删除。修改配置后可重启服务使新配置生效。
升级时先停止服务,用新安装包中的可执行文件替换原文件,保留原有配置和连接凭据,再启动服务并确认节点在线。后续连接协议升级由新的客户端安装包提供。
需要迁移程序目录时,先停止并卸载旧服务,在新目录重新注册。卸载服务后仍可直接运行客户端;不要同时启动多个使用同一凭据的实例。
客户端支持上述六个服务指令和三个帮助入口。其他启动参数不开放,连接凭据及可调整设置请写入配置文件。