QoderWake安全SSH连接需五步：一、用ssh-keygen -t ed25519生成带强口令的密钥；二、ssh-copy-id或手动注入公钥至authorized_keys并设chmod 600；三、sshd_config中启用PubkeyAuthentication yes、禁用PasswordAuthentication no；四、校验语法后重启sshd并确认端口监听；五、在QoderWake Remote Explorer中配置SSH连接字符串与私钥路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过QoderWake建立SSH远程连接至目标服务器，但连接失败或存在明文密码传输风险，则可能是由于密钥未生成、公钥未注入、服务端认证配置未生效或权限设置不当所致。以下是实现安全SSH远程连接的完整配置步骤：
一、生成高强度SSH密钥对
使用Ed25519算法生成密钥对可规避弱加密风险，确保私钥不可逆推且具备抗量子计算初步能力；私钥必须设置强口令以防止本地泄露后被直接利用。
1、在本地终端执行命令生成密钥：ssh-keygen -t ed25519 -C "qoderwake-admin@company.com"
2、提示保存路径时直接回车，采用默认路径 ~/.ssh/id_ed25519
3、输入至少12位含大小写字母、数字和符号的口令（passphrase）并确认
4、执行 ls -l ~/.ssh/id_ed25519 验证私钥权限是否为600
二、将公钥注入QoderWake目标服务器
公钥需准确写入服务器用户家目录下的 ~/.ssh/authorized_keys 文件，该文件必须严格限制权限，否则OpenSSH守护进程将拒绝密钥认证请求。
1、使用 ssh-copy-id -i ~/.ssh/id_ed25519.pub -p 2222 user@qoderwake-server-ip 自动上传并设权
2、若该命令不可用，手动登录服务器后执行：mkdir -p ~/.ssh && chmod 700 ~/.ssh
3、将客户端输出的整行公钥（以 ssh-ed25519 AAAA... 开头）粘贴至：echo "ssh-ed25519 AAAA..." >> ~/.ssh/authorized_keys
4、立即设置授权密钥文件权限：chmod 600 ~/.ssh/authorized_keys
三、修改SSH服务端配置强制启用密钥认证
仅部署密钥而不禁用密码登录等同于保留后门；必须通过 /etc/ssh/sshd_config 显式关闭密码验证通道，才能杜绝暴力破解可能。
1、以root权限编辑配置文件：sudo nano /etc/ssh/sshd_config
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、定位并确保以下两行未被注释且值正确：PubkeyAuthentication yes
3、将 PasswordAuthentication 行修改为：PasswordAuthentication no
4、如已更改SSH端口（例如2222），确认 Port 2222 已启用且与防火墙策略一致
四、校验并重启SSH服务
配置变更后必须语法校验并重载服务，否则修改不生效；同时需验证服务监听状态与实际连接行为是否符合预期。
1、执行 sudo sshd -t 检查配置文件语法是否正确
2、若无报错，运行 sudo systemctl restart sshd 重启服务
3、确认新端口监听状态：sudo ss -tlnp | grep ':2222'
4、从客户端发起测试连接：ssh -i ~/.ssh/id_ed25519 -p 2222 user@qoderwake-server-ip
五、配置QoderWake Remote SSH组件完成集成
QoderWake需通过Remote SSH扩展识别并管理已配置的SSH连接，该组件负责会话代理、密钥转发与连接上下文持久化。
1、在QoderWake界面左侧找到 Remote Explorer 视图，点击加号按钮
2、选择 SSH Configuration，粘贴如下格式连接字符串：ssh user@qoderwake-server-ip -p 2222
3、在弹出的密钥选择对话框中，指定私钥路径：~/.ssh/id_ed25519
4、保存配置后，点击连接图标，QoderWake将自动调用本地SSH代理完成密钥认证流程
