Skip to content

sandboxes: document upstream proxy configuration#25610

Draft
robmry wants to merge 1 commit into
docker:mainfrom
robmry:sandboxes-upstream-proxy-docs
Draft

sandboxes: document upstream proxy configuration#25610
robmry wants to merge 1 commit into
docker:mainfrom
robmry:sandboxes-upstream-proxy-docs

Conversation

@robmry

@robmry robmry commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Description

Documents the settings-driven, per-scope upstream proxy configuration for Docker Sandboxes, covering the user-facing surface of these docker/sandboxes PRs:

  • #4041 — SOCKS5 upstream support
  • #4058 — PAC file support
  • #4078system (OS proxy) support
  • #4342 — live tracking of OS proxy changes
  • #4413 — settings-driven config with separate sandbox/daemon scopes

(#3977 is a pure internal refactor with no user-facing surface.)

Changes

  • New page content/manuals/ai/sandboxes/upstream-proxy.md — "Configure an upstream proxy": default behavior (OS system proxy), sbx settings set proxy[.sandbox|.daemon], the value table (URL / PAC / SOCKS5 / system / direct), exclusion lists, environment-variable bindings, precedence, when changes take effect, and proxy authentication.
  • architecture.md — trimmed the upstream proxy section to the architectural concept plus the HTTP/HTTPS-only limitation, and pointed to the new page for configuration (so env vars are no longer framed as the way to configure it).
  • Cross-links added from the section index (_index.md) and the network isolation page.

Note

#4413 (the sbx settings set proxy.* interface and OS-system-proxy default) is still open upstream. If the command surface changes before it merges, this page will need to follow. Opening as a draft for that reason.

🤖 Generated with Claude Code

@netlify

netlify Bot commented Jul 21, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit f80057d
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a5f40ed8483310008c0eee7
😎 Deploy Preview https://deploy-preview-25610--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.

Add a page covering the settings-driven, per-scope upstream proxy: proxy
URLs, PAC files, SOCKS5, the OS system proxy, and separate sandbox/daemon
scopes, plus precedence and the environment-variable bindings.

Trim the architecture page's upstream proxy section to the concept plus the
HTTP/HTTPS-only limitation, and link to the new page for configuration.
Cross-link from the section index and the network isolation page.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@robmry
robmry force-pushed the sandboxes-upstream-proxy-docs branch from 689c1a9 to f80057d Compare July 21, 2026 09:50
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.

1 participant