设置 SSH 以供远程使用 - Amazon Q 开发者版
本地 macOS 集成远程 Linux 集成已知限制条件故障排除

设置 SSH 以供远程使用

安装 Amazon Q CLI 后，您可以配置远程 Linux 集成，以便在远程计算机上启用 Amazon Q 的命令行功能。

本地 macOS 集成

要在本地 macOS 计算机上启用 SSH 集成：

  1. 打开终端或命令提示符。

  2. 启用本地 SSH 集成：

    q integrations install ssh

远程 Linux 集成

要在远程 Linux 计算机上配置 SSH 集成：

  1. 编辑 SSH 服务器配置：

    sudo -e /etc/ssh/sshd_config

  2. 将以下各行添加到配置文件的末尾：

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

  3. 重新启动 SSH 服务：

    sudo systemctl restart sshd

  4. 断开与 SSH 会话的连接并重新连接。

  5. 重新连接后，登录 Amazon Q：

    q login

  6. 验证安装：

    q doctor

已知限制条件

如果通过 SSH 连接到远程计算机时 Amazon Q 桌面客户端退出，则可能会重复打印一条错误消息：

connect to /var/folders/tg/u1vx4xfmvqav0oxfa4zfknaxiwmbsbr/T/cwrun/remote.sock port -2 failed: Connection refused

要停止错误，请退出 SSH 会话并重新连接，或者重新启动 Amazon Q 桌面客户端。

故障排除

如果您遇到 SSH 集成问题：

  1. 运行 q doctor 来识别和修复常见问题

  2. 确保本地配置和远程配置均正确无误

  3. 检查 SSH 服务器是否已正确配置为接受所需的环境变量。

  4. 验证您使用的是正确的系统版本（标准或 musl）