hojerst/default-backend

default-backend Docker镜像

概述

default-backend是一个轻量级的Docker镜像，设计用于Kubernetes集群环境，作为Ingress控制器的默认后端服务。当Ingress控制器接收到没有匹配规则的请求时，将请求转发到此默认后端服务，该服务会返回适当的HTTP状态码和响应信息。

核心功能

• 处理没有匹配Ingress规则的请求
• 返回可配置的HTTP状态码
• 提供简单的健康检查接口
• 轻量级设计，资源占用低
• 支持基本的访问日志记录

使用场景

• 作为Kubernetes集群中Ingress-NGINX控制器的默认后端
• 为未匹配路由的请求提供统一的404或其他错误响应
• 监控和统计未匹配路由的访问尝试
• 在应用部署初期作为临时后端占位服务

部署方法

Docker Run

bash
docker run -d -p 8080:8080 --name default-backend gitlab.com/hojerst/default-backend:latest

Kubernetes部署

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: default-backend
  namespace: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: default-backend
  template:
    metadata:
      labels:
        app: default-backend
    spec:
      containers:
      - name: default-backend
        image: gitlab.com/hojerst/default-backend:latest
        ports:
        - containerPort: 8080
        resources:
          limits:
            cpu: 10m
            memory: 20Mi
          requests:
            cpu: 10m
            memory: 20Mi
---
apiVersion: v1
kind: Service
metadata:
  name: default-backend
  namespace: ingress-nginx
spec:
  selector:
    app: default-backend
  ports:
  - port: 80
    targetPort: 8080

配置说明

环境变量

配置示例

bash
docker run -d -p 8080:8080 \
  -e PORT=8080 \
  -e DEFAULT_HTTP_STATUS=404 \
  -e LOGGING_ENABLED=true \
  --name default-backend gitlab.com/hojerst/default-backend:latest

健康检查

服务提供内置的健康检查接口，默认路径为/healthz，访问时将返回200 OK状态码，表示服务正常运行。

GET /healthz HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: text/plain
Content-Length: 2

OK

自定义响应

可以通过环境变量和配置文件自定义默认响应内容，具体配置方法请参考项目源代码仓库的文档。

镜像拉取

bash
docker pull gitlab.com/hojerst/default-backend:latest

项目地址

更多详细信息和源代码，请访问项目GitLab仓库: [***]