自定义nginx.conf部分配置

  • 文档创建者:Carly
  • 历史版本:6
  • 最近更新:Carly 于 2024-12-16
  • 概述

    问题描述

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

    然而为了确保配置正确性和合理性,运维平台部署的nginx,不支持用户直接修改nginx.conf文件。

    解决方案

    V2.13.0及以上版本运维平台部署的帆软项目, nginx 组件版本在 V20.2.14-1.21.4 及以上,支持自定义.conf文件并加载到nginx配置中

    方案详解

    使用前提

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

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

    3)请在测试环境中检查 Nginx 配置文件的语法是否正确,确保在启动或重新加载 Nginx 服务时不会出错

    命令:nginx -t 

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

    准备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}块内

    在对运维项目进行扩容、备份还原等操作时,该配置仍然有效。



    附件列表


    主题: 运维平台管理
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    9s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持

    反馈已提交

    网络繁忙