火狐浏览器访问内网地址被拦截是因私有网络访问限制,默认启用 block-insecure-private-network-requests=true,需改为 false 并重启;还需后端或 Nginx 处理 OPTIONS 预检,且真实响应中必须包含 Access-Control-Allow-Origin、Access-Control-Allow-Credentials 和火狐特需头 Access-Control-Allow-Private-Network: true。

火狐浏览器访问内网管理后台(如 http://192.168.1.100:8080)时,控制台报错“No 'Access-Control-Allow-Origin' header”,且请求甚至未发出或被静默拦截——这往往不是单纯缺 CORS 头,而是浏览器主动阻断了“公网页面访问私有网络资源”的行为。
确认是否触发私有网络访问限制
打开火狐地址栏,输入 about:config → 点击“我了解此风险” → 搜索 network.http.referer.hideOnHttpRedirect(不相关,忽略)→ 改搜 block-insecure-private-network-requests。
找到该项后双击将其值由 true 改为 false。这是火狐自 2022 年起强制启用的安全策略,默认禁止从非安全上下文(如 http:// 或 file:// 页面)向 192.168.x.x、10.x.x.x、localhost 等私有地址发起 fetch/XHR 请求。
【必须重启浏览器才能生效】 修改后不重启,设置完全无效。
处理预检请求(OPTIONS)被拒绝
方法一:后端直接返回 204 状态码并携带必要头
当你的请求含自定义 Header(如 Authorization: Bearer xxx)或 Content-Type 为 application/json 时,火狐会先发一个 OPTIONS 请求。若后端未响应 200/204,或响应中缺失 Access-Control-Allow-Methods,整个请求链就卡死在预检阶段。
Spring Boot 示例:在全局过滤器中添加
if ("OPTIONS".equals(request.getMethod())) { response.setStatus(204); return; }
方法二:Nginx 代理层拦截并响应 OPTIONS
在 location 块中加入:
if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin "*"; add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"; add_header Access-Control-Allow-Headers "Content-Type, Authorization, X-Requested-With"; add_header Access-Control-Max-Age "3600"; add_header Access-Control-Allow-Credentials "true"; add_header Access-Control-Allow-Private-Network "true"; return 204; }
补全关键 CORS 响应头
第一步:确保真实响应(非 OPTIONS)中包含
Access-Control-Allow-Origin: http://your-public-domain.com(生产环境禁用 *)
Access-Control-Allow-Credentials: true(若需带 Cookie 或 Authorization)
第二步:必须添加火狐私有网络特需头
【Access-Control-Allow-Private-Network: true 是火狐 105+ 版本识别内网跨域的硬性要求】 缺失此项,即使 Origin 头正确,请求仍会被拦截并报 “The request client is not a secure context…” 错误。
第三步:验证响应头是否真实下发
用 curl -I http://192.168.1.100:8080/api/login 查看响应头输出,确认三者均存在且拼写无误。注意大小写敏感,Allow-Private-Network 中的连字符不能写成下划线或空格。


















