From 3eabd3238fd9208932b0ab6656af9d600e07110b Mon Sep 17 00:00:00 2001
From: benya <benya@daemonlord.ru>
Date: Thu, 2 Apr 2026 23:27:46 +0300
Subject: [PATCH] feat: add single-port reverse proxy deployment support

---
 .env.example                          |  2 +-
 SUBSONIC_SERVER_BLUEPRINT.md          |  6 +--
 apps/web/src/components/app-shell.tsx |  3 +-
 apps/web/src/lib/api.ts               |  2 +-
 apps/web/vite.config.ts               | 14 +++++
 deploy/Caddyfile                      | 15 ++++++
 deploy/Dockerfile                     |  2 +-
 deploy/REVERSE_PROXY.md               | 77 +++++++++++++++++++++++++++
 docker-compose.yml                    | 11 ++--
 internal/config/config.go             |  2 +-
 10 files changed, 122 insertions(+), 12 deletions(-)
 create mode 100644 deploy/Caddyfile
 create mode 100644 deploy/REVERSE_PROXY.md

diff --git a/.env.example b/.env.example
index 326e6d5..1c5bb89 100644
--- a/.env.example
+++ b/.env.example
@@ -1,6 +1,6 @@
 APP_ENV=development
 SERVER_HOST=0.0.0.0
-SERVER_PORT=4040
+SERVER_PORT=5050
 DATABASE_PATH=./data/app.db
 APP_ENCRYPTION_KEY=change-me-for-production
 ARTWORK_CACHE_DIR=./data/artwork
diff --git a/SUBSONIC_SERVER_BLUEPRINT.md b/SUBSONIC_SERVER_BLUEPRINT.md
index 4175219..7dd8005 100644
--- a/SUBSONIC_SERVER_BLUEPRINT.md
+++ b/SUBSONIC_SERVER_BLUEPRINT.md
@@ -680,9 +680,9 @@ Responsibilities:
 - [x] Persistent DB volume
 - [x] Persistent cache volume
 - [x] Music folder mount strategy
-- [ ] Single public HTTPS port for web UI and Subsonic clients
-- [ ] Reverse proxy example
-- [ ] HTTPS deployment notes
+- [x] Single app port for web UI and Subsonic clients
+- [x] Reverse proxy example
+- [x] HTTP/reverse proxy deployment notes
 - [ ] Backup/restore notes
 
 ## Nice-to-Have After MVP
diff --git a/apps/web/src/components/app-shell.tsx b/apps/web/src/components/app-shell.tsx
index 3e635fa..dc45a98 100644
--- a/apps/web/src/components/app-shell.tsx
+++ b/apps/web/src/components/app-shell.tsx
@@ -38,6 +38,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
   const username = useSessionStore((state) => state.username)
   const clearSession = useSessionStore((state) => state.clearSession)
   const fullPlayerOpen = usePlayerStore((state) => state.fullPlayerOpen)
+  const currentOrigin = typeof window !== 'undefined' ? window.location.origin : ''
   const [settingsOpen, setSettingsOpen] = useState(false)
   const [userMenuOpen, setUserMenuOpen] = useState(false)
   const [paletteOpen, setPaletteOpen] = useState(false)
