1 unstable release
0.1.0 | May 3, 2022 |
---|
#10 in #shadowsocks
65KB
1.5K
SLoC
shadowsocks lightweight implementation(server side)
a proxy tool written in rust.
build
git clone https://github.com/kirito41dd/ss-light.git
cd ss-light && cargo test
cargo build --release
./target/release/server --version
usage
run with config.toml
:
./server -c config.toml
passwd = "123456"
method = "aes-256-gcm"
bind_addr = "0.0.0.0"
bind_port = 6789
timeout = 2000 # ms, timeout for tcp proxy handshake and tcp connect
log_level = "info" # error warn info debug trace
console_log = true
# file_log_dir = "applog/" # if no set, don't log to file
udp_capacity = 1000 # udp relay worker pool size, one proxy req one worker
udp_expiry_time = 30 # sec, expiration time for udp relay worker keep alive
# [plugin]
# name = "v2ray-plugin"
# opts = "server"
# args = []
or override config with:
./server -c config.toml -l 127.0.0.1 -p 1080 -k <a-secure-password>
if without -c
, default config file is $pwd/config.toml
more usage:
./server -h
quick start with docker
tips: use
<ctrl-p><ctrl-q>
exit container but keep it runningv2ray-plugin are recommended
start with default config but specify password:
docker run --rm -it -p 8888:6789/tcp -p 8888:6789/udp kirito41dd/ss-light -k passwd123
or start with custom config file:
- create new config dir in home then add
config.toml
file:mkdir $HOME/.ss-light && cd $HOME/.ss-light touch config.toml
- edit
config.toml
like here - run docker:
docker run --rm -it -v $HOME/.ss-light:/app -p 8888:6789/tcp -p 8888:6789/udp kirito41dd/ss-light
use v2ray-plugin: (websocket)
docker run --rm -it -p 8888:6789/tcp -p 8888:6789/udp kirito41dd/ss-light -k passwd123 --plugin v2ray-plugin --plugin-opts server
use other SIP003 plugins:
- like start with custom config file, download plugin to
$HOME/.ss-light
- start
docker run --rm -it -v $HOME/.ss-light:/app -p 8888:6789/tcp -p 8888:6789/udp kirito41dd/ss-light --plugin=/app/<your-plugin>
feature
- Shadowsocks AEAD
- AES_256_GCM
- TCP relay
- UDP relay
- Plugin
- v2ray-plugin
Dependencies
~13–22MB
~396K SLoC