Skip to content

docs: document upstream proxy chaining for sandboxes#25359

Merged
dvdksn merged 2 commits into
docker:mainfrom
robmry:docs/sandbox-upstream-proxy
Jun 15, 2026
Merged

docs: document upstream proxy chaining for sandboxes#25359
dvdksn merged 2 commits into
docker:mainfrom
robmry:docs/sandbox-upstream-proxy

Conversation

@robmry

@robmry robmry commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Description

Documents how Docker Sandboxes' outbound traffic interacts with an upstream (for example, corporate) proxy. This was previously only described in internal-facing notes.

Adds an Upstream proxy subsection under the existing Networking heading on the Sandboxes architecture page, covering:

  • How the host-side proxy chains to an upstream proxy — direct routes are followed directly, and only destinations that require a proxy are forwarded to it, so sandbox traffic respects the same egress controls as other host applications.
  • The HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables the sandbox daemon reads (including lowercase equivalents), and using NO_PROXY for direct-reach exclusions.
  • DOCKER_SANDBOXES_PROXY — scoped to sandbox traffic only, sets one URL for both HTTP and HTTPS, and doesn't affect image pulls or the daemon's own requests.
  • That the variables must be set in the daemon's environment at launch.
  • Limitations: only HTTP/HTTPS traffic can be forwarded (no raw TCP), and proxy.pac files aren't supported.

Prompted by support questions about routing sandbox traffic through a corporate proxy.

🤖 Generated with Claude Code

Explain how sandbox outbound traffic chains to an upstream proxy,
the HTTP_PROXY/HTTPS_PROXY/NO_PROXY variables the daemon reads, the
DOCKER_SANDBOXES_PROXY override scoped to sandbox traffic, and the
HTTP-only and proxy.pac limitations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Rob Murray <rob.murray@docker.com>
@robmry robmry requested a review from dvdksn as a code owner June 15, 2026 10:03
@netlify

netlify Bot commented Jun 15, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit f9a09aa
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a2fcf9a3be819000899f7d8
😎 Deploy Preview https://deploy-preview-25359--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@docker-agent docker-agent left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

The new Upstream proxy subsection is clear, well-scoped, and accurately documents sandbox proxy chaining behavior. One minor style guide issue was found.

Severity Count
🟡 Medium 1

Comment thread content/manuals/ai/sandboxes/architecture.md Outdated
Restructure the two limitation bullets to drop parenthetical asides,
per STYLE.md guidance to avoid parentheses in technical documentation.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Rob Murray <rob.murray@docker.com>

@dvdksn dvdksn left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@dvdksn dvdksn merged commit 0339a8a into docker:main Jun 15, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants