guillaumebriday/traefik-custom-error-pages

Traefik自定义错误页面

这是一个为Traefik反向代理设计的自定义错误页面镜像，使用Jekyll构建静态页面，并通过Nginx提供服务。

镜像概述

该镜像提供一套自定义HTTP错误页面，可集成到Traefik中作为全局错误页面，处理所有未匹配到具体服务的请求。镜像采用多阶段构建：先通过Jekyll生成静态页面，再用Nginx高效服务这些页面。

核心功能

• 提供美观的自定义错误页面（基于Laravel默认错误页面设计）
• 支持Traefik集成，作为全局错误响应服务
• 使用Nginx静态文件服务，性能高效
• 支持本地开发预览和自定义镜像构建

使用场景

• 为Traefik反向代理配置全局错误页面，统一处理404、500等HTTP错误
• 替换Traefik默认错误页面，提升用户访问体验

配置说明

Docker Compose部署示例

yml
# docker-compose.yml
errorpage:
  image: guillaumebriday/traefik-custom-error-pages
  restart: unless-stopped
  networks:
    - web
  labels:
    - traefik.enable: "true"
    - traefik.docker.network: "web"
    - traefik.http.routers.errorpage.entrypoints: "websecure"
    - traefik.http.routers.errorpage.rule: "HostRegexp(`{host:.+}`)"
    - traefik.http.services.globalerrorpage.loadbalancer.server.port: "80"

本地开发

1. 安装依赖：

bash
bundle install

2. 构建静态页面：

bash
jekyll build

3. 预览页面：

bash
jekyll serve

访问 http://127.0.0.1:4000/ 查看错误页面预览。

自定义构建镜像

使用多阶段构建生成镜像：

bash
docker build -f .cloud/docker/Dockerfile -t traefik-custom-error-pages .

工作原理

镜像通过Jekyll生成静态错误页面，Nginx作为Web服务器提供服务。在Traefik中配置HostRegexp({host:.+})规则，使其成为全局错误页面——当没有其他服务匹配请求时，该镜像会响应自定义错误页面。

Credits

错误页面设计基于Laravel默认HTTP错误页面。

贡献

欢迎提交Bug报告或Pull Request参与项目改进。

许可证

本项目基于MIT许可证发布。