xscys/nginx-sidecar-basic-auth

nginx-sidecar-basic-auth

https://images.microbadger.com/badges/version/xscys/nginx-sidecar-basic-auth.svg](https://hub.docker.com/r/xscys/nginx-sidecar-basic-auth) https://images.microbadger.com/badges/image/xscys/nginx-sidecar-basic-auth.svg](https://hub.docker.com/r/xscys/nginx-sidecar-basic-auth)

镜像概述

这是一个提供nginx代理服务器的Docker镜像，对所有请求（OPTIONS请求除外）强制HTTP基本认证。它适用于OpenShift等环境，可作为sidecar容器部署，用于增强后端服务的访问安全性。

核心功能

1. 对非OPTIONS请求强制HTTP基本认证
2. 代理请求到指定的后端服务
3. 支持WebSocket路径配置
4. 通过环境变量灵活配置代理参数（如端口、超时时间、请求大小限制等）

使用场景

• 保护无内置认证机制的后端服务
• 在OpenShift集群中作为sidecar容器，为应用添加基础访问控制
• 快速为测试环境或内部服务添加简单的身份验证层

配置说明

通过环境变量进行配置，以下是关键参数：

使用示例

Docker部署

启动容器并链接到后端服务（或使用Docker网络）：

sh
docker run -d --name nginx-basic-auth -p 8087:8087 \
  --link backend:backend \
  -e FORWARD_HOST=backend \
  -e FORWARD_PORT=3000 \
  docker.xuanyuan.run/xscys/nginx-sidecar-basic-auth

OpenShift Sidecar部署

在部署配置中添加sidecar容器：

yaml
- image: xscys/nginx-sidecar-basic-auth
  imagePullPolicy: Always
  name: auth-proxy
  ports:
    - containerPort: 8087
      protocol: TCP
  env:
    - name: FORWARD_PORT
      value: ${BACKEND_CONTAINER_PORT}

许可证

MIT License

Copyright (c) 2019 Yannick Scherer

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.