历史版本2 :自定义nginx.conf部分配置 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

概述编辑

问题描述

当工程需要配置单点登录或跨域集成时，需要在nginx.conf文件中，添加一些自定义配置。

解决方案

V2.13.0及以上版本运维平台部署的帆软项目，支持自定义nginx.conf相关配置。

方案详解编辑

使用前提

1）请对nginx的/外挂目录/conf目录下的原始nginx.conf配置文件进行备份，以便在出现问题时快速修复

2）请在测试环境中进行充分测试后，再在正式环境中修改

准备conf文件



文件名称

  • 文件名支持英文、支持_和-，不支持其他特殊字符

  • 文件名后缀应为.conf

  • 文件名建议使用有意义的命名，便于识别文件的功能

示例：CORS.conf

文件内容支持配置：

  • 实现跨域访问功能(CORS)

  • 内置location块

  • 自定义的错误处理error_page

  • 添加自定义的的请求头 proxy_set_header

禁止配置：

  • proxy_pass

  • proxy_set_header Host

  • proxy_set_header X-Real-IP

  • proxy_set_header X-Forwarded-For

示例：

add_header 'Access-Control-Allow-Origin' '*';        //完全开放

add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';

add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';

add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';

上传conf文件

请将准备好的.conf文件，上传到/nginx的外挂目录/conf/custom目录中（没有请新建）

在解析配置时，会自动加载 custom 目录下所有以 .conf 结尾的文件，将内容合并到nginx.conf文件的location /  ${APP_PATH}块内

检查配置有效性

命令：nginx -t 

目的：

检查 Nginx 配置文件的语法是否正确，检查其他错误，确保在启动或重新加载 Nginx 服务时不会出错

这个命令只是进行测试，不会直接启动或重新加载 Nginx 服务。