Self-host Shadowsocks
v3.3.6Lightweight pure-C SOCKS5 proxy for low-end boxes
sudo pacman -S shadowsocks-libev- Stars
- 16 186
- Port
- 8388 (Shadowsocks server listen port (TCP and UDP), set via server_port in config.json)
- Requires
- Libuv
ghcr.io/shadowsocks/shadowsocks-cWhat is Shadowsocks?
shadowsocks-c is the renamed and modernized shadowsocks-libev: a pure-C implementation of the Shadowsocks secured SOCKS5 proxy protocol, aimed at embedded devices and low-end servers where resource usage must stay small. It ships five command-line tools — ss-local (SOCKS5 client), ss-server, ss-redir (transparent proxy with redirect or TPROXY), ss-tunnel (local port forwarding) and ss-manager for multi-user instance management — and supports AEAD ciphers including the Shadowsocks 2022 (SIP022) blake3 suites, UDP relay, IPv6, access control lists, TCP Fast Open and experimental SIP003 obfuscation plugins. In September 2026 the project swapped libev for libuv, bundled pinned dependency sources so builds are self-contained and static, and turned on IOCP event handling under Windows and kqueue under macOS, while keeping command names, configuration paths and ABI compatibility with shadowsocks-libev. Self-hosting is easiest with the fully static ghcr.io Docker image plus a small config.json (listen port, password, cipher, TCP/UDP mode); alternatives are apt/pacman/nix/pkg packages or a CMake build needing only a C11 compiler and CMake 3.20+, plus helper scripts ss-setup (interactive TUI config/service wizard) and ss-nat (iptables NAT rules). Note that after a bug-fix-only phase the project was renamed, and shadowsocks-rust remains the flagship implementation of the org.
Shadowsocks alternatives
3proxySelf-hosted, open-source tiny proxy server: HTTP/HTTPS, SOCKS4/5, FTP, DNS and port mapping with ACLs, bandwidth limits and parent chaining.Compare3proxy with Shadowsocks
g3proxyOpen-source, self-hosted enterprise forward proxy in async Rust: HTTP, SOCKS5, SNI and TPROXY modes, MITM auditing, proxy chaining, ICAP hooks and StatsD metrics.Compareg3proxy with Shadowsocks
docker-ipsec-vpn-serverSelf-hosted IPsec VPN server in a ~19 MB Alpine Docker image with L2TP, Cisco IPsec and IKEv2, auto-generating credentials and client profiles.Comparedocker-ipsec-vpn-server with Shadowsocks
Self-Hosted GatewayOpen-source alternative to Cloudflare Tunnels using WireGuard, NGINX, and Caddy to expose local Docker containers without port forwarding.CompareSelf-Hosted Gateway with Shadowsocks
tlsproxySelf-hosted TLS termination proxy with auto Let's Encrypt, SSO (OIDC/SAML/Passkeys), and reverse proxy for multiple services on one port.Comparetlsproxy with Shadowsocks
chiselSelf-hosted, open-source TCP/UDP tunnel over HTTP with SSH encryption; a single Go binary running as both server and client, with SOCKS5 and reverse port forwarding.Comparechisel with Shadowsocks
v2rayAOpen-source, self-hosted proxy client with a browser UI over its own Xray-based core: subscriptions for VMess, VLESS, Hysteria2 and more, plus transparent proxy.Comparev2rayA with Shadowsocks
docker-openvpnSelf-hosted OpenVPN Docker image with auto PKI, client management, dual-stack IPv4/IPv6, and modern ciphers.Comparedocker-openvpn with Shadowsocks
Should you self-host Shadowsocks?
Shadowsocks scores 68/100 on selfhost.directory (how scoring works) and ranks #6 of 26 in Proxy. It has 16 186 GitHub stars, +6 in the last 30 days.
It shipped 1 stable release in the past year. The latest, v3.3.6, came out on 9 February 2026.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in C++.
Its closest alternative on selfhost.directory is frp (85/100, 110 482 stars). It scores higher overall, so compare the two before you pick. See Shadowsocks vs frp side by side.
Features
- Access control lists
- Asynchronous DNS and multiple servers
- IPv6 Support
- Local port forwarding
- Multi-user managerExcluded from SS_MINIMAL builds.
- Printable TCP salt experimentExperimental opt-in.
- Shadowsocks 2022 (SIP022) ciphers
- Shadowsocks server
- SIP003 obfuscation pluginsMarked Experimental by the project.
- SOCKS5 proxy client
- Ss-setup configuration wizard
- TCP Fast Open
- Transparent proxy mode
- UDP Relay
Shadowsocks README
shadowsocks-c is a lightweight secured SOCKS5 proxy for embedded devices and low-end boxes.
It is a port of Shadowsocks created by @clowwindy, and maintained by @madeye and @linusyang.
Current version: 3.3.6 | Changelog
More in Proxy
Signal TLS ProxyOpen-source Docker Compose proxy that fronts Signal's servers with a Let's Encrypt certificate on your own domain, shareable with other users via signal.tube.
Smart-DNSSelf-hosted Smart DNS service that resolves whitelisted domains to a specified IP while forwarding other queries normally, using a Python DNS server and Nginx SNI proxy.
spoofdpiSelf-hosted, open-source anti-censorship proxy that beats Deep Packet Inspection via TLS fragmentation, fake packets and DoH, in HTTP, SOCKS5 and TUN modes.
squidSelf-hosted web proxy caching server reducing bandwidth usage and improving response times by caching frequently-requested web pages. Supports HTTP, HTTPS, FTP.
TinyproxyCompact proxy server software handling web traffic on POSIX systems through buffering technology designed to minimize delays on shared internet links.
tnnltnnl is a self-hosted, open-source ngrok alternative exposing local HTTP servers via subdomains with a single binary, no account needed.
tobabtobab is a self-hosted, open-source identity-aware proxy using passkeys for authentication, designed as a forward auth target for Caddy, nginx, or Traefik in homelabs.
towoneltowonel is an open-source, self-hosted tunnel exposing HTTP(S), TCP, and UDP services behind NAT or CGNAT without inbound ports, using a persistent QUIC tunnel.
traefik-geoip-filterSelf-hosted Docker container adding GeoIP filtering to Traefik, allowing or blocking traffic by country, region, or city via MaxMind GeoLite2.
tsbridgeA self-hosted reverse proxy using Tailscale's tsnet to expose many services on a Tailnet from one process, configured via TOML or Docker labels.
txtdottxtdot is a self-hosted, open-source HTTP proxy that fetches web pages and returns only text, links and pictures — removing ads and scripts to reduce bandwidth.
usqueusque is a self-hosted, open-source reimplementation of Cloudflare WARP using MASQUE (RFC 9484) for secure tunnels as SOCKS5/HTTP proxies or TUN interfaces.
0 comments