selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Shadowsocks logo

Self-host Shadowsocks

v3.3.6

Lightweight pure-C SOCKS5 proxy for low-end boxes

ReleaseOpen SourceGPL-3.0
sudo pacman -S shadowsocks-libev
Updated9 months ago
LanguageC++
Setup difficultyModerate
Stars
16 186
Port
8388 (Shadowsocks server listen port (TCP and UDP), set via server_port in config.json)
Requires
Libuv
Docker
ghcr.io/shadowsocks/shadowsocks-c

What 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

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

How to install Shadowsocks

Install Shadowsocks with Docker

docker pull ghcr.io/shadowsocks/shadowsocks-c:latest
docker run -d --name shadowsocks-c --restart unless-stopped \
  --user "$(id -u):$(id -g)" --read-only --cap-drop=ALL \
  --security-opt=no-new-privileges:true \
  -p 8388:8388/tcp -p 8388:8388/udp \
  --mount type=bind,src="https://raw.githubusercontent.com/shadowsocks/shadowsocks-libev/HEAD/$PWD/config.json",dst=/etc/shadowsocks-c/config.json,readonly \
  ghcr.io/shadowsocks/shadowsocks-c:latest

Docker is the recommended way to run a server; image supports Linux AMD64 and ARM64.

How to configure Shadowsocks

  • SS_DEPENDENCY_MODEbundled`bundled` sources or `system` libraries
  • WITH_STATICONLink dependency archives; system mode also supports shared dependencies
  • SS_BUILD_EXECUTABLESONCommand-line tools
  • SS_BUILD_STATIC_LIBRARYONStatic embedding library with installed dependency archives
  • SS_BUILD_SHARED_LIBRARYONShared embedding library

Shadowsocks releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Proxy

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…