Skip to content

Chilledheart/yass

Repository files navigation

Yet Another Shadow Socket

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

GitHub release (latest SemVer) aur yass-proxy aur yass-proxy-cli homebrew cask

yass is client-server model based and efficient forward proxy supporting http/socks4/socks4a/socks5 protocol. The server side is experimental.

Features

  • Better scaled, less memory consumption and CPU cycles.
  • Easier to maintain and adopt new features.
  • Safe memory layout.

More Information refers to wiki.

Usages

Prebuilt binaries

via homebrew: brew install --cask yass

View more at release page

Status of Package Store

Visit wiki's Status of Package Store

Build from Source

Take a look at BUILDING.md for more instructions.

Screenshots

Visit wiki's Supported Operating System

Usages

Visit wiki's Usages and Server Usage.

Important notes before use

Post Quantum Kyber Support

Starting with release 1.9.5 and 1.8.7, Post Quantum Kyber Support is added on all of supported Platforms.You can enable it via Options Dialog(non-iOS)/Settings(iOS) manually.

This option will be enabled by default in the future (M128).

NaïveProxy Protocol Support

It refers to http2 cipher as NaïveProxy-compatible protocol support.

Fix disk space occupation issue for mobile users

Starting with release 1.9.2 and 1.8.5, it will no longer keep log file and will not occupy extra disk space for Android/iOS/HarmonyOS client.

Android vpn service support

Android releases from 1.5.24 are signed and have been updated to add VpnService support.

iOS packet tunnel support

iOS releases from 1.5.22 have fixed memory pressure crashes and have been updated to add Packet tunnel support.

macOS packet tunnel support (M1/M2/M3 only)

For Apple Silicon macOS Users such as M1/M2/M3, you can also install Packet tunnel version via TestFlight.

Notarized macOS releases

macOS releases from 1.5.19 are notarized. Please note the dmg suffixed with -unsigned is not.

MinGW Build (alias Window Build)

MinGW 64-bit releases from 1.6.5 and 1.7.1 no longer require Visual C++ 2010 Runtime.

For Windows XP Users, please make Visual C++ 2010 Runtime installed and use 32-bit releases. Depending the your system's architecture, use x86 installer or x64 installer.

Supplementary support for missing ISRG (Let's Encrypt Root) on some Windows 11 Installation and Android prior to 7.1.1

Releases from 1.5.25 and 1.6.4 fixes an issue that ISRG Root 1 and ISRG Root 2 might be missing in some machines and that causes troubles.

MSVC Build(previous Windows Build) prebuilt binaries removed

Due to the fact of possibly violating GPL license by linking static Visual C++ Runtime or distribute the CRT dll files we are still supporting MSVC builds, but the prebuilt binaries are removed from the release page. You can build MSVC binaries by yourself or switch to MinGW builds.

Sponsor Me

Please visit the pages site.

License

It is licensed with GPLv2.

Build Status

Compiler Compatibility CircleCI Cirrus CI

MinGW Build Linux Build macOS Build

Android Build iOS Build

OpenWRT Build FreeBSD Build RPM Build DEB Build

MSVC Build Old MinGW Build