Qoder连接超时需按五步排查：一、验证SSH连通性与sshd服务状态；二、检查磁盘空间、权限及外网下载能力；三、延长客户端超时至300秒并配置SSH保活；四、手动下载部署服务端二进制；五、检查云安全组、本地防火墙及网络策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过Qoder连接服务器进行远程开发或部署，但连接过程长时间无响应或直接报超时错误，则可能是由于SSH通道未建立、远程服务组件安装失败或网络策略拦截所致。以下是解决此问题的步骤：
一、验证SSH基础连通性与服务状态
该步骤用于排除Qoder底层依赖的SSH协议层故障，确认服务器是否可被正常访问、SSH守护进程是否运行、端口是否开放。
1、在本地终端执行：ssh -v -p 22 username@server_ip（若使用非标准端口，请替换22）。
2、观察输出：若卡在debug1: Connecting to server_ip [server_ip] port 22后超时，说明网络或防火墙阻断；若出现Connection refused，表明sshd未监听该端口。
3、通过云平台Web Shell或VNC登录服务器，执行：sudo systemctl status sshd，确认服务状态为active (running)。
4、检查端口监听：sudo ss -tlnp | grep ':22'，确保输出中包含LISTEN且绑定地址为0.0.0.0:22或[::]:22。
二、检查远程服务组件安装失败原因
Qoder在首次连接时需在服务器端部署专用服务组件，若磁盘空间不足、权限受限或外网下载受阻，将导致“Failed to install server within the timeout”错误。
1、登录服务器后执行：df -h，重点查看/和/var分区使用率，若任一达到95%以上，需立即清理日志或临时文件。
2、检查当前用户对~/.qoder-server目录的写入权限：ls -ld ~/.qoder-server；若目录不存在，手动创建并赋权：mkdir -p ~/.qoder-server && chmod 700 ~/.qoder-server。
3、测试服务器对外网下载能力：curl -I https://qoder.blob.core.windows.net/releases/latest，若返回超时或拒绝连接，说明存在外网访问限制。
三、调整Qoder客户端超时与保活参数
默认30秒超时不足以应对慢速网络下的组件下载或高延迟环境下的SSH握手，需显式延长时限并启用连接保活机制。
1、在本地Qoder设置中定位远程连接配置项，将Remote Server Install Timeout值修改为300（单位：秒）。
2、编辑本地~/.ssh/config文件，在对应Host块内追加以下三行：
ServerAliveInterval 60
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
ServerAliveCountMax 3
TCPKeepAlive yes
3、保存配置后重启Qoder客户端，重新触发连接流程。
四、绕过自动安装，手动部署Qoder服务端
当网络策略完全禁止外网访问时，可预先在本地下载服务端二进制文件，再通过其他SSH工具上传至服务器完成离线部署。
1、在本地浏览器访问Qoder官方发布页，根据服务器架构（x86_64 / aarch64）和系统类型（Linux glibc）下载对应qoder-server-v*.tar.gz包。
2、使用普通SSH工具（如OpenSSH或MobaXterm）登录服务器，执行：mkdir -p ~/.qoder-server。
3、将下载的压缩包上传至服务器~/.qoder-server/目录下。
4、在服务器端解压并赋予执行权限：tar -xzf qoder-server-v*.tar.gz -C ~/.qoder-server/ && chmod +x ~/.qoder-server/qoder-server。
5、重命名主程序为qoder-server并确保其位于~/.qoder-server/路径根目录。
五、排查云平台安全组与中间网络策略
即使SSH命令行可连通，云服务商安全组或企业出口防火墙仍可能对Qoder使用的长连接、端口转发或多路复用行为实施额外限制。
1、登录云服务商控制台，进入目标实例的安全组规则页，确认入方向存在一条规则：协议类型为TCP，端口范围为22，授权对象为0.0.0.0/0或指定IP段。
2、切换本地网络环境（例如启用手机热点），再次尝试Qoder连接；若成功，则原网络存在策略拦截。
3、在本地Windows系统中，打开Windows Defender 防火墙高级设置，检查出站规则中是否存在阻止qoder.exe或ssh.exe的条目。
4、在本地Linux主机执行：sudo ufw status verbose，确认ufw未启用或已允许22端口出站。
