基于Nginx的代理服务器配置方案：解决跨域资源共享（CORS）问题

福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(Web)

标签:
CORS,Nginx,代理服务器,响应头,跨域资源共享,跨域问题,配置

基于Nginx的代理服务器配置方案：解决跨域资源共享（CORS）问题

福昕知识库
2025-09-07

通过 Nginx 配置代理服务器解决跨域资源共享（CORS）问题的实施步骤如下：

配置代理转发规则：

在 Nginx 配置文件中添加代理转发规则，实现特定路径请求向目标服务器的转发。例如，将以 /prefix/ 为前缀的请求代理至http://third_party.file.server：

location ~* ^/prefix/(.*) {
proxy_pass http://third_party.file.server/$1$is_args$args;
proxy_redirect off;
}

该配置可将http://location:3000/prefix/path/to/some.pdf请求转换为http://third_party.file.server/path/to/some.pdf进行处理。

配置 CORS 响应头信息：在代理配置中设置必要的 CORS 响应头，需确保包含对Range请求头的支持及Content-Range响应头的暴露：

add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Headers' 'Range';
add_header 'Access-Control-Expose-Headers' 'Content-Range';

其中，Access-Control-Allow-Origin建议根据实际请求源（如$http_origin）进行动态设置，而非使用通配符*，以提升系统安全性。

处理 OPTIONS 预检请求：
针对 OPTIONS 方法的预检请求，需返回 204 状态码并预先设置 CORS 相关头信息：

if ($request_method = OPTIONS) {
add_header 'Access-Control-Allow-Headers' 'Range';
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Expose-Headers' 'Content-Range';
return 204;
}

此举可有效避免因预检请求失败导致的跨域访问阻断。

限制允许的请求源（可选但推荐）：通过map变量动态验证请求来源的合法性，例如仅允许foxit.com域名及其子域名：

map $http_origin $cors {
'~*^https?://.+.foxit.com$' 'true';
}

随后根据$cors变量设置对应的头字段值，示例如下：

该配置可进一步增强跨域访问的安全性。

add_header 'Access-Control-Allow-Origin' $allow_origin;

配置完成后，执行nginx -t命令验证配置文件的语法正确性，通过nginx -s reload命令重新加载配置使设置生效。

自定义StorageDriver及事件分发实现指南

如何在树形组件中定义和使用书签面板？

如何在自定义 Item 组件中添加清除编辑状态铅笔注释的功能按钮

WebViewer 工程中使用 Template 实现 UI 布局的完整指南

PDF文档合并功能实现指南

获取PDF文档各页面旋转角度的方法

【福昕管理控制台】受邀用户邀请重新发送操作指南

如何导入或导出PDF注释？

如何将PDF转换为图片并设置其分辨率？

PrintManager实现多文件打印

自定义StorageDriver及事件分发实现指南

如何在树形组件中定义和使用书签面板？

如何在自定义 Item 组件中添加清除编辑状态铅笔注释的功能按钮

WebViewer 工程中使用 Template 实现 UI 布局的完整指南

PDF文档合并功能实现指南

获取PDF文档各页面旋转角度的方法

【福昕管理控制台】受邀用户邀请重新发送操作指南

基于Nginx的代理服务器配置方案：解决跨域资源共享（CORS）问题

如何导入或导出PDF注释？

如何将PDF转换为图片并设置其分辨率？