如何为Nginx Ingress Controller无绑定Ingress的场景自定义404页面？

可行，核心思路是修改Nginx Ingress Controller的默认server配置（该server负责处理所有未匹配到任何Ingress规则的请求），为其单独指定自定义404页面，不会影响后端服务返回的404响应。具体实现步骤如下：

1. 创建自定义404页面的ConfigMap #

先编写你的自定义404 HTML页面（例如custom-404.html），内容示例：

<!DOCTYPE html>
<html>
<head>
    <title>404 - 域名未绑定服务</title>
    <style>
        body { text-align: center; padding: 50px; font-family: Arial, sans-serif; }
        h1 { font-size: 48px; color: #333; }
        p { font-size: 18px; color: #666; }
    </style>
</head>
<body>
    <h1>404</h1>
    <p>该域名未绑定任何服务，请检查访问地址是否正确。</p>
</body>
</html>

通过kubectl创建ConfigMap存储这个页面：

kubectl create configmap nginx-custom-404 --from-file=custom-404.html -n <ingress-controller-namespace>

替换<ingress-controller-namespace>为你的Ingress Controller所在命名空间（通常是ingress-nginx）。

2. 挂载ConfigMap到Ingress Controller容器 #

修改Ingress Controller的Deployment或DaemonSet，将上述ConfigMap挂载到容器内的Nginx静态文件目录（例如/usr/share/nginx/html/）：

编辑资源配置：

kubectl edit deployment nginx-ingress-controller -n <ingress-controller-namespace>

在spec.template.spec.containers[0].volumeMounts下添加：

- name: custom-404-volume
  mountPath: /usr/share/nginx/html/custom-404.html
  subPath: custom-404.html

在spec.template.spec.volumes下添加：

- name: custom-404-volume
  configMap:
    name: nginx-custom-404

保存配置后，Ingress Controller会自动重启并加载新的挂载。

3. 配置默认Server的自定义404规则 #

通过Ingress Controller的全局ConfigMap（通常名为nginx-configuration），为默认Server添加错误页面配置：

编辑该ConfigMap：

kubectl edit configmap nginx-configuration -n <ingress-controller-namespace>

在data字段下添加server-snippet配置：

data:
  server-snippet: |
    error_page 404 /custom-404.html;
    location = /custom-404.html {
      root /usr/share/nginx/html;
      internal;
    }

这个配置仅作用于默认Server（未匹配Ingress规则的请求会进入此Server），不会影响其他Ingress规则对应的后端服务的404响应。

验证效果 #

• 访问一个未绑定任何Ingress规则的域名，应该返回你自定义的404页面。
• 访问某个已绑定Ingress的域名，且该后端服务返回404时，仍会显示后端自身的404响应，不会被覆盖。

内容的提问来源于stack exchange，提问作者Adam Sitemap