設定 SSH 供遠端使用
安裝 Amazon Q CLI 之後,您可以設定遠端 Linux 整合,以在遠端電腦上啟用使用 Amazon Q 的命令列功能。
本機 macOS 整合
若要從本機 macOS 電腦啟用 SSH 整合:
-
開啟您的終端或命令提示字元。
-
啟用本機 SSH 整合:
q integrations install ssh
遠端 Linux 整合
若要在遠端 Linux 電腦上設定 SSH 整合:
-
編輯您的 SSH 伺服器組態:
sudo -e /etc/ssh/sshd_config -
在 cofig 檔案結尾新增下列各行:
AcceptEnv Q_SET_PARENT AllowStreamLocalForwarding yes -
重新啟動 SSH 服務:
sudo systemctl restart sshd -
從 SSH 工作階段中斷連線,再重新連線。
-
重新連線後,登入 Amazon Q:
q login -
驗證安裝:
q doctor
已知限制
如果 Amazon Q 桌面用戶端在透過 SSH 連線至遠端電腦時結束,則可能會重複列印錯誤訊息:
connect to /var/folders/tg/u1vx4xfmvqav0oxfa4zfknaxiwmbsbr/T/cwrun/remote.sock port -2 failed: Connection refused
若要停止錯誤,請退出 SSH 工作階段,再重新連線或重新啟動 Amazon Q 桌面用戶端。
故障診斷
如果您遇到 SSH 整合的問題:
-
執行 q doctor 以識別並修正常見的問題
-
確認本機和遠端組態正確無誤
-
查看您的 SSH 伺服器是否已正確設定,以接受所需的環境變數
-
確認您使用適合系統的正確版本 (標準或 musl)