@@ -87,7 +88,7 @@ export function AppShell({ children }: { children: React.ReactNode }) {
               <div className="absolute right-0 top-10 z-30 w-64 overflow-hidden rounded-xl border border-[#24314f] bg-[#0d1528] shadow-2xl">
                 <div className="border-b border-[#24314f] px-4 py-3">
                   <div className="text-xl font-semibold text-white">{username ?? 'demo'}</div>
-                  <div className="mt-1 text-sm text-slate-400">https://music.daemonlord.ru</div>
+                  <div className="mt-1 text-sm text-slate-400">{currentOrigin || 'https://music.example.com'}</div>
                 </div>
                 <button className="flex w-full items-center justify-between px-4 py-3 text-left text-sm text-slate-100 hover:bg-[#18233a]" type="button">
                   Сочетания клавиш
diff --git a/apps/web/src/lib/api.ts b/apps/web/src/lib/api.ts
index 21affca..f30559d 100644
--- a/apps/web/src/lib/api.ts
+++ b/apps/web/src/lib/api.ts
@@ -79,7 +79,7 @@ export type PlaylistDetail = PlaylistSummary & {
   tracks: Track[]
 }
 
-const API_BASE = import.meta.env.VITE_API_BASE ?? 'http://localhost:4040'
+const API_BASE = import.meta.env.VITE_API_BASE ?? ''
 
 async function request<T>(path: string, init?: RequestInit): Promise<T> {
   const token = useSessionStore.getState().token
diff --git a/apps/web/vite.config.ts b/apps/web/vite.config.ts
index 17c6886..2fab319 100644
--- a/apps/web/vite.config.ts
+++ b/apps/web/vite.config.ts
@@ -14,5 +14,19 @@ export default defineConfig({
   },
   server: {
     port: 5173,
+    proxy: {
+      '/api': {
+        target: 'http://127.0.0.1:5050',
+        changeOrigin: true,
+      },
+      '/rest': {
+        target: 'http://127.0.0.1:5050',
+        changeOrigin: true,
+      },
+      '/health': {
+        target: 'http://127.0.0.1:5050',
+        changeOrigin: true,
+      },
+    },
   },
 })
diff --git a/deploy/Caddyfile b/deploy/Caddyfile
new file mode 100644
index 0000000..e163162
--- /dev/null
+++ b/deploy/Caddyfile
@@ -0,0 +1,15 @@
+:80 {
+  encode zstd gzip
+
+  header {
+    X-Content-Type-Options "nosniff"
+    X-Frame-Options "SAMEORIGIN"
+    Referrer-Policy "strict-origin-when-cross-origin"
+  }
+
+  reverse_proxy app:5050 {
+    header_up X-Forwarded-Proto {scheme}
+    header_up X-Forwarded-Host {host}
+    header_up X-Forwarded-For {remote_host}
+  }
+}
diff --git a/deploy/Dockerfile b/deploy/Dockerfile
index 623eff6..0291e47 100644
--- a/deploy/Dockerfile
+++ b/deploy/Dockerfile
@@ -19,5 +19,5 @@ COPY --from=backend-build /out/temporserv /app/temporserv
 COPY --from=web-build /src/apps/web/dist /app/web
 RUN mkdir -p /app/data /music && chown -R appuser:appuser /app /music
 USER appuser
-EXPOSE 4040
+EXPOSE 5050
 CMD ["/app/temporserv"]
diff --git a/deploy/REVERSE_PROXY.md b/deploy/REVERSE_PROXY.md
new file mode 100644
index 0000000..d84f917
--- /dev/null
+++ b/deploy/REVERSE_PROXY.md
@@ -0,0 +1,77 @@
+# Reverse Proxy Deployment
+
+The application is designed to run as a single HTTP service on one port.
+
+Default internal URL:
+
+- `http://127.0.0.1:5050`
+
+This same origin serves:
+
+- web UI on `/`
+- internal web API on `/api/*`
+- Subsonic API on `/rest/*`
+- cover art and streaming on the same host
+
+That means mobile and TV Subsonic clients should use the same base URL as the browser.
+
+Examples:
+
+- web UI: `http://your-host:5050/`
+- Subsonic client server URL: `http://your-host:5050`
+
+## Direct Docker Run
+
+Use the root `docker-compose.yml`.
+
+It publishes:
+
+- `5050:5050`
+
+After startup the app is available at:
+
+- `http://localhost:5050`
+
+## External Reverse Proxy
+
+If you later publish the service through another reverse proxy, forward the entire host to the same upstream:
+
+- upstream: `http://app-host:5050`
+
+Do not split web and Subsonic traffic across different public ports.
+
+Forward all of these paths to the same backend:
+
+- `/`
+- `/api/*`
+- `/rest/*`
+- `/health`
+
+## Caddy Example
+
+See [deploy/Caddyfile](C:\Users\benya\TemporServ\deploy\Caddyfile).
+
+This example listens on plain HTTP and proxies all requests to `app:5050`.
+
+## Nginx Example
+
+```nginx
+server {
+    listen 80;
+    server_name _;
+
+    location / {
+        proxy_pass http://127.0.0.1:5050;
+        proxy_set_header Host $host;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header X-Forwarded-Host $host;
+    }
+}
+```
+
+## Notes
+
+- In production the frontend uses relative URLs, so it works correctly behind the same origin without hardcoded API hosts.
+- In local frontend development, Vite proxies `/api`, `/rest`, and `/health` to `http://127.0.0.1:5050`.
+- If you later enable HTTPS on an external reverse proxy, clients should still connect to one public base URL only.
diff --git a/docker-compose.yml b/docker-compose.yml
index c1c8ddc..a658a69 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -6,15 +6,18 @@ services:
       context: .
       dockerfile: deploy/Dockerfile
     ports:
-      - "4040:4040"
+      - "5050:5050"
     environment:
       APP_ENV: production
       SERVER_HOST: 0.0.0.0
-      SERVER_PORT: 4040
+      SERVER_PORT: 5050
       DATABASE_PATH: /app/data/app.db
+      APP_ENCRYPTION_KEY: change-me-for-production
+      ARTWORK_CACHE_DIR: /app/data/artwork
       MEDIA_ROOT: /music
-      CORS_ORIGINS: http://localhost:4040
+      CORS_ORIGINS: http://localhost:5050
+      DEFAULT_ADMIN_USERNAME: demo
+      DEFAULT_ADMIN_PASSWORD: demo
     volumes:
       - ./data:/app/data
       - ./media:/music
-
diff --git a/internal/config/config.go b/internal/config/config.go
index 65c4176..8945a59 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -19,7 +19,7 @@ func Load() Config {
 	return Config{
 		AppEnv:               getenv("APP_ENV", "development"),
 		ServerHost:           getenv("SERVER_HOST", "0.0.0.0"),
-		ServerPort:           getenv("SERVER_PORT", "4040"),
+		ServerPort:           getenv("SERVER_PORT", "5050"),
 		DatabasePath:         getenv("DATABASE_PATH", "./data/app.db"),
 		EncryptionKey:        getenv("APP_ENCRYPTION_KEY", "temporserv-dev-insecure-key"),
 		ArtworkCacheDir:      getenv("ARTWORK_CACHE_DIR", "./data/artwork"),