Apache Airflow 3.x web_server_path参数配置及子路径问题咨询

1. Airflow 3.x是否支持web_server_path参数？ #

Airflow 3.0.0已经完全移除了web_server_path这个配置项，该参数仅在2.x早期版本中存在，3.x版本里配置这个参数不会产生任何效果，这就是你配置后没生效的核心原因。

2. 是否需要配置NGINX等反向代理实现子路径？ #

是的，Airflow 3.x官方推荐通过反向代理（如NGINX、Traefik）来实现子路径部署，这是当前版本下实现自定义子路径的标准方式。

3. 是否有替代web_server_path的设置？ #

有以下几个关键配置步骤：

• 设置Airflow基础URL环境变量：在部署Pod时注入环境变量AIRFLOW__WEBSERVER__BASE_URL，值设为http://<server-ip>:8080/myairflow，这会让Airflow生成的所有内部链接（比如UI里的跳转、API路径）都自动带上/myairflow前缀。
• 配置反向代理路径转发：以NGINX为例，需要添加类似如下的配置段，将/myairflow路径的请求转发到Airflow webserver的根路径，同时传递X-Forwarded-Prefix头让Airflow识别子路径：

location /myairflow {
    proxy_pass http://<airflow-webserver-service>:8080;
    proxy_set_header X-Forwarded-Prefix /myairflow;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

• 重启相关服务：更新配置后，重启Airflow webserver、scheduler等组件，确保环境变量和代理配置生效。

内容的提问来源于stack exchange，提问作者Mohd Sajeer