Skip to content

Allow runsc to connect to an external proxy via UDS with --network-uds-path. - #14862

Open
copybara-service[bot] wants to merge 1 commit into
masterfrom
test/cl984053710
Open

copybara-service[bot] wants to merge 1 commit into
masterfrom
test/cl984053710

Conversation

@copybara-service

@copybara-service copybara-service Bot commented Sep 21, 2026 •

Copy link
Copy Markdown

Allow runsc to connect to an external proxy via UDS with --network-uds-path.

Adds a --network-uds-path flag that points at an external UDS.
When set:

  • runsc connects to that socket and donates the resulting FD to the sentry as
    the primary network interface instead of creating an AF_PACKET socket.
  • configures the primary fdbased link as an IP-only link.
  • the socket must be SOCK_SEQPACKET because the sentry exchanges IP packets
    with one packet per datagram.
  • --network-uds-path is only supported with network=sandbox mode. Link
    offload settings (such as MTU, GSO, GRO, checksum offload) are not negotiated
    over the socket and must be agreed out-of-band with the peer.

In this mode, the external proxy connecting to the sentry should handle all
the egress filtering and blocking of any traffic (if required). Runsc will
forward all the traffic to that external proxy when network-uds-path is set.

@copybara-service copybara-service Bot added the exported Issue was exported automatically label Sep 21, 2026
@copybara-service copybara-service Bot changed the title Allow runsc to connect to an external proxy via UDS when --uds-path is set. Allow runsc to connect to an external proxy via UDS with --network-uds-path. Sep 23, 2026
…ds-path`.

Adds a `--network-uds-path` flag that points at an external UDS.
When set:
- runsc connects to that socket and donates the resulting FD to the sentry as
the primary network interface instead of creating an AF_PACKET socket.
- configures the primary fdbased link as an IP-only link.
- the socket must be SOCK_SEQPACKET because the sentry exchanges IP packets
with one packet per datagram.
- `--network-uds-path` is only supported with `network=sandbox` mode. Link
offload  settings (such as MTU, GSO, GRO, checksum offload) are not negotiated
over the socket and must be agreed out-of-band with the peer.

In this mode, the external proxy connecting to the sentry should handle all
the egress filtering and blocking of any traffic (if required). Runsc will
forward all the traffic to that external proxy when `network-uds-path` is set.

PiperOrigin-RevId: 984053710
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

exported Issue was exported automatically

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant