Docker image of Nginx Proxy with Basic Auth

Simple HTTP Proxy with Basic Authentication

 w/ user:pass +------------------------+ +-------------+
User ---------------> | nginx-basic-auth-proxy | ---> | HTTP Server |
+------------------------+ +-------------+

This project is a fork of dtan4's nginx basic auth proxy. I only added a couple of common monitoring endpoints (/healthz, /ping, /status, /metrics and /version) to be accessible without basic auth.

Run

$ docker run \
--rm \
--name nginx-basic-auth-proxy \
-p 8080:80 \
-p 8090:8090 \
-e BASIC_AUTH_USERNAME=username \
-e BASIC_AUTH_PASSWORD=password \
-e PROXY_PASS=https://www.google.com \
-e SERVER_NAME=proxy.dtan4.net \
-e PORT=80 \
quay.io/thomasjungblut/nginx-basic-auth-proxy

Access to http://localhost:8080 , then browser asks you username and password.

You can also try complete HTTP-proxy example using Docker Compose. hello-world web application cannot be accessed without authentication.

$ docker-compose up
# http://localhost:8080/# - Username: username# - Password: password

Endpoint for monitoring

:8090/nginx_status returns the metrics of Nginx.

$ curl localhost:8090/nginx_statusActive connections: 1server accepts handled requests 8 8 8Reading: 0 Writing: 1 Waiting: 0

Environment variables

Required

Key	Description
BASIC_AUTH_USERNAME	Basic auth username
BASIC_AUTH_PASSWORD	Basic auth password
PROXY_PASS	Proxy destination URL

Optional

Key	Description	Default
SERVER_NAME	Value for server_name directive	example.com
PORT	Value for listen directive	80
CLIENT_MAX_BODY_SIZE	Value for client_max_body_size directive	1m
PROXY_READ_TIMEOUT	Value for proxy_read_timeout directive	60s
WORKER_PROCESSES	Value for worker_processes directive	auto

Original Author

Daisuke Fujita (@dtan4)

License