Red Hat Training

A Red Hat training course is available for Red Hat Fuse

54.3. 通过反向代理访问 Swagger

如果要通过反向代理访问 Swagger JSON 文档或 Swagger UI,请设置以下选项:

  • CXFServlet use-x-forwarded-headers init 参数设置为 true

    • 在 Spring Boot 中,为参数名称添加前缀为 cxf.servlet.init

      cxf.servlet.init.use-x-forwarded-headers=true
    • 在 Karaf 中,将以下行添加到 installDir/etc/org.apache.cxf.osgi.cfg 配置文件:

      cxf.servlet.init.use-x-forwarded-headers=true

      注:如果您还没有在 etc 目录中有一个 org.apache.cxf.osgi.cfg 文件,您可以创建一个。

  • 如果您为 Swagger2Feature basePath 选项指定一个值,并且希望防止 Swagger 缓存 basePath 值,请将 Swagger2Feature usePathBasedConfig 选项设置为 TRUE

    <bean class="org.apache.cxf.jaxrs.swagger.Swagger2Feature">
        <property name="usePathBasedConfig" value="TRUE" />
    </bean>