Qoder连接超时主因是Lingma服务未启动或关键域名无法访问。需先检查并启动Lingma进程，确认端口监听；再测试lingma-api.tongyi.aliyun.com和devops.aliyun.com连通性；若受内网限制，须正确配置HTTP代理并重启生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder连接超时错误表现为请求发出后长时间无响应，界面卡在加载状态或直接弹出“Connection timeout”提示，这通常说明客户端已发出请求但未在规定时间内收到服务端应答。
验证Qoder本地服务是否真正运行
Qoder CN依赖后台Lingma进程提供模型调度能力，该进程未启动是超时问题最常见原因。
打开任务管理器（Windows）或活动监视器（macOS），搜索进程名“Lingma”；若未找到，说明服务根本未运行。
进入目录：C:\Users\[用户名]\AppData\Local\.lingma\bin\x.x.x\CPU架构_64_系统\（Windows）或 ~/.lingma/bin/x.x.x/CPU架构_64_系统/（macOS），双击执行 Lingma.exe start 或终端中运行 ./Lingma start。
等待命令行输出类似 "Service started on http://127.0.0.1:8080" 的日志，确认端口监听就绪——没有这行输出，后续所有网络排查都无效。
测试核心API域名连通性
Qoder必须能访问两个关键域名才能完成初始化：lingma-api.tongyi.aliyun.com（模型调度）和 devops.aliyun.com（鉴权）。任一不通都会触发超时而非报错。
方法一：命令行快速检测
在终端执行：curl -I https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping，预期返回 HTTP 200 及响应体 “pong”；
再执行：curl -I https://devops.aliyun.com，预期返回 HTTP 302。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法二：绕过DNS查IP直连（当curl卡住时用）
先用 nslookup lingma-api.tongyi.aliyun.com 获取IP，再执行：curl -I --connect-timeout 3 --max-time 8 http://[IP]/algo/api/v1/ping。如果直连IP通但域名不通，说明是DNS污染或解析失败，不是代理问题。
注意：若两命令均超时超过10秒，大概率是企业防火墙拦截，需将这两个域名加入白名单。
配置HTTP代理解决内网受限问题
当无法加白名单时，必须通过公司IT提供的HTTP代理中转流量。配置错误比不配更糟——会把请求发往一个不存在的地址，导致连接被拒绝而非超时。
第一步：获取有效代理地址
向IT部门索取格式为 http://user:pass@proxy.company.com:8080 的代理字符串；密码含特殊字符（如@、/）必须URL编码，否则配置将失效。
第二步：写入config.json文件
定位到配置文件：C:\Users\[用户名]\AppData\Local\.lingma\config.json（Windows）或 ~/.lingma/config.json（macOS）；
用文本编辑器打开，查找 "http_proxy" 字段，将其值替换为上一步拿到的完整代理地址；
【务必删除字段前后多余的空格和中文引号】，JSON格式错误会导致Qoder启动失败。
第三步：重启生效
关闭Qoder主程序及所有后台进程（包括系统托盘里的Lingma图标），再重新启动。不重启，新代理设置不会加载。
