https://github.com/shadowsocks/ShadowsocksX-NG

Next Generation of ShadowsocksX
https://github.com/shadowsocks/ShadowsocksX-NG

kcptun macos shadowsocks shadowsocksx-ng swift v2ray-plugin

Last synced: about 1 month ago
JSON representation

Next Generation of ShadowsocksX

• Host: GitHub
• URL: https://github.com/shadowsocks/ShadowsocksX-NG
• Owner: shadowsocks
• License: gpl-3.0
• Created: 2016-06-10T11:49:00.000Z (over 8 years ago)
• Default Branch: develop
• Last Pushed: 2023-03-29T02:14:51.000Z (over 1 year ago)
• Last Synced: 2024-06-25T04:57:06.465Z (6 months ago)
• Topics: kcptun, macos, shadowsocks, shadowsocksx-ng, swift, v2ray-plugin
• Language: Swift
• Homepage:
• Size: 48.3 MB
• Stars: 32,242
• Watchers: 946
• Forks: 7,962
• Open Issues: 310
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• fucking-awesome-swift - ShadowsocksX-NG - A fast tunnel proxy that helps you bypass firewalls. (Libs / Network)
• awesome-notes - ShadowsocksX-NG
• awesome-pose - <img src="https://cdn.jsdelivr.net/gh/uyaki/pic-cloud/logo/svg/mac.svg" width="16" heigth="16"></img> - cloud/logo/svg/win.svg" width="16" heigth="16"></img>](https://github.com/shadowsocks/shadowsocks-windows)| (💻 软件)
• open-source-mac-os-apps - ShadowsocksX-NG - Next Generation of ShadowsocksX. ![swift_icon] (Applications / VPN & Proxy)
• awesome-swift - ShadowsocksX-NG - A fast tunnel proxy that helps you bypass firewalls. (Libs / Network)
• awesome - ShadowsocksX-NG
• awesome-swift - ShadowsocksX-NG - Next Generation of ShadowsocksX ` 📝 a day ago ` (Network [🔝](#readme))
• awesome-swift - ShadowsocksX-NG - A fast tunnel proxy that helps you bypass firewalls. (Libs / Network)
• open-source-mac-os-apps - ShadowsocksX-NG - Next Generation of ShadowsocksX. ![swift_icon] (Applications / VPN & Proxy)
• awesome-hacking-lists - shadowsocks/ShadowsocksX-NG - Next Generation of ShadowsocksX (Swift)
• favorite-link - Next Generation of ShadowsocksX。
• my-awesome - shadowsocks/ShadowsocksX-NG - ng,swift,v2ray-plugin pushed_at:2024-10 star:32.5k fork:7.9k Next Generation of ShadowsocksX (Swift)
• StarryDivineSky - shadowsocks/ShadowsocksX-NG
• awesome-swift-macos-apps - ShadowsocksX-NG - NG?label=" /> - Next Generation of ShadowsocksX. (VPN & Proxy / Text)
• awesome-swift-macos-apps - ShadowsocksX-NG - Next Generation of ShadowsocksX. (VPN & Proxy / Text)
• awesome - shadowsocks/ShadowsocksX-NG - Next Generation of ShadowsocksX (Swift)
• awesome - shadowsocks/ShadowsocksX-NG - Next Generation of ShadowsocksX (Swift)

README

        
# ShadowsocksX-NG

[Download](https://github.com/shadowsocks/ShadowsocksX-NG/releases/latest)

[![Actions Status](https://github.com/shadowsocks/ShadowsocksX-NG/workflows/CI/badge.svg)](https://github.com/shadowsocks/ShadowsocksX-NG/actions)

Next Generation of [ShadowsocksX](https://github.com/shadowsocks/shadowsocks-iOS)

## Why a new implementation?

It's hard to maintain the original implementation as there is too much unused code in it.

It also embeds the `ss-local` source code. It's crazy to maintain dependencies of `ss-local`.

So it's hard to update the `ss-local` version.

Now I just copied the `ss-local` from Homebrew. Run `ss-local` executable as a Launch Agent in the background.

So there is only some source code related to GUI left.

Then I have rewrited the GUI code in Swift.

## Requirements

### Running

macOS 10.12+

### Building

- Xcode 12.5.1+

- CocoaPods 1.10.1+

## Download

From [here](https://github.com/shadowsocks/ShadowsocksX-NG/releases/)

## Features

- `ss-local` from shadowsocks-libev 3.2.5.

- Support SIP003 plugins. Embed `kcptun`,  `simple-obfs` and `v2ray-plugin`.

- Could update PAC by download GFW List from GitHub.

- Share your server profiles by qrcode or url.

- Import server profile urls from pasteboard.

- Import server profile by scan QRCode on screen.

- Custom rules for PAC.

- Support for [AEAD Ciphers](https://shadowsocks.org/en/spec/AEAD-Ciphers.html)

- HTTP Proxy by [privoxy](http://www.privoxy.org/)

## Difference from original ShadowsocksX

`ss-local` is run as a background service through launchd, not as an in-app process.

So after you quit the app, the `ss-local` might be still running.

Added a manual mode which won't configure the system proxy settings,

so that you could configure your apps to use the SOCKS5 proxy manually.

## Contributing

Contributions must be available on a separately named branch based on the latest version of the main branch `develop`.

ref: [GitFlow](http://nvie.com/posts/a-successful-git-branching-model/)

## License

The project is released under the terms of the GPLv3.