Awesome
Yet Another Shadow Socket
yass is an efficient forward proxy client supporting http/socks4/socks4a/socks5/socks5h protocol running on PC and mobile devices.
License
Releases
Because we are reusing chromium's network stack directly, we are following chromium's release schedule and delivering new versions based on its beta branch.
- Latest M129's Release (1.13.x) will become Stable since Sep 17, 2024.
- Latest M128's Release (1.12.x) has become Stable since Aug 20, 2024 (Extended Support).
- Latest M127's Release (1.11.x) has become Stable since Jul 23, 2024
- Latest M126's Release (1.10.x) has become Stable since Jun 11, 2024 (Extended Support)
- Latest M125's Release (1.9.x) has become Stable since May 14, 2024
- Latest M124's Release (1.8.x) has become Stable since Apr 16, 2024 (Extended Support)
- Latest M123's Release (1.7.x) has become Stable since Mar 19, 2024
- Latest M122's Release (1.6.x) has become Stable since Feb 20, 2024 (Extended Support)
- Latest M121's Release (1.5.x) has become Stable since Jan 23, 2024
Prebuilt binaries (Linux)
-
GTK3 download rpm or download deb (minimum requirement: CentOS 8 or Ubuntu 16.04)
-
Qt5 download rpm or download deb (minimum requirement: CentOS 8 or Ubuntu 16.04)
-
GTK4 download rpm or download deb (minimum requirement: openSUSE Leap 15.5, CentOS 9 or Ubuntu 22.04)
-
Qt6 download rpm or download deb (minimum requirement: openSUSE Leap 15.5, CentOS 9 with epel or Ubuntu 22.04)
-
GTK4 (Archlinux) download binary pkg file (PGP Keys:
sudo pacman -S archlinuxcn-keyring
)
See Status of Package Store for more.
- CLI download tgz for amd64 or download tgz for i386 or download tgz for arm64 (require glibc >= 2.25)
- CLI download tgz for loongarch64 (require glibc >= 2.38, new world)
- CLI download tgz for riscv64 or download tgz for riscv32 (require glibc >= 2.36)
- CLI(openwrt) download tgz for amd64 or download tgz for i486 or download tgz for aarch64 generic (require openwrt >= 23.05.3)
- CLI(musl) download tgz for amd64 or download tgz for i386 (require musl >= 1.2.5)
Prebuilt binaries (Other platforms)
- Android download 64-bit apk or download 32-bit apk (require Android 7.0 or above)
- iOS Continue to accept TestFlight invitation (require TestFlight from AppStore, and iOS 13.0 or above)
- Windows download 64-bit installer (require KB2999226 on windows 7/8/8.1) or download 32-bit installer (require vc 2010 runtime on windows xp sp3) or download arm64 installer (require windows 10/11)
- macOS download intel dmg or download apple silicon dmg (require macOS 10.14 or above)
via Homebrew:
brew install --formula yass-cli
via Homebrew Cask:brew install --cask yass
- Flatpak for Linux (Qt5) download flatpak (unsandboxed edition) for x86_64 machine only.
via Flathub:
flatpak install --user io.github.chilledheart.yass
(recommended, signed and sandboxed) for both of x86_64 and aarch64 machines
See Supporteded Operating System for more.
Contribute your translation (i18n)
Please submit translations via Transifex: https://app.transifex.com/yetanothershadowsocket/yetanothershadowsocket
Steps:
- Create a free account on Transifex (https://www.transifex.com/).
- Send a request to join the language translation.
- After accepted by the project maintainer, then you can translate online.
Build from Source
Take a look at build instructions and packaging instructions.
Highlight Features
Post Quantum Kyber Support
Post Quantum Kyber Support (not enabled by default) is added on all of supported Platforms.
See Protecting Chrome Traffic with Hybrid Kyber KEM for more.
NaïveProxy-Compatible Protocol Support
Cipher http2 and https are NaïveProxy-compatible.
See NaïveProxy's project homepage for support.
Android/iOS/macOS (M1/M2/M3/M4 only) comes with VPN Service support
Mobile users including macOS (M1/M2/M3/M4) machines can use yass as VPN Service more than pure Global Proxy Client.
TBD: Spliting Tunnel Support (#954)
More Usages
Visit wiki's Usages.
Server side support (outside this project)
See Setup forwardproxy caddy service for more.
See Window sizes for large bandwidth for more.
See Use BBR Congestion Control for more.
See ChatGPT capable caddy Server for more.
Extra Features (Command Line only)
Use custom CA certificate file
Pass --certificate_chain_file file
to command line.
Use custom certificate chain provided by file to verify server's certificate.
Sponsor Me
Please visit the pages site.