讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Windows下Nginx跨域资源共享CORS配置实战教程

浅雪姑娘_8277

浅雪姑娘_8277

发布时间:2026-03-22 09:19:01

|

328人浏览过

|

来源于php中文网

原创

在 Windows 下用 Nginx 解决前端跨域问题,核心是通过反向代理在 location 块中配置 add_header 添加 Access-Control-Allow-Origin 等 CORS 头,并用 if ($request_method = 'OPTIONS') 处理预检请求返回 204;需确保 proxy_pass 正确、map 白名单动态设源、重载配置后验证响应头。

windows下nginx跨域资源共享cors配置实战教程

在 Windows 下用 Nginx 解决前端跨域问题,核心是正确配置 Access-Control-Allow-Origin 等响应头。不需要改前端代码、不依赖后端接口配合,Nginx 在反向代理层统一拦截并添加 CORS 头即可生效。

确认 Nginx 正在反向代理你的服务

跨域配置只在 Nginx 作为代理(而非静态文件服务器)时才有意义。例如你前端访问 http://localhost:8080,实际请求被 Nginx 转发到 https://www.php.cn/link/307527f309aa633edcc5f228a5533f25api,这时所有响应都可由 Nginx 注入 CORS 头。

  • 检查 nginx.conf 或 sites-enabled/xxx.conf 中是否有 proxy_pass 指令
  • 确保请求路径匹配了带 location 的代理块(如 location /api/ { proxy_pass https://www.php.cn/link/307527f309aa633edcc5f228a5533f25; })
  • 避免把 CORS 配置写在 location / {} 这类根路径下——它可能干扰静态资源或健康检查接口

添加标准 CORS 响应头(支持单源 & 凭据)

在对应 location 块内加入以下配置,适用于开发环境或明确知道前端域名的场景:

location /api/ {
    proxy_pass https://www.php.cn/link/307527f309aa633edcc5f228a5533f25;
<pre class="brush:php;toolbar:false;"># 允许指定源(替换为你的真实前端地址)
add_header 'Access-Control-Allow-Origin' 'http://localhost:8080';
add_header 'Access-Control-Allow-Credentials' 'true';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE';
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';

# 处理预检请求(OPTIONS)
if ($request_method = 'OPTIONS') {
    add_header 'Access-Control-Allow-Origin' 'http://localhost:8080';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE';
    add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';
    add_header 'Access-Control-Max-Age' 1728000;
    add_header 'Content-Type' 'text/plain; charset=utf-8';
    add_header 'Content-Length' 0;
    return 204;
}

}

  • Access-Control-Allow-Origin 不能设为 * 同时启用 credentials,否则浏览器会拒绝
  • if ($request_method = 'OPTIONS') 是必须的——浏览器对带凭据或自定义头的请求会先发预检,Nginx 需直接返回 204,不转发给后端
  • 所有 add_header 指令在 if 块内外都要重复写,因为 if 是独立作用域

支持多源或动态源(谨慎使用)

若前端部署多个域名(如 dev.example.com、staging.example.com),或需适配本地不同端口调试,可用变量+白名单方式动态设置 Origin:

map $http_origin $cors_origin {
    default "";
    "~^http://localhost:8080$" "$http_origin";
    "~^https://dev\.example\.com$" "$http_origin";
    "~^https://staging\.example\.com$" "$http_origin";
}
<p>server {
listen 80;
location /api/ {
proxy_pass <a href="https://www.php.cn/link/307527f309aa633edcc5f228a5533f25">https://www.php.cn/link/307527f309aa633edcc5f228a5533f25</a>;</p><pre class="brush:php;toolbar:false;">    add_header 'Access-Control-Allow-Origin' $cors_origin;
    add_header 'Access-Control-Allow-Credentials' 'true';
    # 其他头保持不变...

    if ($request_method = 'OPTIONS') {
        add_header 'Access-Control-Allow-Origin' $cors_origin;
        add_header 'Access-Control-Allow-Credentials' 'true';
        # ...其余同上
        return 204;
    }
}

}

  • map 必须写在 http 块顶层,不能放在 server 或 location 内
  • 正则匹配注意转义点号 \. 和锚定 ^、$,防止恶意源伪造
  • 若 $cors_origin 为空(即未命中白名单),Nginx 不会添加 Access-Control-Allow-Origin,浏览器自然拒绝跨域,安全可控

验证与排错要点

配置完别忘了重载 Nginx(nginx -s reload),然后用浏览器开发者工具检查响应头:

  • 查看 Network → 请求 → Response Headers,确认存在 Access-Control-Allow-Origin 等字段
  • 如果是预检失败,看是否触发了 OPTIONS 请求,且返回状态码是 204(不是 502/404)
  • 常见错误:忘记重启 Nginx、add_header 写在 if 外却没在 if 内重复、proxy_pass 尾部斜杠缺失导致路径拼接错误
  • Windows 下路径分隔符不用特别处理,但注意 nginx.conf 保存为 UTF-8 无 BOM 格式,避免解析异常

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

3749

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2488

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

1420

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1358

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

1436

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2418

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

4020

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

19155

2023.09.22

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn