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).
This commit is contained in:
bchanot committed 2026-10-13 22:38:40 +02:00
1 parent 5a12596195
commit 3e48b0d848
11 files changed
+246 -36

No files matched your search

+21
View File
@@ -40,6 +40,27 @@ services:
- supabase
restart: unless-stopped
# DEV gateway (docs/development/ENVIRONMENTS.md §3): with the rootless daemon binding
# published ports on loopback by default, this is the only entry of the private
# network into the stack: the Supabase API on <DEV host>:54321 and Mailpit behind
# basic auth on <DEV host>:54324. Started by `pnpm dev:gateway` (profile `dev`),
# which exports FAUNOSTEO_DEV_HOST and generates docker/dev-gateway/htpasswd.
dev-gateway:
container_name: faunosteo_dev_gateway
profiles: ["dev"]
image: nginx:1.31-alpine
volumes:
- ./docker/dev-gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
- ./docker/dev-gateway/htpasswd:/etc/nginx/htpasswd:ro
ports:
- "${FAUNOSTEO_DEV_HOST:-127.0.0.1}:54321:54321"
- "${FAUNOSTEO_DEV_HOST:-127.0.0.1}:54324:54324"
security_opt:
- no-new-privileges:true
networks:
- supabase
restart: unless-stopped
networks:
supabase:
external: true