桌面版命令行参数完整速查
桌面版客户端支持一组命令行参数,部署脚本和自动化流程全靠它们。
参数速查表
| 参数 | 作用 |
|---|---|
--install / --uninstall | 安装 / 卸载后台服务 |
--silent-install | 静默安装服务并建快捷方式 |
--silent-install-noshortcuts | 静默安装但不建快捷方式 |
--invite-code <码> | 安装时按邀请码注册进面板 |
--enrollment-token <令牌> | 按注册令牌注册(批量部署首选) |
--wait-for-enrollment | 等待注册确认后按退出码报告(0 / 2 / 1) |
--connect <设备ID> | 启动即向指定设备发起连接 |
--qs | 快速支援模式:只收不发 |
--changeid | 更换本机设备 ID |
--remoteupdate | 检查并自动升级到最新版 |
--tray | 启动后最小化到托盘 |
--import-config <文件> | 导入指定配置文件 |
--mcp | MCP 服务器 stdio 模式(AI 代理子进程) |
--mcp-port <端口> | MCP 服务器 TCP 模式(默认 9222) |
可直接复制的组合
hoptodesk --silent-install
hoptodesk --silent-install --invite-code <码> --enrollment-token <令牌> --wait-for-enrollment
hoptodesk --connect 123456789
hoptodesk --qs
hoptodesk --mcp
两个高频用法展开
- 快速支援:把 exe 改名为以
-qs结尾(如 hoptodesk-qs.exe)效果同--qs——窗口精简成只显示 ID / 密码和入站设置,给长辈或客户发这个包,对方不会误触别的功能。 - 无人值守排查:装完服务后可用
--remoteupdate远程把旧客户端拉到最新,省去逐台手动升级。