shadowsocks rust
1.21.2
Este é um porto de Shadowsocks.
shadowocks é um proxy de túnel rápido que ajuda a contornar firewalls.
| Biblioteca | Descrição |
|---|---|
| sombras | protocolo principal shadowocks |
| serviço shadowocks | Serviços para servir shadowocks |
| shadowocks-ferrugem | Binários executando serviços shadowocks comuns |
Projetos Relacionados:
sslocal usando GTK, discussãosslocal , discussão hickory-dns - Usa hickory-resolver como resolvedor de DNS em vez do integrado do tokio .
local-http – Permitir o uso do protocolo HTTP para sslocal
local-http-native-tls – Suporte HTTPS com native-tls
local-http-rustls – Suporte HTTPS com rustls
local-tunnel - Permitir o uso do protocolo de túnel para sslocal
local-socks4 - Permitir usar o protocolo SOCKS4/4a para sslocal
local-redir - Permite usar o protocolo redir (proxy transparente) para sslocal
local-dns - Permite o uso do protocolo DNS para sslocal , serve como um servidor DNS fazendo proxy de consultas para servidores DNS locais ou remotos por regras ACL
local-fake-dns - FakeDNS, alocando um endereço IP para cada consulta individual de um pool de IP específico
local-tun - suporte de interface TUN para sslocal
local-online-config - Entrega de configuração on-line SIP008
stream-cipher - Habilita cifras de fluxo obsoletas. AVISO: as cifras de fluxo não são seguras!
aead-cipher-extra - Habilita cifras AEAD não padrão
aead-cipher-2022 - Habilita cifras AEAD-2022 (SIP022)
aead-cipher-2022-extra - Habilita cifras extras AEAD-2022 (cifras não padrão)
Este projeto usa alocador de memória do sistema (libc) (padrão do Rust). Mas também permite usar outros alocadores famosos por recursos:
jemalloc - Usa jemalloc como alocador de memória globalmimalloc - Usa mi-malloc como alocador de memória globaltcmalloc - Usa TCMalloc como alocador de memória global. Ele tenta vincular tcmalloc em todo o sistema por padrão, use vendored from source com tcmalloc-vendored .snmalloc - Usa snmalloc como alocador de memória globalrpmalloc - Usa rpmalloc como alocador de memória globalInstale em crates.io:
# Install from crates.io
cargo install shadowsocks-rust então você pode encontrar sslocal e ssserver em $CARGO_HOME/bin .
Para macOS e Linux, você pode instalá-lo usando Homebrew:
brew install shadowsocks-rust # Install from snapstore
snap install shadowsocks-rust
# List services
snap services shadowsocks-rust
# Enable and start shadowsocks-rust.sslocal-daemon snap service
snap start --enable shadowsocks-rust.sslocal-daemon
# Show generated systemd service status
systemctl status snap.shadowsocks-rust.sslocal-daemon.service
# Override generated systemd service (configure startup options)
systemctl edit snap.shadowsocks-rust.sslocal-daemon.service
# # NOTE: you can pass args to sslocal:
# # [Service]
# # ExecStart=
# # ExecStart=/usr/bin/snap run shadowsocks-rust.sslocal-daemon -b "127.0.0.1:1080" --server-url "ss://...."
# Restart generated systemd service to apply changes
systemctl restart snap.shadowsocks-rust.sslocal-daemon.service
# ... and show service status
systemctl status snap.shadowsocks-rust.sslocal-daemon.serviceBaixe a compilação vinculada estática aqui.
build-windows : Compilação para x86_64-pc-windows-msvcbuild-linux : Compilação para x86_64-unknown-linux-gnu , Debian 9 (Stretch), GLIBC 2.18build-docker : Compilar para x86_64-unknown-linux-musl , x86_64-pc-windows-gnu , ... (vinculado estaticamente) Este projeto forneceu imagens Docker para as arquiteturas linux/i386 e linux/amd64 e linux/arm64/v8 .
⚠️ Os contêineres do Docker não têm acesso ao IPv6 por padrão : certifique-se de desabilitar a rota IPv6 no cliente ou habilitar o acesso IPv6 aos contêineres do Docker.
O Docker extrairá a imagem da arquitetura apropriada de nossos pacotes GitHub.
docker pull ghcr.io/shadowsocks/sslocal-rust:latest
docker pull ghcr.io/shadowsocks/ssserver-rust:latestSe você quiser construir a imagem Docker sozinho, precisará usar o BuildX.
docker buildx build -t shadowsocks/ssserver-rust:latest -t shadowsocks/ssserver-rust:v1.15.2 --target ssserver .
docker buildx build -t shadowsocks/sslocal-rust:latest -t shadowsocks/sslocal-rust:v1.15.2 --target sslocal . Você precisa montar o arquivo de configuração no contêiner e criar um mapa de porta externa para o contêiner se conectar a ele.
docker run --name sslocal-rust
--restart always
-p 1080:1080/tcp
-v /path/to/config.json:/etc/shadowsocks-rust/config.json
-dit ghcr.io/shadowsocks/sslocal-rust:latest
docker run --name ssserver-rust
--restart always
-p 8388:8388/tcp
-p 8388:8388/udp
-v /path/to/config.json:/etc/shadowsocks-rust/config.json
-dit ghcr.io/shadowsocks/ssserver-rust:latestEste projeto forneceu manifestos yaml para implantação no Kubernetes.
Você pode aproveitar o serviço k8s para expor o tráfego externo, como LoadBalancer ou NodePort, que ganha mais granularidade em comparação com host ou porta fixa.
Para um caso de uso mais interessante, você pode usar um Ingress (Istio, nginx, etc.) que roteia o tráfego correspondente para shadowocks junto com o serviço da web real.
kubectl kubectl apply -f https://github.com/shadowsocks/shadowsocks-rust/raw/master/k8s/shadowsocks-rust.yaml
Você pode alterar a configuração editando o ConfigMap chamado shadowsocks-rust .
Para um controle mais refinado, use helm .
helm helm install my-release k8s/chart -f my-values.yaml
Abaixo estão os valores padrão comuns que você pode alterar:
# This is the shadowsocks config which will be mount to /etc/shadowocks-rust.
# You can put arbitrary yaml here, and it will be translated to json before mounting.
servers :
- server : " :: "
server_port : 8388
service_port : 80 # the k8s service port, default to server_port
password : mypassword
method : aes-256-gcm
fast_open : true
mode : tcp_and_udp
# plugin: v2ray-plugin
# plugin_opts: server;tls;host=github.com
# Whether to download v2ray and xray plugin.
downloadPlugins : false
# Name of the ConfigMap with config.json configuration for shadowsocks-rust.
configMapName : " "
service :
# Change to LoadBalancer if you are behind a cloud provider like aws, gce, or tke.
type : ClusterIP
# Bind shadowsocks port port to host, i.e., we can use host:port to access shawdowsocks server.
hostPort : false
replicaCount : 1
image :
repository : ghcr.io/shadowsocks/ssserver-rust
pullPolicy : IfNotPresent
# Overrides the image tag whose default is the chart appVersion.
tag : " latest "Use carga para construir. NOTA: RAM >= 2GiB
cargo build --release Então sslocal e ssserver aparecerão em ./target/(debug|release)/ , funciona de forma semelhante aos dois binários na implementação oficial do ShadowSocks.
make install TARGET=release Então sslocal , ssserver , ssmanager e ssurl serão instalados em /usr/local/bin (variável PREFIX).
Para usuários do Windows, se você encontrou algum problema na construção, verifique e discuta no item 102.
Se você estiver construindo para sua plataforma de CPU atual (por exemplo, construir e executar em seu computador pessoal), é recomendado definir o recurso target-cpu=native para permitir que rustc gere e otimize o código para a CPU que executa o compilador.
export RUSTFLAGS= " -C target-cpu=native "Requisitos:
./build/build-release Então sslocal , ssserver , ssmanager e ssurl serão empacotados em
./build/shadowsocks-${VERSION}-stable.x86_64-unknown-linux-musl.tar.xz./build/shadowsocks-${VERSION}-stable.x86_64-pc-windows-gnu.zip Leia Cargo.toml para mais detalhes.
Gere uma senha segura para um método de criptografia específico ( aes-128-gcm no exemplo) com:
ssservice genkey -m " aes-128-gcm "Crie um arquivo de configuração do ShadowSocks. Exemplo
{
"server" : "my_server_ip" ,
"server_port" : 8388 ,
"password" : "rwQc8qPXVsRpGx3uW+Y3Lj4Y42yF9Bs0xg1pmx8/+bo=" ,
"method" : "aes-256-gcm" ,
// ONLY FOR `sslocal`
// Delete these lines if you are running `ssserver` or `ssmanager`
"local_address" : "127.0.0.1" ,
"local_port" : 1080
}Explicação detalhada do arquivo de configuração pode ser encontrada na documentação do shadowocks. (Link para o projeto original, não mais mantido!)
⚠️ Para instalações instantâneas, o arquivo de configuração provavelmente está localizado em/var/snap/shadowsocks-rust/common/etc/shadowsocks-rust/config.json(consulte #621 / #1146)
No shadowocks-rust, também temos um formato de arquivo de configuração estendido, que é capaz de definir mais de um servidor. Você também pode desabilitar servidores individuais.
{
"servers" : [
{
"server" : "127.0.0.1" ,
"server_port" : 8388 ,
"password" : "rwQc8qPXVsRpGx3uW+Y3Lj4Y42yF9Bs0xg1pmx8/+bo=" ,
"method" : "aes-256-gcm" ,
"timeout" : 7200
} ,
{
"server" : "127.0.0.1" ,
"server_port" : 8389 ,
"password" : "/dliNXn5V4jg6vBW4MnC1I8Jljg9x7vSihmk6UZpRBM=" ,
"method" : "chacha20-ietf-poly1305"
} ,
{
"disabled" : true ,
"server" : "eg.disable.me" ,
"server_port" : 8390 ,
"password" : "mGvbWWay8ueP9IHnV5F1uWGN2BRToiVCAWJmWOTLU24=" ,
"method" : "chacha20-ietf-poly1305"
}
] ,
// ONLY FOR `sslocal`
// Delete these lines if you are running `ssserver` or `ssmanager`
"local_port" : 1080 ,
"local_address" : "127.0.0.1"
} sslocal seleciona automaticamente o melhor servidor com menor latência e maior disponibilidade.
Inicie o cliente e servidor Shadowsocks com:
sslocal -c config.json
ssserver -c config.jsonSe você construir com carga:
cargo run --bin sslocal -- -c config.json
cargo run --bin ssserver -- -c config.json Liste todos os argumentos disponíveis com -h .
Inicie o cliente local com arquivo de configuração
# Read local client configuration from file
sslocal -c /path/to/shadowsocks.json # Pass all parameters via command line
sslocal -b " 127.0.0.1:1080 " -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty " --plugin " v2ray-plugin " --plugin-opts " server;tls;host=github.com "
# Pass server with SIP002 URL
sslocal -b " 127.0.0.1:1080 " --server-url " ss://[email protected]:8388/?plugin=v2ray-plugin%3Bserver%3Btls%3Bhost%3Dgithub.com "sslocal -b " 127.0.0.1:3128 " --protocol http -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty " Todos os parâmetros são iguais aos do cliente Socks5, exceto --protocol http .
# Set 127.0.0.1:8080 as the target for forwarding to
sslocal --protocol tunnel -b " 127.0.0.1:3128 " -f " 127.0.0.1:8080 " -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty "--protocol tunnel ativa o modo túnel do cliente local-f "127.0.0.1:8080 define o endereço de destino do túnelNOTA : Atualmente só suporta
iptables REDIRECT e TPROXY )pf ), como OS X 10.10+, FreeBSD, ... sslocal -b " 127.0.0.1:60080 " --protocol redir -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty " --tcp-redir " redirect " --udp-redir " tproxy " Redireciona conexões com configurações iptables para a porta que sslocal está escutando.
--protocol redir ativa o modo Redir do cliente local--tcp-redir define o modo TCP para REDIRECT (Linux)--udp-redir define o modo UDP para TPROXY (Linux)NOTA : Atualmente só suporta
Crie uma interface Tun com o nome tun0
ip tuntap add mode tun tun0
ifconfig tun0 inet 10.255.0.1 netmask 255.255.255.0 up Inicie sslocal com --protocol tun e ligue-se a tun0
sslocal --protocol tun -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty " --outbound-bind-interface lo0 --tun-interface-name tun0sslocal --protocol tun -s " [::1]:8388 " -m " aes-256-gcm " -k " hello-kitty " --outbound-bind-interface lo0 --tun-interface-address 10.255.0.1/24 Ele criará uma interface Tun com endereço 10.255.0.1 e máscara de rede 255.255.255.0 .
Baixe wintun.dll do Wintun e coloque-o na pasta com os binários executáveis do shadowocks ou no PATH do sistema.
sslocal -- protocol tun - s " [::1]:8388 " - m " aes-256-gcm " - k " hello-kitty " -- outbound - bind - interface " Ethernet 0 " -- tun - interface - name " shadowsocks " Compile-o habilitando --features "winservice" (não incluído na compilação padrão):
cargo build --release --bin " sswinservice " --features " winservice "Instale-o como um serviço do Windows (PowerShell):
New-Service - Name " shadowsocks-local-service " `
- DisplayName " Shadowsocks Local Service " `
- BinaryPathName " <Pathto>sswinservice.exe local -c <Pathto>local_config.json " Existem outras maneiras de instalar sswinservice como um serviço do Windows, por exemplo, o comando sc .
Como você deve ter notado que -BinaryPathName contém não apenas sswinservice.exe , mas também local -c local_config.json . Esses parâmetros de linha de comando serão usados como parâmetro padrão quando o serviço do Windows for iniciado. Você também pode iniciar o serviço com parâmetros customizados.
Saiba mais no documento da Microsoft.
O parâmetro sswinservice funciona exatamente da mesma forma que ssservice . Ele suporta subcomandos local , server e manager .
# Read server configuration from file
ssserver -c /path/to/shadowsocks.json
# Pass all parameters via command line
ssserver -s " [::]:8388 " -m " aes-256-gcm " -k " hello-kitty " --plugin " v2ray-plugin " --plugin-opts " server;tls;host=github.com "API de gerenciamento de vários usuários com suporte:
add - Inicia uma instância do servidorremove - Exclui uma instância de servidor existentelist - Lista todos os servidores em execução no momentoping - Lista dados estatísticos de todos os servidores NOTA: o comando stat não é suportado. Porque os servidores estão rodando no mesmo processo do próprio gerenciador.
# Start it just with --manager-address command line parameter
ssmanager --manager-address " 127.0.0.1:6100 "
# For *nix system, manager can bind to unix socket address
ssmanager --manager-address " /tmp/shadowsocks-manager.sock "
# You can also provide a configuration file
#
# `manager_address` key must be provided in the configuration file
ssmanager -c /path/to/shadowsocks.json
# Create one server by UDP
echo ' add: {"server_port":8388,"password":"hello-kitty"} ' | nc -u ' 127.0.0.1 ' ' 6100 '
# Close one server by unix socket
echo ' remove: {"server_port":8388} ' | nc -Uu ' /tmp/shadowsocks-manager.sock 'Para UI do gerenciador, verifique mais detalhes no projeto shadowocks-manager.
Configuração de exemplo:
{
// Required option
// Address that ssmanager is listening on
"manager_address" : "127.0.0.1" ,
"manager_port" : 6100 ,
// Or bind to a Unix Domain Socket
"manager_address" : "/tmp/shadowsocks-manager.sock" ,
"servers" : [
// These servers will be started automatically when ssmanager is started
] ,
// Outbound socket binds to this IP address
// For choosing different network interface on the same machine
"local_address" : "xxx.xxx.xxx.xxx" ,
// Other options that may be passed directly to new servers
} {
// LOCAL: Listen address. This is exactly the same as `locals[0]`
// SERVER: Bind address for remote sockets, mostly used for choosing interface
// Don't set it if you don't know what's this for.
"local_address" : "127.0.0.1" ,
"local_port" : 1080 ,
// Extended multiple local configuration
"locals" : [
{
// Basic configuration, a SOCKS5 local server
"local_address" : "127.0.0.1" ,
"local_port" : 1080 ,
// OPTIONAL. Setting the `mode` for this specific local server instance.
// If not set, it will derive from the outer `mode`
"mode" : "tcp_and_udp" ,
// OPTIONAL. Authentication configuration file
// Configuration file document could be found in the next section.
"socks5_auth_config_path" : "/path/to/auth.json" ,
// OPTIONAL. Instance specific ACL
"acl" : "/path/to/acl/file.acl" ,
// OPTIONAL. macOS launchd activate socket
"launchd_tcp_socket_name" : "TCPListener" ,
"launchd_udp_socket_name" : "UDPListener"
} ,
{
// SOCKS5, SOCKS4/4a local server
"protocol" : "socks" ,
// Listen address
"local_address" : "127.0.0.1" ,
"local_port" : 1081 ,
// OPTIONAL. Enables UDP relay
"mode" : "tcp_and_udp" ,
// OPTIONAL. Customizing the UDP's binding address. Depending on `mode`, if
// - TCP is enabled, then SOCKS5's UDP Association command will return this address
// - UDP is enabled, then SOCKS5's UDP server will listen to this address.
"local_udp_address" : "127.0.0.1" ,
"local_udp_port" : 2081 ,
// OPTIONAL. macOS launchd activate socket
"launchd_tcp_socket_name" : "TCPListener" ,
"launchd_udp_socket_name" : "UDPListener"
} ,
{
// Tunnel local server (feature = "local-tunnel")
"protocol" : "tunnel" ,
// Listen address
"local_address" : "127.0.0.1" ,
"local_port" : 5353 ,
