astronomerinc/ap-default-backend

镜像概述

该Docker镜像是Astronomer平台的核心组件之一，作为NGINX反向代理的默认后端服务，专门用于处理当NGINX接收到未匹配任何已配置路由规则的请求时，提供标准的404错误页面响应。

核心功能与特性

• 默认404响应处理：针对所有未匹配路由的请求，自动返回标准404 HTTP状态码及配套页面
• 轻量级设计：镜像体积精简，资源占用低，确保在平台部署中高效运行
• 无缝集成能力：与Astronomer平台的NGINX服务原生适配，无需额外复杂配置即可实现请求转发

使用场景与适用范围

适用于Astronomer平台部署环境，作为NGINX反向代理的后端兜底服务，处理各类未被其他业务服务匹配的请求，保障用户获得一致的404错误反馈体验。

使用方法与配置说明

基本部署命令

通过以下命令可快速启动该后端服务容器：

bash
docker run --name astronomer-nginx-default-backend -d -p 8080:80 astronomerinc/ap-default-backend:latest

与NGINX集成配置

在NGINX配置文件中，需将未匹配路由的请求代理至该服务，示例配置片段如下：

nginx
# NGINX配置文件片段
server {
    listen 80;
    server_name example.com;

    # 业务服务路由匹配
    location /api/ {
        proxy_pass http://business-service:8080;
    }

    # 未匹配路由请求转发至默认后端
    location / {
        proxy_pass http://astronomer-nginx-default-backend:80;
    }
}

关键配置说明

• 端口映射：默认监听容器内80端口，可通过-p参数映射至主机端口（如示例中的8080）
• 环境变量：无需额外环境变量配置，默认行为即可满足Astronomer平台的标准需求
• 容器互联：在Docker Compose或Kubernetes环境中，需确保NGINX服务与该后端服务在同一网络内，通过服务名（如astronomer-nginx-default-backend）实现通信