Free Ech-Worker proxy Mac client

Technology and Creation Open Source
1

EchOS —— Native macOS ECH Encrypted Proxy Client

A macOS proxy client based on the ECH (Encrypted Client Hello) encryption protocol, combining a Go core and SwiftUI interface in a single app that does it all—no need for v2rayN or ClashX. The server runs on Cloudflare Workers’ free tier, which is plenty for personal daily use.

Highlights

  • ECH anti-DPI: TLS ECH encryption with Cloudflare Workers, making it more stealthy than traditional proxies
  • Free server side: One-line deployment on Cloudflare Worker; free plan allows 100,000 requests per day
  • No need for other tools: Local proxy supports both SOCKS5 and HTTP protocols; system proxy takeover and restoration with one click
  • Three routing modes: Bypass China / blacklist / global, supports custom geosite/geoip rules
  • Multiple servers, sharing & backup: Export/import server configs for sharing; full config backup to local or WebDAV
  • Auto start & menu bar: Auto update check, one-click download, replace, and restart
  • Connectivity self-check: Pre-check configurations before starting; in-app one-click tests for ports, direct connection, and tunnel

Quick Start

  1. Deploy the server: wrangler login && TOKEN=your_token ./deploy-worker.sh (or manually paste Worker-ECH.js in the Cloudflare Dashboard)
  2. Download DMG → Drag to Applications → Right-click “Open” on first launch (unsigned, so you’ll need to bypass Gatekeeper)
  3. Enter server settings: Use your Workers domain for the server address; ECH and DoH domains include common presets
  4. Click “Start Proxy” — that’s it!

Requirements

  • macOS 13.0+; supports both Intel and Apple Silicon
  • Client is open source (MIT); for study and communication only. Do not use for commercial or illegal purposes.

light_1.1.0
light_1.1.0847×870 95.6 KB

dark_1.1.0
dark_1.1.0847×870 96.7 KB

GitHub - nerder-real/EchOS · GitHub

Polished up this Mac client based on some awesome open-source projects. Welcome to discuss and share!

Note:
If you can’t connect to the server,
change “Compatible Date” (兼容日期) to any date before 2026. As of April 2026, users reported deployment stopped working.

New update:
As requested by many, a Windows version is in development—stay tuned!

EchOS-Win
EchOS-Win752×818 45.3 KB

11 Likes
2

The Mac version by Joey mainly required command line startup, which felt inconvenient. So I polished a client that can be used independently from V2rayN, and optimized the page logic and menu bar over several versions.

3

Built-in DoH server and ECH domains;
Support for importing and exporting single or multiple shared servers;
Support for local/WebDAV backup, and more.

4

Try it and see if it works.

5

No Mac? You could give it a try anyway.

2 Likes
6

I’m an Intel chip, but I’m compatible with the M series, so you can give me a try~

7

Thanks for your support~

8

Can I use the default preferred IP? It doesn’t seem to work. Do I need to choose one myself?

9

Just enter the preferred domain name directly
youxuan.cf.090227.xyz

10

Could you compile a Windows 10 version?

1 Like
11

The project credits other authors, and there are Windows versions from two of them~
If you like it, please give it a like. I’ll look into support for other platforms.

12

No, it doesn’t work. Maybe I didn’t set up my worker correctly? I set it up manually.

13

Send me the parameter info in a private message and I’ll give it a try?

14

It doesn’t work. I tried configuring it manually, but the handshake kept failing.

15

I’ve sent you the worker address via private message. I’m also using an Intel chip.

16

I replied to you—you can just message me directly in the chat.
Open it with the third icon from the right in the top corner~

17

Thanks a lot for sharing!

1 Like
18

Okay

19

There’s an OTC big shot on TG who apparently has also made an ECH client, and it even requires an authorization code.

20

I didn’t really notice before, but I just checked and I’ve used something similar. Yours is a project, mine is just for communication~