错误代码10061表示目标计算机主动拒绝连接，主因是qoderwake后端服务未运行、端口配置不匹配、防火墙拦截、dns/hosts解析异常或代理干扰，需依次排查服务进程、监听端口、防火墙规则、域名映射及代理设置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake时遇到报错代码10061，提示“由于目标计算机积极拒绝”，说明客户端尝试建立TCP连接时，目标地址的指定端口未响应或明确拒绝了连接请求。以下是针对该错误的多种排查与修复方案：
一、确认QoderWake后端服务进程是否运行
QoderWake采用客户端-服务端通信架构，客户端需连接本地或远程后端服务。若服务进程未启动，则所有连接请求均会被操作系统直接拒绝，触发10061错误。
1、打开任务管理器，切换到“详细信息”选项卡。
2、在进程列表中查找名为 qoderwake-service.exe 或 QoderWakeServer 的进程。
3、若未找到该进程，说明服务未启动；此时需手动执行安装目录下的服务启动脚本，例如双击 start-server.bat 或在命令行中运行 npm run serve（如为Node.js版本）。
4、启动后再次检查进程是否存在，并观察其CPU/内存占用是否正常。
二、验证服务监听地址与端口配置
即使服务进程存在，若其绑定的IP地址或端口与客户端请求不一致，连接仍会被拒绝。常见原因为配置文件中host设为127.0.0.1但客户端尝试访问localhost，或端口被其他程序占用。
1、定位QoderWake配置文件，通常位于 C:\Users\{用户名}\AppData\Local\QoderWake\config.json 或安装目录下的 config.yaml。
2、检查其中 server.host 和 server.port 字段值，确认是否为 127.0.0.1:8080（或其他预期值）。
3、在命令提示符中执行：netstat -ano | findstr :8080（将8080替换为实际端口），确认该端口是否处于 LISTENING 状态并归属正确PID。
4、若端口被占用，可修改配置文件中端口号，或结束占用进程（通过PID查进程名后终止）。
三、检查本地防火墙与安全软件拦截
Windows Defender 防火墙或第三方安全软件可能阻止入站连接，尤其当QoderWake服务首次运行时未获得网络访问权限。
1、按下 Win + R，输入 wf.msc 打开高级安全Windows防火墙。
2、在左侧点击“入站规则”，在右侧点击“新建规则…”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、选择“程序”，点击“下一步”，浏览并选中 qoderwake-service.exe 的完整路径。
4、在“操作”页选择“允许连接”，在“配置文件”页勾选全部网络类型，命名规则为 QoderWake Service Inbound 后完成。
5、临时禁用第三方杀毒软件（如360、火绒），再测试连接是否恢复。
四、验证DNS解析与hosts映射一致性
当客户端配置使用域名（如 qoderwake.local）连接服务，而该域名未正确解析至127.0.0.1时，系统可能尝试连接无效IP，最终因无响应返回10061。
1、以管理员身份运行命令提示符，执行：ping qoderwake.local，确认返回IP是否为 127.0.0.1。
2、若未返回127.0.0.1，编辑系统hosts文件：C:\Windows\System32\drivers\etc\hosts。
3、在文件末尾添加一行：127.0.0.1 qoderwake.local，保存前需确保以管理员权限打开文本编辑器。
4、执行 ipconfig /flushdns 清除DNS缓存。
5、再次ping验证解析结果是否生效。
五、检查代理设置与网络中间件干扰
若系统或IDE（如JetBrains系列）启用了HTTP代理，且代理未转发本地回环请求，可能导致QoderWake客户端流量被错误路由或静默丢弃，表现为连接被拒。
1、检查环境变量中是否设置 HTTP_PROXY 或 HTTPS_PROXY，可在命令行运行 echo %HTTP_PROXY% 查看。
2、在QoderWake客户端配置界面中，查找“网络”或“代理”选项，确认是否启用“绕过本地地址”或“忽略localhost代理”功能，并开启该选项。
3、若使用IDE插件形式，进入IDE设置 → Appearance & Behavior → System Settings → HTTP Proxy，选择 No proxy 或在“No proxy host”中添加 127.0.0.1,localhost,qoderwake.local。
4、重启IDE及QoderWake服务，重新触发连接。
