[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/pengshp/shadowsocks-libev/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","pengshp","reponame","shadowsocks-libev","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-01-08T01:08:20.719088Z","description","A lightweight secured SOCKS5 proxy for embedded devices and low-end boxes.","is_private","last_updated","2020-07-15T03:50:03.174568Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",313,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# shadowsocks-libev\n\n[![Build Status](https://travis-ci.com/shadowsocks/shadowsocks-libev.svg?branch=master)](https://travis-ci.com/shadowsocks/shadowsocks-libev) [![Snap Status](https://build.snapcraft.io/badge/shadowsocks/shadowsocks-libev.svg)](https://build.snapcraft.io/user/shadowsocks/shadowsocks-libev)\n\n## Intro\n\n[Shadowsocks-libev](https://shadowsocks.org) is a lightweight secured SOCKS5\nproxy for embedded devices and low-end boxes.\n\nIt is a port of [Shadowsocks](https://github.com/shadowsocks/shadowsocks)\ncreated by [@clowwindy](https://github.com/clowwindy), and maintained by\n[@madeye](https://github.com/madeye) and [@linusyang](https://github.com/linusyang).\n\nCurrent version: 3.3.3 | [Changelog](debian/changelog)\n\n## Features\n\nShadowsocks-libev is written in pure C and depends on [libev](http://software.schmorp.de/pkg/libev.html). It's designed\nto be a lightweight implementation of shadowsocks protocol, in order to keep the resource usage as low as possible.\n\nFor a full list of feature comparison between different versions of shadowsocks,\nrefer to the [Wiki page](https://github.com/shadowsocks/shadowsocks/wiki/Feature-Comparison-across-Different-Versions).\n\n## Quick Start\n\nSnap is the recommended way to install the latest binaries.\n\n### Install snap core\n\nhttps://snapcraft.io/core\n\n### Install from snapcraft.io\n\nStable channel:\n\n```bash\nsudo snap install shadowsocks-libev\n```\n\nEdge channel:\n\n```bash\nsudo snap install shadowsocks-libev --edge\n```\n\n## Installation\n\n### Distribution-specific guide\n\n- [Debian & Ubuntu](#debian--ubuntu)\n + [Install from repository](#install-from-repository)\n + [Build deb package from source](#build-deb-package-from-source)\n + [Configure and start the service](#configure-and-start-the-service)\n- [Fedora & RHEL](#fedora--rhel)\n + [Build from source with centos](#build-from-source-with-centos)\n + [Install from repository](#install-from-repository-1)\n- [Archlinux & Manjaro](#archlinux--manjaro)\n- [NixOS](#nixos)\n- [Nix](#nix)\n- [Directly build and install on UNIX-like system](#linux)\n- [FreeBSD](#freebsd)\n + [Install](#install)\n + [Configuration](#configuration)\n + [Run](#run)\n + [Run as client](#run-as-client)\n- [OpenWRT](#openwrt)\n- [OS X](#os-x)\n- [Windows (MinGW)](#windows-mingw)\n- [Docker](#docker)\n\n* * *\n\n### Pre-build configure guide\n\nFor a complete list of available configure-time option,\ntry `configure --help`.\n\n### Debian & Ubuntu\n\n#### Install from repository\n\nShadowsocks-libev is available in the official repository for following distributions:\n\n* Debian 8 or higher, including oldoldstable (jessie), old stable (stretch), stable (buster), testing (bullseye) and unstable (sid)\n* Ubuntu 16.10 or higher\n\n```bash\nsudo apt update\nsudo apt install shadowsocks-libev\n```\n\nFor **Debian 9 (Stretch)** users, please install it from `stretch-backports`:\nWe strongly encourage you to install shadowsocks-libev from `stretch-backports`.\nFor more info about backports, you can refer [Debian Backports](https://backports.debian.org).\n\n```bash\nsudo sh -c 'printf \"deb http://deb.debian.org/debian stretch-backports main\" > /etc/apt/sources.list.d/stretch-backports.list'\nsudo apt update\nsudo apt -t stretch-backports install shadowsocks-libev\n```\n\n#### Build deb package from source\n\nSupported distributions:\n\n* Debian 8, 9 or higher\n* Ubuntu 14.04 LTS, 16.04 LTS, 16.10 or higher\n\nYou can build shadowsocks-libev and all its dependencies by script:\n\n```bash\nmkdir -p ~/build-area/\ncp ./scripts/build_deb.sh ~/build-area/\ncd ~/build-area\n./build_deb.sh\n```\n\nFor older systems, building `.deb` packages is not supported.\nPlease try to build and install directly from source. See the [Linux](#linux) section below.\n\n**Note for Debian 8 (Jessie) users to build their own deb packages**:\n\nWe strongly encourage you to install shadowsocks-libev from `jessie-backports-sloppy`. If you insist on building from source, you will need to manually install libsodium from `jessie-backports-sloppy`, **NOT** libsodium in main repository.\n\nFor more info about backports, you can refer [Debian Backports](https://backports.debian.org).\n\n``` bash\ncd shadowsocks-libev\nsudo sh -c 'printf \"deb http://deb.debian.org/debian jessie-backports main\" > /etc/apt/sources.list.d/jessie-backports.list'\nsudo sh -c 'printf \"deb http://deb.debian.org/debian jessie-backports-sloppy main\" >> /etc/apt/sources.list.d/jessie-backports.list'\nsudo apt-get install --no-install-recommends devscripts equivs\nmk-build-deps --root-cmd sudo --install --tool \"apt-get -o Debug::pkgProblemResolver=yes --no-install-recommends -y\"\n./autogen.sh && dpkg-buildpackage -b -us -uc\ncd ..\nsudo dpkg -i shadowsocks-libev*.deb\n```\n\n**Note for Debian 9 (Stretch) users to build their own deb packages**:\n\nWe strongly encourage you to install shadowsocks-libev from `stretch-backports`. If you insist on building from source, you will need to manually install libsodium from `stretch-backports`, **NOT** libsodium in main repository.\n\nFor more info about backports, you can refer [Debian Backports](https://backports.debian.org).\n\n``` bash\ncd shadowsocks-libev\nsudo sh -c 'printf \"deb http://deb.debian.org/debian stretch-backports main\" > /etc/apt/sources.list.d/stretch-backports.list'\nsudo apt-get install --no-install-recommends devscripts equivs\nmk-build-deps --root-cmd sudo --install --tool \"apt-get -o Debug::pkgProblemResolver=yes --no-install-recommends -y\"\n./autogen.sh && dpkg-buildpackage -b -us -uc\ncd ..\nsudo dpkg -i shadowsocks-libev*.deb\n```\n\n#### Configure and start the service\n\n```\n# Edit the configuration file\nsudo vim /etc/shadowsocks-libev/config.json\n\n# Edit the default configuration for debian\nsudo vim /etc/default/shadowsocks-libev\n\n# Start the service\nsudo /etc/init.d/shadowsocks-libev start # for sysvinit, or\nsudo systemctl start shadowsocks-libev # for systemd\n```\n\n### Fedora & RHEL\n\nSupported distributions:\n\n* Recent Fedora versions (until EOL)\n* RHEL 6, 7 and derivatives (including CentOS, Scientific Linux)\n\n#### Build from source with centos\n\nIf you are using CentOS 7, you need to install these prequirement to build from source code:\n\n```bash\nyum install epel-release -y\nyum install gcc gettext autoconf libtool automake make pcre-devel asciidoc xmlto c-ares-devel libev-devel libsodium-devel mbedtls-devel -y\n```\n\n#### Install from repository\n\nEnable repo via `dnf`:\n\n```\nsu -c 'dnf copr enable librehat/shadowsocks'\n```\n\nOr download yum repo on [Fedora Copr](https://copr.fedoraproject.org/coprs/librehat/shadowsocks/) and put it inside `/etc/yum.repos.d/`. The release `Epel` is for RHEL and its derivatives.\n\nThen, install `shadowsocks-libev` via `dnf`:\n\n```bash\nsu -c 'dnf update'\nsu -c 'dnf install shadowsocks-libev'\n```\n\nor `yum`:\n\n```bash\nsu -c 'yum update'\nsu -c 'yum install shadowsocks-libev'\n```\nThe repository is maintained by [@librehat](https://github.com/librehat), any issues, please report [here](https://github.com/librehat/shadowsocks-libev/issues)\n\n### Archlinux & Manjaro\n\n```bash\nsudo pacman -S shadowsocks-libev\n```\n\nPlease refer to downstream [PKGBUILD](https://projects.archlinux.org/svntogit/community.git/tree/trunk?h=packages/shadowsocks-libev)\nscript for extra modifications and distribution-specific bugs.\n\n### NixOS\n\n```bash\nnix-env -iA nixos.shadowsocks-libev\n```\n\n### Nix\n\n```bash\nnix-env -iA nixpkgs.shadowsocks-libev\n```\n\n### Linux\n\nIn general, you need the following build dependencies:\n\n* autotools (autoconf, automake, libtool)\n* gettext\n* pkg-config\n* libmbedtls\n* libsodium\n* libpcre3 (old pcre library)\n* libev\n* libc-ares\n* asciidoc (for documentation only)\n* xmlto (for documentation only)\n\nNotes: Fedora 26 libsodium version >= 1.0.12, so you can install via dnf install libsodium instead build from source.\n\nIf your system is too old to provide libmbedtls and libsodium (later than **v1.0.8**), you will need to either install those libraries manually or upgrade your system.\n\nIf your system provides with those libraries, you **should not** install them from source. You should jump this section and install them from distribution repository instead.\n\nFor some of the distributions, you might install build dependencies like this:\n\n```bash\n# Installation of basic build dependencies\n## Debian / Ubuntu\nsudo apt-get install --no-install-recommends gettext build-essential autoconf libtool libpcre3-dev asciidoc xmlto libev-dev libc-ares-dev automake libmbedtls-dev libsodium-dev\n## CentOS / Fedora / RHEL\nsudo yum install gettext gcc autoconf libtool automake make asciidoc xmlto c-ares-devel libev-devel\n## Arch\nsudo pacman -S gettext gcc autoconf libtool automake make asciidoc xmlto c-ares libev\n\n# Installation of libsodium\nexport LIBSODIUM_VER=1.0.16\nwget https://download.libsodium.org/libsodium/releases/libsodium-$LIBSODIUM_VER.tar.gz\ntar xvf libsodium-$LIBSODIUM_VER.tar.gz\npushd libsodium-$LIBSODIUM_VER\n./configure --prefix=/usr && make\nsudo make install\npopd\nsudo ldconfig\n\n# Installation of MbedTLS\nexport MBEDTLS_VER=2.6.0\nwget https://tls.mbed.org/download/mbedtls-$MBEDTLS_VER-gpl.tgz\ntar xvf mbedtls-$MBEDTLS_VER-gpl.tgz\npushd mbedtls-$MBEDTLS_VER\nmake SHARED=1 CFLAGS=\"-O2 -fPIC\"\nsudo make DESTDIR=/usr install\npopd\nsudo ldconfig\n\n# Start building\n./autogen.sh && ./configure && make\nsudo make install\n```\n\nYou may need to manually install missing softwares.\n\n### FreeBSD\n#### Install\nShadowsocks-libev is available in FreeBSD Ports Collection. You can install it in either way, `pkg` or `ports`.\n\n**pkg (recommended)**\n\n```bash\npkg install shadowsocks-libev\n```\n\n**ports**\n\n```bash\ncd /usr/ports/net/shadowsocks-libev\nmake install\n```\n\n#### Configuration\nEdit your `config.json` file. By default, it's located in `/usr/local/etc/shadowsocks-libev`.\n\nTo enable shadowsocks-libev, add the following rc variable to your `/etc/rc.conf` file:\n\n```\nshadowsocks_libev_enable=\"YES\"\n```\n\n#### Run\n\nStart the Shadowsocks server:\n\n```bash\nservice shadowsocks_libev start\n```\n\n#### Run as client\nBy default, shadowsocks-libev is running as a server in FreeBSD. If you would like to start shadowsocks-libev in client mode, you can modify the rc script (`/usr/local/etc/rc.d/shadowsocks_libev`) manually.\n\n```\n# modify the following line from \"ss-server\" to \"ss-local\"\ncommand=\"/usr/local/bin/ss-local\"\n```\n\nNote that is simply a workaround, each time you upgrade the port your changes will be overwritten by the new version.\n\n### OpenWRT\n\nThe OpenWRT project is maintained here:\n[openwrt-shadowsocks](https://github.com/shadowsocks/openwrt-shadowsocks).\n\n### OS X\nFor OS X, use [Homebrew](http://brew.sh) to install or build.\n\nInstall Homebrew:\n\n```bash\nruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n```\nInstall shadowsocks-libev:\n\n```bash\nbrew install shadowsocks-libev\n```\n\n### Windows (MinGW)\nTo build Windows native binaries, the recommended method is to use Docker:\n\n* On Windows: double-click `make.bat` in `docker\\mingw`\n* On Unix-like system:\n\n cd shadowsocks-libev/docker/mingw\n make\n\nA tarball with 32-bit and 64-bit binaries will be generated in the same directory.\n\nYou could also manually use MinGW-w64 compilers to build in Unix-like shell (MSYS2/Cygwin), or cross-compile on Unix-like systems (Linux/MacOS). Please refer to build scripts in `docker/mingw`.\n\nCurrently you need to use a patched libev library for MinGW:\n\n* https://github.com/shadowsocks/libev/archive/mingw.zip\n\nNotice that TCP Fast Open (TFO) is only available on **Windows 10**, **1607** or later version (precisely, build >= 14393). If you are using **1709** (build 16299) or later version, you also need to run the following command in PowerShell/Command Prompt **as Administrator** and **reboot** to use TFO properly:\n\n netsh int tcp set global fastopenfallback=disabled\n\n### Docker\n\nAs you expect, simply pull the image and run.\n```\ndocker pull shadowsocks/shadowsocks-libev\ndocker run -e PASSWORD= -p:8388 -p:8388/udp -d shadowsocks/shadowsocks-libev\n```\n\nMore information about the image can be found [here](docker/alpine/README.md).\n\n## Usage\n\nFor a detailed and complete list of all supported arguments,\nyou may refer to the man pages of the applications, respectively.\n\n ss-[local|redir|server|tunnel|manager]\n\n -s Host name or IP address of your remote server.\n\n -p Port number of your remote server.\n\n -l Port number of your local server.\n\n -k Password of your remote server.\n\n -m Encrypt method: rc4-md5,\n aes-128-gcm, aes-192-gcm, aes-256-gcm,\n aes-128-cfb, aes-192-cfb, aes-256-cfb,\n aes-128-ctr, aes-192-ctr, aes-256-ctr,\n camellia-128-cfb, camellia-192-cfb,\n camellia-256-cfb, bf-cfb,\n chacha20-ietf-poly1305,\n xchacha20-ietf-poly1305,\n salsa20, chacha20 and chacha20-ietf.\n The default cipher is chacha20-ietf-poly1305.\n\n [-a ] Run as another user.\n\n [-f ] The file path to store pid.\n\n [-t ] Socket timeout in seconds.\n\n [-c ] The path to config file.\n\n [-n ] Max number of open files.\n\n [-i ] Network interface to bind.\n (not available in redir mode)\n\n [-b ] Local address to bind.\n For servers: Specify the local address to use \n while this server is making outbound \n connections to remote servers on behalf of the\n clients.\n For clients: Specify the local address to use \n while this client is making outbound \n connections to the server.\n\n [-u] Enable UDP relay.\n (TPROXY is required in redir mode)\n\n [-U] Enable UDP relay and disable TCP relay.\n (not available in local mode)\n\n [-L :] Destination server address and port\n for local port forwarding.\n (only available in tunnel mode)\n\n [-6] Resolve hostname to IPv6 address first.\n\n [-d ] Name servers for internal DNS resolver.\n (only available in server mode)\n\n [--reuse-port] Enable port reuse.\n\n [--fast-open] Enable TCP fast open.\n with Linux kernel > 3.7.0.\n (only available in local and server mode)\n\n [--acl ] Path to ACL (Access Control List).\n (only available in local and server mode)\n\n [--manager-address ] UNIX domain socket address.\n (only available in server and manager mode)\n\n [--mtu ] MTU of your network interface.\n\n [--mptcp] Enable Multipath TCP on MPTCP Kernel.\n\n [--no-delay] Enable TCP_NODELAY.\n\n [--executable ] Path to the executable of ss-server.\n (only available in manager mode)\n\n [-D ] Path to the working directory of ss-manager.\n (only available in manager mode)\n\n [--key ] Key of your remote server.\n\n [--plugin ] Enable SIP003 plugin. (Experimental)\n\n [--plugin-opts ] Set SIP003 plugin options. (Experimental)\n\n [-v] Verbose mode.\n\n## Transparent proxy\n\nThe latest shadowsocks-libev has provided a *redir* mode. You can configure your Linux-based box or router to proxy all TCP traffic transparently, which is handy if you use an OpenWRT-powered router.\n\n # Create new chain\n iptables -t nat -N SHADOWSOCKS\n iptables -t mangle -N SHADOWSOCKS\n\n # Ignore your shadowsocks server's addresses\n # It's very IMPORTANT, just be careful.\n iptables -t nat -A SHADOWSOCKS -d 123.123.123.123 -j RETURN\n\n # Ignore LANs and any other addresses you'd like to bypass the proxy\n # See Wikipedia and RFC5735 for full list of reserved networks.\n # See ashi009/bestroutetb for a highly optimized CHN route list.\n iptables -t nat -A SHADOWSOCKS -d 0.0.0.0/8 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 10.0.0.0/8 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 127.0.0.0/8 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 169.254.0.0/16 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 172.16.0.0/12 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 192.168.0.0/16 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 224.0.0.0/4 -j RETURN\n iptables -t nat -A SHADOWSOCKS -d 240.0.0.0/4 -j RETURN\n\n # Anything else should be redirected to shadowsocks's local port\n iptables -t nat -A SHADOWSOCKS -p tcp -j REDIRECT --to-ports 12345\n\n # Add any UDP rules\n ip route add local default dev lo table 100\n ip rule add fwmark 1 lookup 100\n iptables -t mangle -A SHADOWSOCKS -p udp --dport 53 -j TPROXY --on-port 12345 --tproxy-mark 0x01/0x01\n\n # Apply the rules\n iptables -t nat -A PREROUTING -p tcp -j SHADOWSOCKS\n iptables -t mangle -A PREROUTING -j SHADOWSOCKS\n\n # Start the shadowsocks-redir\n ss-redir -u -c /etc/config/shadowsocks.json -f /var/run/shadowsocks.pid\n\n\n## Security Tips\n\nFor any public server, to avoid users accessing localhost of your server, please add `--acl acl/server_block_local.acl` to the command line.\n\nAlthough shadowsocks-libev can handle thousands of concurrent connections nicely, we still recommend\nsetting up your server's firewall rules to limit connections from each user:\n\n # Up to 32 connections are enough for normal usage\n iptables -A INPUT -p tcp --syn --dport ${SHADOWSOCKS_PORT} -m connlimit --connlimit-above 32 -j REJECT --reject-with tcp-reset\n\n## License\n\n```\nCopyright: 2013-2015, Clow Windy \n 2013-2018, Max Lv \n 2014, Linus Yang \n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program. If not, see .\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",15905127,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",1068249,"full_size",8174443,"id",81850134,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:28e552bdae14b40b90cbdaf1590e2c878fedbc04e305e028118d5ab3f5fdcb33","features","","last_pulled","2026-09-24T18:56:53.36067147Z","last_pushed","2020-07-15T03:50:03Z","os","linux","os_features","os_version","size","variant","2020-07-15T03:50:02.811484Z","last_updater","last_updater_username","media_type","latest","repository",8279872,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":11,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

pengshp/shadowsocks-libev

Tags for pengshp/shadowsocks-libev