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.
Report if you find any bug in this product
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 M131's Release (1.15.x) will become Stable Release since Nov 12, 2024.
- Latest M130's Release (1.14.x) has become Stable Release since Oct 15, 2024 (Extended Support).
- Latest M129's Release (1.13.x) has become Stable Release since Sep 17, 2024.
- Latest M128's Release (1.12.x) has become Stable Release since Aug 20, 2024 (Extended Support).
- Latest M127's Release (1.11.x) has become Stable Release since Jul 23, 2024.
- Latest M126's Release (1.10.x) has become Stable Release since Jun 11, 2024 (Extended Support).
- Latest M125's Release (1.9.x) has become Stable Release since May 14, 2024.
- Latest M124's Release (1.8.x) has become Stable Release since Apr 16, 2024 (Extended Support).
- Latest M123's Release (1.7.x) has become Stable Release since Mar 19, 2024.
- Latest M122's Release (1.6.x) has become Stable Release since Feb 20, 2024 (Extended Support).
- Latest M121's Release (1.5.x) has become Stable Release since Jan 23, 2024.
Prebuilt binaries (Supported platforms)
- 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)
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 (static build, no madvise support required)
- CLI(musl) download tgz for amd64 or download tgz for i386 or download tgz for aarch64 or download tgz for armhf (static build, no madvise support required)
- Flatpak for Linux (Qt6) download flatpak for x86_64 only.
Flathub: available at latest version (Qt5, report if you need Qt6 version), require Flatpak installed).
Report here if you need new features
Prebuilt binaries (Supported legacy platforms)
- Legacy Android download 64-bit apk or download 32-bit apk (require Android 7.0 or above)
- Legacy iOS Continue to accept TestFlight invitation (require TestFlight from AppStore, and iOS 13.0 or above)
- Legacy 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)
- Legacy macOS download intel dmg or download apple silicon dmg (require macOS 10.14 or above)
See Supporteded Operating System for more.
Report here if you need to run outside the OS in the table
Special Note: for legacy supported platforms, bugs will be fixed ASAP while feature request is a time-consuming task and it is expected that it would be delayed in a proper and unlimited period.
Contribute your translation (i18n)
Please submit translations via Transifex
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.
Report here if you want to add new language outside current layout
Build from Source
Take a look at build instructions and packaging instructions.
Report here if you want to build or package in a new distribution/platform
Highlight Features
TLS-Compatible Protocol Support
Cipher http over TLS are compatible.
If you need custom Certificate Authority support in GUI or add other TLS-related features, report here.
Post Quantum key-agreements for TLS 1.3
ML-KEM Post Quantum key-agreements (not enabled by default) for TLS 1.3 is supported on all platforms in place of obsolete Kyber768 hybrid key-agreements.
See Protecting Chrome Traffic with Hybrid Kyber KEM for more.
Socks-Compatible Protocol Support
Cipher socks4 and socks5 are compatible.
Shadowsocket-Compatible Protocol Support
Ciphers released ahead of 2022 are compatible.
NaïveProxy-Compatible Protocol Support
Cipher http2 and https are compatible.
See NaïveProxy's project homepage for support.
Usages
Standard Usages
Visit wiki's Usages.
Report here if you want to add new client-side optimization/usage
Server side support (mostly 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.
Report here if you want to add new server-side optimization/cooperation
Debug Guide
Start from wiki's Guide
Build Status
