Files
Archive/yass/README.md
2024-03-26 19:28:40 +01:00

8.3 KiB

Yet Another Shadow Socket

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

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

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 and NaïveProxy-compatible protocol support.

Usages

Prebuilt binaries

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

NaïveProxy Protocol Support

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

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