Skip to content

hukeyue/yass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6,581 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Yet Another Shadow Socket

YASS is an efficient forward proxy client supporting http/socks4/socks4a/socks5/socks5h protocol running on PC and mobile devices.

Releases

GitHub release (latest SemVer) Language: C++ GitHub release (latest by SemVer)

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.

PLANNED BUILDS:

  • M150's Release (1.26.x) will become Stable Release from Jun 30, 2026 (Extended Support).
  • M149's Release (1.25.x) will become Stable Release from Jun 2, 2026.

LANDED BUILDS(signed against new certificates):

  • M148's Release (1.24.x) will become Stable Release from May 5, 2026 (Extended Support).
  • M147's Release (1.23.x) will become Stable Release from Apr 7, 2026.
  • M146's Release (1.22.x) has become Stable Release from Mar 10, 2026 (Extended Support).
  • M145's Release (1.21.x) has become Stable Release from Feb 10, 2025.
  • M144's Release (1.20.x) has become Stable Release from Jan 13, 2026 (Extended Support).
  • M143's Release (1.19.x) has become Stable Release from Dec 16, 2025.
  • M142's Release (1.18.x) has become Stable Release from Oct 28, 2025 (Extended Support).
  • M141's Release (1.17.x) has become Stable Release from Sep 30, 2025.
  • REFRESHED M132's Release (1.16.x) has become Stable Release since Jan 14, 2025 (Extended Support).

Due to the change of certificate, re-installation YASS on Android Phone and macOS prebuilts is necessary.

From 1.20.4 and 1.17.5, Command Line binaries (similar to naiveproxy binary) for Android and Windows are provided.

BAKED BUILDS(signed with baked certificates):

Prebuilt binaries (Supported platforms)

please download and install yass-common package (list below) as well

aur yass-proxy-gtk3 aur yass-proxy-qt5 aur yass-proxy aur yass-proxy-qt6

See Status of Package Store for more.

aur yass-proxy-cli

Flathub: available at latest version (Qt5, report if you need Qt6 version), require Flatpak installed).

Flathub Version Flathub Downloads

Prebuilt binaries (Supported legacy platforms)

New iOS Beta Build is provided periodically (1.20.4 FOR NOW).

See Supporteded Operating System for more.

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:

  1. Create a free account on Transifex (https://www.transifex.com/).
  2. Send a request to join the language translation.
  3. 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

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.

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.

Debug Guide

Start from wiki's Guide

Build Status

CircleCI Cirrus CI

MSVC+VS2022 Build MinGW Build Linux Build macOS Build

Android Build iOS Build

OpenWRT Build FreeBSD Build RPM Build DEB Build Flatpak Build

MSVC+XPSP3 Build MSVC+VS2026 Build Clang Tidy

Report here if you want to connect to new CI infrastructure

About

NASTY (plugin) client written in C++. Very Suitable for testing kinds of GUI frameworks or I/O-bound operating systems. TL'DR daemon mode is deprecated.

Resources

License

Stars

Watchers

Forks

Contributors