shadowsocks rust
1.21.2
Dies ist eine Portierung von Shadowsocks.
Shadowsocks ist ein schneller Tunnel-Proxy, der Ihnen hilft, Firewalls zu umgehen.
| Bibliothek | Beschreibung |
|---|---|
| Schattensocken | Shadowsocks-Kernprotokoll |
| Shadowsocks-Service | Dienstleistungen zum Servieren von Shadowsocks |
| Schattensocken-Rost | Binärdateien, die gängige Shadowsocks-Dienste ausführen |
Verwandte Projekte:
sslocal mit GTK, Diskussionsslocal , Diskussion hickory-dns – Verwendet hickory-resolver als DNS-Resolver anstelle des integrierten tokio -Resolvers.
local-http – Ermöglicht die Verwendung des HTTP-Protokolls für sslocal
local-http-native-tls – Unterstützt HTTPS mit native-tls
local-http-rustls – Unterstützt HTTPS mit rustls
local-tunnel – Ermöglicht die Verwendung des Tunnelprotokolls für sslocal
local-socks4 – Ermöglicht die Verwendung des SOCKS4/4a-Protokolls für sslocal
local-redir – Ermöglicht die Verwendung des Redir-Protokolls (transparenter Proxy) für sslocal
local-dns – Ermöglicht die Verwendung des DNS-Protokolls für sslocal und dient als Proxy für Abfragen an lokale oder Remote-DNS-Server mithilfe von ACL-Regeln
local-fake-dns – FakeDNS, das jeder einzelnen Anfrage eine IP-Adresse aus einem bestimmten IP-Pool zuweist
local-tun – TUN-Schnittstellenunterstützung für sslocal
local-online-config – SIP008 Online-Konfigurationsbereitstellung
stream-cipher – Veraltete Stream-Chiffren aktivieren. WARNUNG: Stream-Chiffren sind UNSICHER!
aead-cipher-extra – Aktivieren Sie nicht standardmäßige AEAD-Chiffren
aead-cipher-2022 – AEAD-2022-Chiffren aktivieren (SIP022)
aead-cipher-2022-extra – AEAD-2022-Zusatzchiffren aktivieren (nicht standardmäßige Chiffren)
Dieses Projekt verwendet die Systemspeicherzuweisung (libc) (Rusts Standard). Sie können damit aber auch andere bekannte Allokatoren nach Funktionen verwenden:
jemalloc – Verwendet jemalloc als globale Speicherzuweisungmimalloc – Verwendet mi-malloc als globale Speicherzuweisungtcmalloc – Verwendet TCMalloc als globalen Speicherzuweiser. Es wird standardmäßig versucht, systemweites tcmalloc zu verknüpfen, wobei „vendored from source“ mit tcmalloc-vendored verwendet wird.snmalloc – Verwendet snmalloc als globale Speicherzuweisungrpmalloc – Verwendet rpmalloc als globalen SpeicherzuweiserVon crates.io installieren:
# Install from crates.io
cargo install shadowsocks-rust dann finden Sie sslocal und ssserver in $CARGO_HOME/bin .
Für macOS und Linux können Sie es mit Homebrew installieren:
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.serviceLaden Sie hier den statisch verknüpften Build herunter.
build-windows : Build für x86_64-pc-windows-msvcbuild-linux : Build für x86_64-unknown-linux-gnu , Debian 9 (Stretch), GLIBC 2.18build-docker : Build für x86_64-unknown-linux-musl , x86_64-pc-windows-gnu , ... (statisch verknüpft) Dieses Projekt stellte Docker-Images für die Architekturen linux/i386 und linux/amd64 sowie linux/arm64/v8 bereit.
⚠️ Docker-Container haben standardmäßig keinen Zugriff auf IPv6 : Stellen Sie sicher, dass Sie die IPv6-Route im Client deaktivieren oder den IPv6-Zugriff auf Docker-Container aktivieren.
Docker ruft das Image der entsprechenden Architektur aus unseren GitHub-Paketen ab.
docker pull ghcr.io/shadowsocks/sslocal-rust:latest
docker pull ghcr.io/shadowsocks/ssserver-rust:latestWenn Sie das Docker-Image selbst erstellen möchten, müssen Sie BuildX verwenden.
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 . Sie müssen die Konfigurationsdatei in den Container einbinden und eine externe Portzuordnung erstellen, damit der Container eine Verbindung herstellen kann.
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:latestDieses Projekt stellte Yaml-Manifeste für die Bereitstellung auf Kubernetes bereit.
Sie können den k8s-Dienst nutzen, um Datenverkehr nach außen freizugeben, z. B. LoadBalancer oder NodePort, der im Vergleich zu festen Hosts oder Ports feiner granuliert ist.
Für einen interessanteren Anwendungsfall können Sie einen Ingress (Istio, Nginx usw.) verwenden, der den passenden Datenverkehr zusammen mit dem echten Webdienst an Shadowsocks weiterleitet.
kubectl kubectl apply -f https://github.com/shadowsocks/shadowsocks-rust/raw/master/k8s/shadowsocks-rust.yaml
Sie können die Konfiguration ändern, indem Sie die ConfigMap mit dem Namen shadowsocks-rust bearbeiten.
Für eine detailliertere Steuerung verwenden Sie helm .
helm helm install my-release k8s/chart -f my-values.yaml
Nachfolgend finden Sie die allgemeinen Standardwerte, die Sie ändern können:
# 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 "Verwenden Sie Fracht zum Bauen. HINWEIS: RAM >= 2 GB
cargo build --release Dann erscheinen sslocal und ssserver in ./target/(debug|release)/ , es funktioniert ähnlich wie die beiden Binärdateien in der offiziellen ShadowSocks-Implementierung.
make install TARGET=release Dann werden sslocal , ssserver , ssmanager und ssurl in /usr/local/bin (Variable PREFIX) installiert.
Für Windows-Benutzer: Wenn Sie beim Erstellen auf ein Problem gestoßen sind, überprüfen und besprechen Sie es in Nr. 102.
Wenn Sie für Ihre aktuelle CPU-Plattform bauen (z. B. auf Ihrem PC erstellen und ausführen), empfiehlt es sich, die Funktion target-cpu=native festzulegen, damit rustc Code für die CPU, auf der der Compiler läuft, generieren und optimieren kann.
export RUSTFLAGS= " -C target-cpu=native "Anforderungen:
./build/build-release Dann werden sslocal , ssserver , ssmanager und ssurl eingepackt
./build/shadowsocks-${VERSION}-stable.x86_64-unknown-linux-musl.tar.xz./build/shadowsocks-${VERSION}-stable.x86_64-pc-windows-gnu.zip Weitere Informationen finden Sie in Cargo.toml .
Generieren Sie ein sicheres Passwort für eine bestimmte Verschlüsselungsmethode (im Beispiel aes-128-gcm ) mit:
ssservice genkey -m " aes-128-gcm "Erstellen Sie eine ShadowSocks-Konfigurationsdatei. Beispiel
{
"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
}Eine ausführliche Erläuterung der Konfigurationsdatei finden Sie in der Dokumentation von Shadowsocks. (Link zum Originalprojekt, wird nicht mehr gepflegt!)
⚠️ Bei Snap-Installationen befindet sich die Konfigurationsdatei höchstwahrscheinlich in/var/snap/shadowsocks-rust/common/etc/shadowsocks-rust/config.json(siehe #621 / #1146)
In Shadowsocks-Rust verfügen wir außerdem über ein erweitertes Konfigurationsdateiformat, das mehr als einen Server definieren kann. Sie können auch einzelne Server deaktivieren.
{
"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 wählt automatisch den besten Server mit der niedrigsten Latenz und der höchsten Verfügbarkeit aus.
Starten Sie den Shadowsocks-Client und -Server mit:
sslocal -c config.json
ssserver -c config.jsonWenn Sie es mit Fracht bauen:
cargo run --bin sslocal -- -c config.json
cargo run --bin ssserver -- -c config.json Listen Sie alle verfügbaren Argumente mit -h auf.
Starten Sie den lokalen Client mit der Konfigurationsdatei
# 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 " Alle Parameter sind mit denen des Socks5-Clients identisch, außer --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 aktiviert den lokalen Client-Tunnelmodus-f "127.0.0.1:8080 legt die Tunnelzieladresse festHINWEIS : Derzeit wird nur unterstützt
iptables Zielen REDIRECT und TPROXY )pf ), wie 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 " Leitet Verbindungen mit iptables -Konfigurationen an den Port um, den sslocal überwacht.
--protocol redir aktiviert den lokalen Client-Redir-Modus--tcp-redir setzt den TCP-Modus auf REDIRECT (Linux)--udp-redir setzt den UDP-Modus auf TPROXY (Linux)HINWEIS : Derzeit wird nur unterstützt
Erstellen Sie eine Tun-Schnittstelle mit dem Namen tun0
ip tuntap add mode tun tun0
ifconfig tun0 inet 10.255.0.1 netmask 255.255.255.0 up Starten Sie sslocal mit --protocol tun und binden Sie es an 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 Es wird eine Tun-Schnittstelle mit der Adresse 10.255.0.1 und der Netzmaske 255.255.255.0 erstellt.
Laden Sie wintun.dll von Wintun herunter und platzieren Sie es im Ordner mit den ausführbaren Binärdateien von Shadowsocks oder im Systempfad.
sslocal -- protocol tun - s " [::1]:8388 " - m " aes-256-gcm " - k " hello-kitty " -- outbound - bind - interface " Ethernet 0 " -- tun - interface - name " shadowsocks " Kompilieren Sie es, indem Sie --features "winservice" aktivieren (nicht im Standard-Build enthalten):
cargo build --release --bin " sswinservice " --features " winservice "Installieren Sie es als Windows-Dienst (PowerShell):
New-Service - Name " shadowsocks-local-service " `
- DisplayName " Shadowsocks Local Service " `
- BinaryPathName " <Pathto>sswinservice.exe local -c <Pathto>local_config.json " Es gibt andere Möglichkeiten, sswinservice als Windows-Dienst zu installieren, beispielsweise den sc -Befehl.
Wie Sie vielleicht bemerkt haben, enthält -BinaryPathName nicht nur sswinservice.exe , sondern auch local -c local_config.json . Diese Befehlszeilenparameter werden als Standardparameter verwendet, wenn der Windows-Dienst gestartet wird. Sie können den Dienst auch mit benutzerdefinierten Parametern starten.
Erfahren Sie mehr im Dokument von Microsoft.
Der Parameter von sswinservice funktioniert genauso wie ssservice . Es unterstützt local , server und manager Unterbefehle.
# 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 "Unterstützte API zum Verwalten mehrerer Benutzer:
add – Startet eine Serverinstanzremove – Löscht eine vorhandene Serverinstanzlist – Listet alle derzeit laufenden Server aufping – Listet die Statistikdaten aller Server auf HINWEIS: Der Befehl stat wird nicht unterstützt. Weil Server im selben Prozess wie der Manager selbst ausgeführt werden.
# 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 'Weitere Details zur Manager-Benutzeroberfläche finden Sie im Projekt „shadowsocks-manager“.
Beispielkonfiguration:
{
// 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 ,
