romancin/traefik-custom-error-pages

![Donate]([] ![Netlify Status]([]

Traefik自定义错误页面

基于Jekyll构建的Traefik自定义错误页面集合，用于替换默认错误页面，为用户提供更友好的服务反馈。

镜像概述

该镜像通过Jekyll生成静态错误页面，并使用Nginx作为Web服务器提供访问支持。预配置Traefik标签，可快速集成到Traefik反向代理服务中，处理400-599范围内的HTTP状态码错误。

核心功能

• 支持400-599全范围HTTP状态码的自定义错误页面
• 基于Jekyll静态生成，页面加载速度快
• 内置Nginx服务，稳定可靠
• 预配置Traefik标签，无需额外配置即可与Traefik联动
• 支持本地预览和自定义构建

使用场景

• Traefik反向代理服务中需要替换默认错误页面的场景
• 网站维护、资源不存在、服务器错误等场景下展示友好的自定义提示页面
• 提升服务的专业度和用户体验

配置说明

快速部署

直接运行容器即可集成到Traefik服务：

bash
docker run -d --restart always romancin/traefik-custom-error-pages

集成到其他服务

在需要使用自定义错误页面的容器标签中添加中间件引用：

bash
labels:
  - "traefik.http.routers.myrouter.middlewares=errorpage"

本地构建与预览

1. 安装依赖：

bash
bundle install

2. 本地构建静态页面：

bash
jekyll build

3. 预览页面：

bash
jekyll serve
open http://127.0.0.1:4000/

构建镜像

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

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

工作原理

镜像通过多阶段构建：第一阶段使用Jekyll生成静态错误页面，第二阶段使用Nginx服务托管这些页面。预配置的Traefik标签使容器作为catchall服务，仅在没有匹配的路由规则时响应请求，返回对应的错误页面。

credits

感谢guillaumebriday创建本项目，以及Jakob-em通过fork优化CSS和SVG内联文件。

贡献

欢迎通过Bug报告或Pull Request参与项目改进，可适配或添加新功能。

许可证

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