Podman 部署 guacd 和 Next Terminal 连接 Windows 11 笔记

环境说明

容器运行时：Podman
远程桌面服务：guacd + Next Terminal
目标操作系统：Windows 11

部署架构

使用 podman-compose 编排 guacd 和 Next Terminal 两个容器，使其处于同一 Podman 网络中，通过服务名互相访问。

docker-compose.yml 示例

version: '3.3'
services:
  guacd:
    image: dushixiang/guacd:latest
    volumes:
      - ./data:/usr/local/next-terminal/data
    restart: always
  next-terminal:
    image: dushixiang/next-terminal:latest
    environment:
      DB: sqlite
      GUACD_HOSTNAME: guacd
      GUACD_PORT: 4822
    ports:
      - "8088:8088"
    volumes:
      - /etc/localtime:/etc/localtime
      - ./data:/usr/local/next-terminal/data
    restart: always

部署命令

sudo podman-compose up -d

关键注意事项

确保 Podman 使用 netavark 网络后端，以支持容器间通过服务名通信。若遇到通信问题，可在 /etc/containers/containers.conf 中设置 network_backend = "netavark"。
Next Terminal 通过环境变量 GUACD_HOSTNAME 和 GUACD_PORT 指定 guacd 服务地址。

Windows 11 RDP 配置

基础配置

在“系统属性”中启用远程桌面：勾选“允许远程连接到此计算机”。
确保 Windows 防火墙允许 TCP 3389 端口的入站连接。

解决错误代码 519 的组策略调整

错误现象：连接时报错 错误代码:519，信息为 Server refused connection (wrong security type?)。

原因：Windows 11 默认启用网络级别身份验证（NLA），与某些版本的 guacd/FreeRDP 存在兼容性问题。

解决方案（通过组策略调整安全层）：

按下 Win + R，输入 gpedit.msc 并回车，打开组策略编辑器。
依次展开“计算机配置” -> “管理模板” -> “Windows 组件” -> “远程桌面服务” -> “远程桌面会话主机” -> “安全”。
在右侧找到“远程（RDP）连接要求使用指定的安全层”，双击打开。
选择“已启用”，然后在下方选项中选择“协商”或“RDP”。
点击确定，重启电脑或重启远程桌面服务使设置生效。

备选方案

如果组策略调整后仍无法连接，可在 Next Terminal 的 RDP 协议扩展参数中强制指定安全模式：

security: rdp

或

security: any

其他可能的问题原因及排查

guacd 进程写入权限

guacd 需要将远程主机的安全证书指纹写入用户家目录下的文件。若运行 guacd 的系统用户无家目录写入权限，连接可能失败。

排查方法：查看 guacd 容器日志，若出现 Unable to read file "/" 等提示，即为权限问题。
解决方案：确保运行 guacd 进程的用户（容器内通常为 root 或 guacd）拥有可写的家目录。

guacd/FreeRDP 版本兼容性

已知某些旧版本（如 1.5.4 及以下）存在相关 bug，已在 1.5.5 版本中修复。可尝试升级 guacd 到最新稳定版。

开启调试日志

若上述方法均无效，可开启 guacd 调试日志以获取详细错误信息：

修改 guacd 启动参数，增加 -L debug。
查看容器日志：sudo podman logs <guacd_container_name>。

后续优化建议

认证方式：可尝试在 RDP 扩展参数中强制使用 security: nla，测试组策略调整后是否能正常支持 NLA。
性能优化：在 RDP 扩展参数中添加 color-depth: 16 或 enable-printing: false 等参数，可降低带宽占用，提升操作流畅度。

NextTerminal连接 Windows