qoder本地模型服务启动失败因端口22222被占用，需查杀进程、修改config.json中qos_port字段、用socat端口转发或解除windows loopback限制来解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder本地模型服务启动失败，日志中出现“Address already in use”或“socket bind failed”，说明其默认监听端口（如22222）正被其他进程独占，必须立即释放或绕过该端口才能恢复AI代码补全、对话等核心功能。
查杀占用端口的进程
这是最直接、见效最快的解法，适用于能确认占用进程非系统关键服务的场景。
第一步：以管理员身份打开命令提示符（Windows）或终端（macOS/Linux）。
第二步：执行端口扫描命令——Windows输入 netstat -ano | findstr ":22222"，macOS/Linux输入 lsof -i :22222 或 netstat -tulnp | grep ":22222"。
第三步：从输出中找到状态为 LISTENING 的行，提取最后一列数字，这就是占用端口的进程PID。
第四步：强制终止该进程——Windows执行 taskkill /F /PID [PID数值]，macOS/Linux执行 kill -9 [PID数值]。
第五步：再次运行扫描命令，若无任何输出，说明端口已空闲，可直接重启Qoder服务。
修改Qoder配置文件更换监听端口
当无法终止占用进程（如企业办公机上该端口被安全软件长期占用），或需长期共存多个Qoder实例时，应优先改配置而非动系统。
打开配置文件：C:\Users\[用户名]\AppData\Local\.lingma\config.json（Windows）或 ~/.lingma/config.json（macOS/Linux）。
查找 "qos_port" 字段；若不存在，则在JSON根对象内新增一行："qos_port": 22223。
保存文件后，必须彻底结束所有 Lingma.exe 或 qoder 进程——Windows可用 taskkill /f /im Lingma.exe，macOS/Linux用 pkill -f Lingma。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
重新启动IDE，Qoder CN插件会自动读取新端口并连接。注意：不结束残留进程会导致旧端口仍在监听，新配置无效。
用socat做本地端口转发
适用于无法修改配置文件权限（如公司锁定的开发环境）、也无法获取管理员权限终止进程的受限场景。
方法一：先按上一节方式将Qoder配置为监听空闲端口（如22224），确保服务能正常启动并响应 curl http://localhost:22224/ping。
方法二：安装socat（macOS用 brew install socat，Linux用 apt install socat 或 yum install socat）。
方法三：在终端中执行转发命令：socat TCP-LISTEN:22222,fork TCP:localhost:22224 &。这条命令会让所有发往22222的请求自动转到22224，Qoder客户端仍使用原端口，无需任何插件改动。
注意：socat进程必须保持运行，关闭终端即失效；建议用nohup或systemd托管。
解除Windows Loopback限制
某些IDE（如IntelliJ系列）在沙盒模式下访问localhost会被系统拦截，报错“无法连接到本地服务”，实际并非端口冲突，而是回环通信被策略阻断。
以管理员身份运行PowerShell，执行：CheckNetIsolation LoopbackExempt -a -n="*"。该命令豁免所有本地应用的Loopback检查，一步到位。
验证是否生效：执行 CheckNetIsolation LoopbackExempt -s，输出列表中应包含 * 或对应IDE的AppContainer名称。
无需重启系统，改完立刻生效。此操作不影响系统安全模型，仅开放本机回环通信白名单。
