Files
faunosteo/scripts/dev-gateway.sh
T
bchanot 3e48b0d848 chore(workspace): DEV least-privilege exposure — nginx DEV gateway (API on the LAN, Mailpit behind basic auth), network check from a distinct origin, loopback default for the rootless daemon documented
The Supabase CLI publishes 54321-54324 on every interface with no bind
option. Design: the rootless daemon binds published ports on loopback by
default (~/.config/docker/daemon.json {"ip":"127.0.0.1"}, owner action,
not applied), and the DEV gateway (Compose service dev-gateway, profile
dev, container faunosteo_dev_gateway) re-publishes only the API (Kong) and
Mailpit behind HTTP basic auth on FAUNOSTEO_DEV_HOST; Studio and PostgreSQL
stay loopback (SSH tunnel for Studio). pnpm dev:gateway generates the Mailpit
credentials (gitignored; htpasswd 644 because the rootless container user
cannot read a 600 file, hash only). pnpm dev:net-check probes from a
throwaway container on its own Docker network: app, API health, REST 401,
Mailpit 401/200, PostgreSQL and Studio closed. Gateway proven on alternate
ports (health 200, password login 200, Mailpit 401 / 200).
2026-10-13 22:38:40 +02:00

37 lines
1.5 KiB
Bash
Executable File

#!/usr/bin/env bash
# DEV gateway on the private network (docs/development/ENVIRONMENTS.md §3).
# pnpm dev:gateway # up: generates the Mailpit credentials once, starts faunosteo_dev_gateway
# pnpm dev:gateway:stop # down
# Prerequisite: the rootless Docker daemon binds published ports on loopback by default
# (~/.config/docker/daemon.json {"ip": "127.0.0.1"}, ENVIRONMENTS.md §3.1), so the
# gateway is the only listener of the stack on the LAN address.
set -euo pipefail
cd "$(dirname "$0")/.."
. scripts/dev-env.sh
dir=docker/dev-gateway
htpasswd="$dir/htpasswd"
secret="$dir/mailpit-password"
case "${1:-up}" in
up)
if [ ! -s "$htpasswd" ]; then
password="$(openssl rand -base64 18 | tr -d '/+=' | cut -c1-20)"
printf 'dev:%s\n' "$(openssl passwd -apr1 "$password")" > "$htpasswd"
printf '%s\n' "$password" > "$secret"
# Rootless Docker: the container's nginx user maps to a subordinate uid and cannot
# read a 600 file of this account; the htpasswd holds only a hash. The clear
# password stays 600.
chmod 644 "$htpasswd"
chmod 600 "$secret"
echo "== Mailpit credentials generated: user dev, password in $secret (not committed)"
fi
docker compose --profile dev up -d dev-gateway
echo "== gateway: api $FAUNOSTEO_DEV_API_URL mailpit $FAUNOSTEO_DEV_MAILPIT_URL (user dev, password: cat $secret)"
;;
down)
docker compose --profile dev rm -sf dev-gateway
;;
*)
echo "usage: dev-gateway.sh [up|down]" >&2; exit 2 ;;
esac