基于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命令重新加载配置使设置生效。

如何将彩色PDF一键转为黑白版？

PDFViewCtrl中如何隐藏文本选中菜单

【福昕管理控制台】自动停用功能常见问题解答

如何去除PDF中的水印？

版式识别功能Layout Recognition功能Demo简介

自v2025.2.1和v14.0.1版本开始以及之后的版本，如何获取到msi的包

云文档列表右键菜单与程序语言不一致

如何重复使用区域高亮的功能

如何在页面中总是显示文档页面大小

如何实现总是在新窗口中打开文件