yass is an efficient forward proxy client supporting http/socks4/socks4a/socks5/socks5h protocol running on PC and mobile devices.
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
-
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)
- 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.
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.
Take a look at build instructions and packaging instructions.
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.
Cipher http2 and https are NaïveProxy-compatible.
See NaïveProxy's project homepage for 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)
Visit wiki's Usages.
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.
Pass --certificate_chain_file file
to command line.
Use custom certificate chain provided by file to verify server's certificate.
Please visit the pages site.