Guacamole RDP连接时initial-program参数无效，如何解决？

问题描述 #

我通过guacamole-common-js JavaScript库实现Web客户端连接RDP服务器，连接功能正常，但initial-program参数无法生效——配置后服务器不会自动启动指定程序。其他参数如enable-wallpaper、enable-font-smoothing均正常工作。我尝试过两种配置方式：

1. 在连接参数JSON中添加该字段：

{
     "hostname": "some-address",
     "port": "some-port",
     "domain": "",
     "username": "xxxxx",
     "password": "xxxxxx",
     "security": "any",
     "ignore-cert": "true",
     "initial-program" : "[Full path to .exe application]",
     "enable-wallpaper" : "false",
     "enable-font-smoothing" : "true"
}

2. 在Guacamole官方门户的参数文本框中配置该参数

两种方式均无效，想确认是参数用法有误，还是服务器端有特定要求？

可能的原因及解决办法 #

1. 参数格式不符合RDP协议要求 #

initial-program的值必须遵循RDP协议规定的格式，不能直接填写exe路径：

• 本地程序：需以||开头，例如 ||C:\full\path\to\your\app.exe
• 带参数的程序：||C:\full\path\to\your\app.exe argument1 argument2
• 网络共享路径：||\\server\share\app.exe

如果路径包含空格，需要用引号包裹，同时在JSON中转义特殊字符：

"initial-program": "||\"C:\\Program Files\\YourApp\\app.exe\""

2. 服务器端组策略限制 #

Windows服务器的组策略可能禁止通过RDP启动指定程序：

• 检查计算机配置>管理模板>Windows组件>远程桌面服务>远程桌面会话主机>远程会话环境中的允许用户使用远程桌面服务启动程序是否已启用
• 确认该策略未限制目标程序路径，或目标程序在允许列表内
• 确保登录账户有权限启动目标程序，且程序路径对该账户可见（避免使用管理员专属路径）

3. Guacamole版本兼容性 #

旧版本Guacamole对initial-program参数的解析存在bug，尤其是处理带空格的路径时。建议升级到最新稳定版（如1.5.x及以上），新版本修复了多处RDP参数相关问题。

4. 参数拼写错误 #

确认实际配置中参数名是initial-program（连字符格式），未写成initial_program或其他拼写错误，Guacamole参数名严格区分格式和大小写。

内容的提问来源于stack exchange，提问作者InversionDK