常见问题: 客户端报错

frpc 常见日志对照

英文中文备注
connect to local service [XXX] error: YYY连接映射目标 [XXX] 失败, 请检查本地服务是否可访问: YYY点此查看详细说明
Your XXX proxy is available now. Use >>YYY<< to connect.XXX 隧道启动成功 使用 >>YYY<< 连接你的隧道隧道启动成功，一切正常
read from control connection EOF控制连接读取失败 (EOF), 可能是网络不稳定网络波动，一般可以忽略或者更换节点
write message to control connection error: XXX控制连接写入失败, 可能是网络不稳定: XXX网络波动，一般可以忽略或者更换节点
login to server failed: XXX登录节点失败, 请检查网络连接: XXX点此查看详细说明
router config conflict当前 HTTP 隧道已在线, 请勿重复开启点此查看详细说明
Request failed: XXX YYYAPI 请求失败点此查看详细说明
SakuraFrp API failure, please contact administratorSakuraFrp API 异常, 请稍后重试或联系我们稍等一段时间并重试，若错误持续出现请 联系我们

隧道重复开启可能出现的错误日志

开启了多个 frpc 连接同一条隧道时，就会出现下面的错误日志：

英文中文
proxy conflict当前隧道已在线, 请勿重复开启
multi-instance racing, this one failed隧道启动冲突, 请关闭重复开启的 frpc 客户端
port already used相关隧道在线, 请勿重复开启

请在 所有设备 上查找所有存在冲突的 frpc 进程并关闭，确保一条隧道只有 一个 frpc 在连接。有时 Supervisor (systemd、pm2) 等配置错误也会造成冲突，推荐您使用启动器管理隧道。

如果实在找不到冲突的 frpc 进程，可以重置访问密钥。不推荐随意重置访问密钥，请将此操作作为最后的手段。

无法连接到本地服务

此日志说明 frpc 工作正常，但是 frpc 无法连接到您的本地服务。

原因解决方案
本地服务 (例如 Minecraft 服务器，HTTP 服务器) 没有启动或启动失败检查并启动本地服务
本地 IP 发生了变化编辑隧道 填写正确的本地 IP 并 重启 frpc
没有特殊需求请使用 127.0.0.1 而不是其他地址
本地服务配置有误，没有监听 frpc 连接的本地 IP正确配置本地服务或修改隧道设置
本地端口 或 本地 IP 填写错误编辑隧道，参考文档 填写正确的信息 然后 重启 frpc
电脑上的防火墙、杀毒软件拦截 frpc 请求本地服务添加合理的白名单规则

登录节点失败, 请检查网络连接

  1. 请运行 PING 命令测试节点连通性

    ping <节点域名>

# 例如
ping idea-leaper-1.natfrp.cloud

  2. 请查看 节点状态在新窗口打开 页面对应节点是否在线

在线PING网络可能原因解决方案
✘节点被攻击、维护中或出现故障换节点 / 等一天再试
✔✘网络故障，防火墙拦截或被墙
* 部分节点可能禁 PING		换节点 / 换网络
✔✔家里网络 / 热点上游防火墙拦截 frp 协议或端口换网络 / 咨询运营商
✔✔公司 / 校园网网管不允许使用 frp那就别用 / 联系网管开通权限
参考 校园/公司网无法连接服务器

URL 路由冲突

原因解决方案
创建隧道时填写的域名有误填写正确的域名
服务端路由未释放和 端口被占用 类似，解决方案也相同

API 请求失败

请优先检查 API 连接性问题:

  • 检查 SSL 问题
    • Windows 系统请使用 Internet Explorer 访问 https://api.natfrp.com/ 查看是否出现安全警告，如果出现请安装系统更新或者手动安装根证书
    • Linux 系统可以使用 curl -i https://api.natfrp.com/ 检查是否存在证书错误，如果出现证书错误可以尝试安装 (或更新) ca-certificates 包
  • 检查防火墙、杀毒软件是否拦截了 frpc 的请求
  • 检查宽带是否存在到期未续费等情况，电脑能否正常 打开网站（例如 SakuraFrp 首页）

如果还是没有什么头绪，可以查看 外部状态监控在新窗口打开 中 API 是否正常在线 (operational)，如果不在线请联系管理员。