Skip to content

Add SIP003u UDP extension documentation#311

Open
madeye wants to merge 1 commit into
mainfrom
feat/sip003u
Open

Add SIP003u UDP extension documentation#311
madeye wants to merge 1 commit into
mainfrom
feat/sip003u

Conversation

@madeye

@madeye madeye commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Closes #180.

Adds a documentation page for SIP003u, the backward-compatible UDP extension for SIP003 plugins, based on the refined proposal by @zonyitoo in #180.

Changes

  • docs/doc/sip003u.md — new page covering:
    • Abstract & motivation (UDP obfuscation, UDP-over-TCP)
    • Backward compatibility with plain SIP003 (disabled by default)
    • plugin_mode configuration (tcp_only / tcp_and_udp / udp_only)
    • Listening/forwarding behavior (UDP bind to SS_LOCAL_HOST/SS_LOCAL_PORT, full-cone NAT, typical relay flow)
    • Known good plugins (shadowsocks-yamux-plugin, wss-proxy) and implementations (shadowsocks-rust)
  • docs/.vitepress/config.ts — new "SIP003u UDP Extension" entry in the SIPs sidebar, after SIP003.
  • docs/doc/sip003.md — updated the "only TCP forwarded" restriction to cross-link SIP003u instead of stating there is no plan for UDP.

Verification

npm run docs:build passes locally.

🤖 Generated with Claude Code

Document SIP003u, the backward-compatible UDP extension for SIP003
plugins (plugin_mode tcp_and_udp / udp_only), based on the refined
proposal in shadowsocks-org#180. Adds a new SIPs sidebar entry and
cross-links the SIP003 UDP restriction note.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SIP003u - UDP Extension for SIP003 Plugins

1 participant