This is a basic, lightweight web server using Bun as JavaScript/TypeScript runtime.
This app is really useful in some situations, like:
- When you need to retrieve some token, text or a HTML page fast, without the need to configure a
Nginx/Apache
web server, or even creating anExpress
application from zero - When you are trying to generate a Let's Encrypt certificate for a domain/subdomain you own, but you can't solve the
.well-known/acme-challenge/xxxxxxxx
challenge - Retrieve any kind of mock response for any URL path
You can point your IP/host to this app, and he'll retrieve what you pass through environment variables. Simple as that.
This code has an public image available in Docker Hub, with the runtime size of only ~88mb. Feel free to use this anywhere you like. ๐
docker pull simstosh/web-request-simulator
docker run --rm --name web-request -e RESPONSE="<b>Hello World</b>" simstosh/web-request-simulator
To install dependencies:
bun install
To run the project:
RESPONSE="content to retrieve" bun run dev
Environment variables available to use:
# This env var will be the body of the response. What you provide here, it'll return as response
RESPONSE="<b>Hello world!</b>"
# The port used by the app
PORT=3000
# The content-type of your response. If you don't provide anything, the default will be "text/html"
CONTENT_TYPE="text/html"