问题：Apifox报错ELANREFUSED，Agent服务器拒绝局域网请求如何解决？

Question

**问题描述：** 在使用 Apifox 进行接口调试时，出现报错信息：“ELANREFUSED”，提示 Agent 服务器拒绝局域网请求。该问题通常发生在本地服务未正确配置或网络环境限制的情况下，导致 Apifox 无法通过局域网访问目标服务。常见原因包括防火墙拦截、Agent 服务未启动、IP 地址或端口配置错误、跨域限制等。如何检查并配置 Apifox Agent 的网络权限与服务状态，以解决“ELANREFUSED”错误，确保局域网请求正常通信？

Answer 1

解决 Apifox 接口调试中 “ELANREFUSED” 错误的完整指南

关键词：Apifox、Agent 服务器、局域网请求、防火墙拦截、IP 地址配置、端口配置、跨域限制、网络权限、服务状态、接口调试错误

一、问题定位：理解“ELANREFUSED”错误的本质

在使用 Apifox 进行接口调试时，出现“ELANREFUSED”错误提示，通常表示客户端（如浏览器）尝试通过局域网访问本地运行的 Agent 服务失败。该错误的核心在于 ELANREFUSED 是 Node.js 的错误代码之一，表示连接被目标服务器拒绝。

• 常见场景：Apifox 云端调用本地接口时，通过局域网 IP 访问本地服务。
• 本质原因：Agent 服务未监听正确的 IP 或端口；或系统级防火墙阻止连接；或跨域策略限制等。

二、基础排查流程

1. 确认 Agent 是否启动并正常运行。
2. 检查 Agent 配置文件中的监听地址和端口是否正确。
3. 查看本地防火墙设置，是否允许对应端口通信。
4. 测试局域网内其他设备能否访问该服务。
5. 确认浏览器控制台是否有 CORS 报错信息。

三、深入分析与解决方案

1. 检查 Apifox Agent 状态

确保本地运行的 Agent 服务处于激活状态。

apifox run --status

若未运行，请启动：

apifox start

2. 查看监听地址与端口配置

默认情况下，Agent 可能绑定在 localhost（即 127.0.0.1），这将导致外部无法访问。

修改配置文件 apifox.config.js 或环境变量：

module.exports = {
    server: {
        host: '0.0.0.0', // 允许所有IP访问
        port: 8080,
    }
}

3. 检查操作系统防火墙设置

不同操作系统下的命令如下：

操作系统	操作命令
Windows	打开“控制面板 > Windows Defender 防火墙 > 允许应用通过防火墙”，添加对应端口
macOS	sudo apf -a in tcp/8080
Linux (Ubuntu)	sudo ufw allow 8080/tcp

4. 跨域限制（CORS）问题排查

如果从浏览器发起请求，可能受到同源策略限制。

可在 Agent 后端添加以下响应头：

Access-Control-Allow-Origin: *

或使用中间件配置：

app.use((req, res, next) => {
    res.header('Access-Control-Allow-Origin', '*');
    res.header('Access-Control-Allow-Headers', 'Origin, X-Requested-With, Content-Type, Accept');
    next();
});

5. 使用 Mermaid 流程图辅助诊断

graph TD
A[Apifox请求] --> B{Agent服务是否运行?}
B -->|否| C[启动Agent]
B -->|是| D{监听IP是否为0.0.0.0?}
D -->|否| E[修改host配置]
D -->|是| F{防火墙是否放行端口?}
F -->|否| G[配置防火墙规则]
F -->|是| H{是否存在CORS限制?}
H -->|是| I[添加CORS头部]
H -->|否| J[网络正常，请求成功]

四、高级技巧与建议

• 使用 netstat 或 lsof 检查端口占用情况。
• 利用 curl 命令模拟请求，快速验证本地服务是否可访问。
• 使用 ngrok 等工具进行公网穿透测试，排除本地网络环境干扰。
• 日志追踪：查看 Agent 日志输出，定位具体拒绝原因。