meroxa/custom-error-pages Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
meroxa/custom-error-pagesmeroxa
用于作为ingress-nginx默认后端的自定义错误页面镜像，可提供自定义错误响应页面，增强用户错误体验。
下载次数: 0状态：社区镜像维护者：meroxa仓库类型：镜像最近更新：2 个月前
镜像概述
该镜像为ingress-nginx入口控制器设计，作为默认后端服务，用于在无法找到对应后端服务或发生请求错误时，返回自定义错误页面。替代ingress-nginx默认的简单文本响应，提供品牌化、用户友好的错误页面展示。
核心功能与特性
- 自定义错误页面支持：支持自定义404、503、403等常见HTTP错误码的HTML响应页面
- 轻量级设计：基于小型基础镜像构建，资源占用低，启动速度快
- 灵活配置：通过环境变量和卷挂载实现页面内容、监听端口等参数自定义
- 标准兼容：符合ingress-nginx默认后端接口规范，可直接集成
- 多错误码覆盖：默认提供常用错误码页面模板，支持扩展自定义错误码
使用场景
- Kubernetes集群中部署ingress-nginx时，作为默认后端服务处理未匹配路由请求
- 需要为用户提供品牌化错误页面（如404页面含公司logo、帮助链接）的场景
- 替代默认纯文本错误响应，提升用户体验
- 需统一管理不同服务错误页面样式的微服务架构环境
使用方法与配置说明
基本使用（Docker Run）
bashdocker run -d \ -p 8080:8080 \ --name ingress-error-pages \ <镜像名称>
默认情况下，服务监听8080端口，提供内置默认错误页面。
自定义错误页面
通过卷挂载自定义错误页面目录，覆盖默认页面：
bashdocker run -d \ -p 8080:8080 \ -v /path/to/custom-errors:/usr/share/error-pages \ --name ingress-error-pages \ <镜像名称>
目录结构要求：自定义目录需包含以错误码命名的HTML文件（如404.html、503.html），支持的错误码包括400-599范围。
环境变量配置
支持以下环境变量调整服务行为：
| 环境变量 | 说明 | 默认值 |
|---|---|---|
LISTEN_PORT | 服务监听端口 | 8080 |
ERROR_PAGE_ROOT | 错误页面存放根目录 | /usr/share/error-pages |
DEFAULT_STATUS | 未匹配错误码时返回的状态码 | 404 |
示例（自定义端口和默认状态码）：
bashdocker run -d \ -p 80:80 \ -e LISTEN_PORT=80 \ -e DEFAULT_STATUS=503 \ --name ingress-error-pages \ <镜像名称>
Kubernetes集成配置
1. 部署自定义错误页面服务
yamlapiVersion: apps/v1 kind: Deployment metadata: name: custom-error-pages spec: replicas: 1 selector: matchLabels: app: error-pages template: metadata: labels: app: error-pages spec: containers: - name: error-pages image: <镜像名称> ports: - containerPort: 8080 volumeMounts: - name: error-pages-volume mountPath: /usr/share/error-pages volumes: - name: error-pages-volume configMap: name: custom-error-pages-configmap # 包含自定义HTML页面的ConfigMap
2. 配置ingress-nginx默认后端
yamlapiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: main-ingress annotations: kubernetes.io/ingress.class: "nginx" spec: defaultBackend: service: name: custom-error-pages-service # 对应上述Deployment的Service名称 port: number: 80 rules: # 其他路由规则...
自定义页面示例（404.html）
html<!DOCTYPE html> <html> <head> <title>页面未找到</title> <style>/* 自定义样式 */</style> </head> <body> <h1>404 - 页面不存在</h1> <p>您请求的页面无法找到，请检查URL或联系管理员。</p> </body> </html>
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"