Skip to content

Commit 70ffe7d

Browse files
committed
Update reverse proxy docs for gzip and size limit behavior
Fix incorrect claim that rewritten responses are re-compressed. Document that binary content streams without buffering and text responses above 50MB skip rewriting.
1 parent fcce95a commit 70ffe7d

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/wiki/reverse-proxy.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ This means apps like **Plex**, which construct all their image and API URLs in J
7171

7272
### Gzip Handling
7373

74-
Compressed responses are transparently decompressed before rewriting, then re-compressed before being sent to the browser. No configuration is needed.
74+
Compressed (gzipped) responses are transparently decompressed before rewriting. The rewritten response is sent uncompressed; if Muximux sits behind an external reverse proxy (nginx, Traefik, Caddy), that proxy can apply its own compression to the final response. No configuration is needed.
7575

7676
---
7777

@@ -221,6 +221,8 @@ When a response passes through the proxy, the Go server rewrites URLs in the res
221221

222222
The distinction matters: API responses (JSON, XML) contain data that the SPA reads programmatically. If the proxy rewrites paths inside API data (e.g., `"/library/metadata/123"` → `"/proxy/plex/library/metadata/123"`), the SPA may embed those already-rewritten paths in new URLs, causing double-prefixing.
223223

224+
Only text content types are buffered for rewriting. Binary responses (images, videos, archives, file downloads) stream directly from the backend to the browser without being read into memory. Text responses larger than 50 MB are also streamed through without rewriting as a safety measure.
225+
224226
**Layer 2: Runtime Interceptor (Client-Side, Synchronous)**
225227

226228
A small `<script>` tag injected into every HTML response patches browser APIs before the app's own JavaScript runs:

0 commit comments

Comments
 (0)