百科
shadowsocks-rust:开源代理内核百科
shadowsocks-rust 是 Shadowsocks 的 Rust 实现,同时提供 sslocal、ssserver、ssmanager、ssservice 和 ssurl。它把本地 SOCKS/HTTP/TUN/redir、服务器、多跳出站代理、DNS/FakeDNS 与容器/ Kubernetes 交付放进同一项目,但每项能力仍受 Cargo feature 与平台条件影响。
阅读路径:按“概览 → 核心能力/技术贡献 → 时间线或版本 → 生态与来源”阅读;事实、版本与判断均以正文标注的公开来源为准。
01 · 词条概览
- 名称:shadowsocks-rust
- 公开别名:ss-rust
- 许可证:MIT
- 官方仓库:https://github.com/shadowsocks/shadowsocks-rust
- 文档:官方文档
- 最近核验版本:v1.25.0(2026-08-26,发行说明)
shadowsocks-rust 是 Shadowsocks 的 Rust 实现,同时提供 sslocal、ssserver、ssmanager、ssservice 和 ssurl。它把本地 SOCKS/HTTP/TUN/redir、服务器、多跳出站代理、DNS/FakeDNS 与容器/ Kubernetes 交付放进同一项目,但每项能力仍受 Cargo feature 与平台条件影响。
02 · 核心架构与能力
本地、服务端与管理器
sslocal 接收 SOCKS5、HTTP、Tunnel、redir 或 TUN 流量并连接 Shadowsocks 服务端;ssserver 提供服务,ssmanager 在一个进程中管理多个服务器。配置可以写多个服务器并按延迟/可用性选择,但选择策略与 ACL 是本项目的实现行为,不能套用 Mihomo 的策略组定义。
来源:https://github.com/shadowsocks/shadowsocks-rust/blob/ab388c7466d21f979430e33cc9ef10e22fb05955/README.md#getting-started
DNS、FakeDNS 与透明模式
local-dns、local-fake-dns、local-redir 和 local-tun 是独立 Cargo features;FakeDNS 为查询分配虚拟地址,使透明代理能够保留域名,再按 ACL 处理。Linux 的 redirect/TProxy、Windows 的 TUN 和 macOS 的网络接口各有系统配置要求。
来源:https://github.com/shadowsocks/shadowsocks-rust/blob/ab388c7466d21f979430e33cc9ef10e22fb05955/README.md#optional-features
多跳出站代理的 UDP 限制
outbound_proxy 可以把 sslocal 或 ssserver 的 TCP 连接经 SOCKS5、HTTP 或 HTTPS 代理链建立;UDP 只有在链路全为 SOCKS5 时才支持中继,包含 HTTP/HTTPS 跳时会告警并绕过该链路。这个限制来自配置实现,不能仅凭“支持代理链”推断 UDP 一定可用。
来源:https://github.com/shadowsocks/shadowsocks-rust/blob/ab388c7466d21f979430e33cc9ef10e22fb05955/README.md#usage
v1.25.0 的 API 与构建变化
v1.25.0 将最低 Rust 版本提升到 1.91,并重构 outbound proxy API;同时增加 EIH、HTTP Basic auth 和仅 SOCKS5 链路的 UDP 中继等特性。使用该版本编译下游应用时,需要按发行说明迁移旧的 Rust API。
来源:https://github.com/shadowsocks/shadowsocks-rust/releases/tag/v1.25.0
03 · 来源与边界
本页依据截至 2026-11-13 的官方仓库、官方文档和发行记录整理。内核页面保留原有 /cores/shadowsocks-rust 页面;本 Wiki 只提供独立的百科阅读入口。