shadowsocks-libev

(★ 16,182)

Bug-fix-only libev port of shadowsocks. Future development moved to shadowsocks-rust

File Explorer

Download Latest Version (.zip)

- Makefile
- - build.yml
  - tests.yml
- dependabot.yml
- FUNDING.yml
- issue_template.md
- chn.acl
- gfwlist.acl
- local.acl
- server_block_chn.acl
- server_block_local.acl
- config.h.cmake
- configure.cmake
- FindCares.cmake
- FindMbedTLS.cmake
- FindPCRE2.cmake
- FindSodium.cmake
- mbedtls_version_check.c
- shadowsocks-libev.pc.cmake
- - ss-local
  - ss-manager
  - ss-redir
  - ss-server
  - ss-tunnel
- - _ss-local
  - _ss-manager
  - _ss-redir
  - _ss-server
  - _ss-tunnel
- - format
- - control
- - metadata
- .gitignore
- changelog
- compat
- config.json
- control
- copyright
- copyright.original
- libshadowsocks-libev-dev.install
- libshadowsocks-libev2.install
- README.Debian
- rules
- shadowsocks-libev-local@.service
- shadowsocks-libev-redir@.service
- shadowsocks-libev-server@.service
- shadowsocks-libev-tunnel@.service
- shadowsocks-libev.default
- shadowsocks-libev.doc-base
- shadowsocks-libev.docs
- shadowsocks-libev.init
- shadowsocks-libev.install
- shadowsocks-libev.lintian-overrides
- shadowsocks-libev.NEWS
- shadowsocks-libev.postinst
- shadowsocks-libev.postrm
- shadowsocks-libev.service
- watch
- asciidoc.conf
- CMakeLists.txt
- manpage-base.xsl
- manpage-bold-literal.xsl
- manpage-normal.xsl
- shadowsocks-libev.asciidoc
- ss-local.asciidoc
- ss-manager.asciidoc
- ss-nat.asciidoc
- ss-redir.asciidoc
- ss-server.asciidoc
- ss-tunnel.asciidoc
- - docker-compose.yml
  - Dockerfile
  - entrypoint.sh
  - README.md
- - builder.Dockerfile
  - dockerbuild.sh
- - apt.sh
  - build.sh
  - deps.sh
  - Dockerfile
  - make.bat
  - Makefile
  - prepare.sh
- - shadowsocks-libev.spec.in
- genrpm.sh
- build_deb.sh
- chroot_build.sh
- code-format.bat
- code-format.sh
- git_archive.sh
- git_version.sh
- iperf.sh
- ss-setup.sh
- snapcraft.yaml
- - blake3.c
  - blake3.h
  - blake3_dispatch.c
  - blake3_impl.h
  - blake3_portable.c
  - LICENSE
- acl.c
- acl.h
- aead.c
- aead.h
- aead2022.c
- aead2022_udp.c
- aead_internal.h
- android.c
- base64.c
- base64.h
- cache.c
- cache.h
- CMakeLists.txt
- common.h
- crypto.c
- crypto.h
- jconf.c
- jconf.h
- json.c
- json.h
- local.c
- local.h
- manager.c
- manager.h
- netutils.c
- netutils.h
- plugin.c
- plugin.h
- ppbloom.c
- ppbloom.h
- redir.c
- redir.h
- resolv.c
- resolv.h
- rule.c
- rule.h
- server.c
- server.h
- shadowsocks.h
- socks5.h
- ss-nat
- ssurl.c
- ssurl.h
- stream.c
- stream.h
- tunnel.c
- tunnel.h
- udprelay.c
- udprelay.h
- uthash.h
- utils.c
- utils.h
- winsock.c
- winsock.h
- - guest-init.sh
- 2022-blake3-aes-128-gcm.json
- 2022-blake3-aes-256-gcm.json
- 2022-blake3-chacha20-poly1305.json
- aes-ctr.json
- aes-gcm.json
- aes.json
- chacha20-ietf-poly1305.json
- chacha20-ietf.json
- chacha20.json
- CMakeLists.txt
- rc4-md5.json
- redir.json
- salsa20.json
- stress_test.py
- test.py
- test.sh
- test_acl.c
- test_aead2022.c
- test_base64.c
- test_buffer.c
- test_cache.c
- test_crypto.c
- test_deb_build.sh
- test_interop_rust.sh
- test_jconf.c
- test_json.c
- test_netutils.c
- test_ppbloom.c
- test_redir_qemu.sh
- test_rule.c
- test_ss_setup.sh
- test_ssurl.c
- test_utils.c
.clang-tidy
.dockerignore
.gitignore
.gitmodules
.travis.yml
.uncrustify.cfg
AUTHORS
Changes
CLAUDE.md
CMakeLists.txt
COPYING
libbloom
libcork
libipset
LICENSE
README.md
README_pt_BR.md

# Installation Guide

1. Get the code

git clone https://github.com/shadowsocks/shadowsocks-libev

Downloads the entire project code from GitHub to your computer.

cd shadowsocks-libev

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

APT (Debian/Ubuntu 계열) Built into Debian/Ubuntu-based Linux distributions.
Homebrew A package manager for macOS/Linux.

sudo apt install shadowsocks-libev

Installs directly from the APT package repository (Debian/Ubuntu-based).

sudo apt-get install --no-install-recommends build-essential cmake pkg-config \

Installs directly from the APT package repository (Debian/Ubuntu-based).

brew install shadowsocks-libev

Installs the pre-built package via Homebrew — no source build required.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Docker

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker pull shadowsocks/shadowsocks-libev

Type this command into your terminal and run it.

docker run -e PASSWORD=<password> -p<server-port>:8388 -p<server-port>:8388/udp -d shadowsocks/shadowsocks-libev

Runs the built image as an actual container.

cd shadowsocks-libev/docker/mingw

Moves into the project folder you just downloaded.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

4. CMake

Medium

Prerequisites

Git Needed to download the project code from GitHub.
CMake The tool used to generate build configuration.
C/C++ 컴파일러 Windows needs Visual Studio (Community edition, free), macOS needs Xcode Command Line Tools, Linux needs the gcc/g++ package.

cmake ..

Analyzes the source code and generates build configuration files (must be run inside the build folder).

cmake .. -DCMAKE_PREFIX_PATH="/usr/local/opt/mbedtls;/usr/local/opt/libsodium"

Analyzes the source code and generates build configuration files (must be run inside the build folder).

sudo apt-get install --no-install-recommends build-essential cmake pkg-config \

Installs directly from the APT package repository (Debian/Ubuntu-based).

sudo yum install gcc cmake make pkg-config pcre2-devel c-ares-devel \

Type this command into your terminal and run it.

sudo pacman -S gcc cmake make pkg-config pcre2 c-ares libev libsodium mbedtls \

Type this command into your terminal and run it.

✅ Check that an executable was created inside the build folder, then run it directly (e.g. ./build/app_name).

Pulled directly from this repo's README.

5. Make

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).

make

Compiles the code based on the generated build configuration to produce an executable.

make install

Compiles the code based on the generated build configuration to produce an executable.

✅ If it finishes without errors, it worked. Try running the generated executable directly.

Pulled directly from this repo's README.