docker/egress/v1.0.12

opensandbox-group/OpenSandboxdocker/egress/v1.0.12May 18, 2026by Pangjiping

AI Summary

Addresses streaming performance issues by unblocking SSE and chunked streaming through mitmproxy. A system addon is introduced to force streaming for specific content types while maintaining OOM protection for other large bodies.

Key Highlights

Fixed SSE and chunked streaming stutter by unblocking `flow.response.stream` for event streams and chunked transfers.
Introduced a system addon to force streaming behavior on specific content types.
Preserved existing large-body OOM protection for non-streaming content.

New Features

System addon for streaming enforcement

Full Release Notes

## What's New

### 🐛 Bug Fixes

- Unblock SSE / chunked streaming through mitmproxy. The `--set stream_large_bodies=1m` flag (added to prevent OOM on large downloads) buffered any response under 1 MiB before forwarding, stalling LLM SSE and chunked streams of small chunks until the stream ended or the threshold was hit — producing perceptible stutter downstream. Introduces a bundled system addon, always loaded by the egress launcher, that forces `flow.response.stream = True` for responses with `content-type: text/event-stream` or `transfer-encoding: chunked`. Large-body OOM protection from `stream_large_bodies` stays intact for everything else. The previous example script `add_header.py` is renamed to `system.py` and repurposed as the always-on system addon (wire-transparent: no headers added or altered). User-supplied addons via `OPENSANDBOX_EGRESS_MITMPROXY_SCRIPT` are still loaded after the system addon and may observe or override its hooks. (#898)

## 👥 Contributors

Thanks to these contributors ❤️

- @Pangjiping

---
- Docker Hub: opensandbox/egress:v1.0.12
- Aliyun Registry: sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.0.12