A flexible server middleware for any web application. It allows you to serve static files, proxy requests to local websites or Docker containers, and enforce basic authentication with ease. Additionally, it provides structured logs for better observability and troubleshooting.
  • Go 84.1%
  • JavaScript 13.1%
  • Dockerfile 2.8%
Find a file
maxpeterkaya c96b2a33de
All checks were successful
CI / build (push) Successful in 5m1s
rm: codeql workflow
2026-05-29 11:21:39 -04:00
.forgejo/workflows rm: codeql workflow 2026-05-29 11:21:39 -04:00
bin
examples docs: create docker compose (#34) 2026-02-11 22:59:00 -05:00
.gitignore
.goreleaser.yml fix: remove sboms 2026-01-21 14:40:00 -05:00
.npmignore
artifacthub-repo.yml
config.go feat: add config (#49) 2026-05-19 10:45:31 -04:00
Dockerfile chore(deps): update debian docker tag to v13 2026-01-26 01:00:11 +00:00
Dockerfile-snapshot chore(deps): update golang docker tag to v1.26 2026-02-10 21:48:30 +00:00
functions.go feat: separate env declaration from start command 2026-05-29 11:20:51 -04:00
go.mod chore(deps): update module github.com/rs/zerolog to v1.35.0 2026-03-27 21:49:44 +00:00
go.sum chore(deps): update module github.com/rs/zerolog to v1.35.0 2026-03-27 21:49:44 +00:00
hash.go feat: create hash function 2026-02-11 20:57:07 -05:00
INSTALL-GUIDE.md
key.go feat: create crypto key function 2026-02-11 20:57:00 -05:00
LICENSE
main.go feat: pass env declaration in start command 2026-05-29 11:21:23 -04:00
package-lock.json
package.json
README.md docs: add example to root readme (#34) 2026-02-11 22:59:43 -05:00
renovate.json Add renovate.json 2026-01-26 00:08:16 +00:00

Web-proxy

Artifact Hub image image image image

Introduction

This project aims to provide a better logging solution to web applications that lack structured logs. These applications all mostly lack a uniform logger that is customizable as well as even non-existent in production builds. Some of these frameworks may include:

  • NextJS
  • PrismaORM

Getting Started

NodeJS

Install: npm i @maxpeterkaya/web-proxy

Add the following scripts to your package.json:

{
  "scripts": {
    "start": "npx web-proxy -app",
    // Passing the -app is very important to tell web-proxy to run the web app for you.
    "start:web": "YOUR COMMAND TO START THE WEB APP"
    // This could be next start, remix-serve build, ng serve, node dist/main, etc.
  }
}

After doing so, make sure web-proxy is properly configured

Installation Guide

Examples

Roadmap

These bullet points are in no particular order of importance or difficulty.

  • Install methods
  • Install guide
  • Usage guide
  • Templates
  • Screenshots
  • Benchmarks
  • Configurable logs