whatisgithub

What is easysni?

macan-dev/easysni — explained in plain English

Analysis updated 2026-05-18

45GoAudience · generalComplexity · 3/5Setup · easy

In one sentence

A desktop tool that helps bypass internet censorship by disguising blocked website connections as allowed ones.

Mindmap

mindmap
  root((repo))
    What it does
      Bypasses DPI blocking
      SNI manipulation
      Browser control panel
    Tech stack
      Go
      xray
      sing-box
      Cloudflare Worker
    Use cases
      SOCKS5 proxy
      System wide VPN
      Speed tests
    Advanced
      Google Tunnel
      Subscription import
    Audience
      General users
      Censorship researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a local control panel to manage proxy connections that route around network filtering.

USE CASE 2

Use the SNI trick to reach a blocked site while appearing to connect to an allowed hostname.

USE CASE 3

Import subscription feeds and test proxy connection speeds from a built-in library.

USE CASE 4

Deploy the Google Tunnel feature to disguise traffic as ordinary Google communication.

What is it built with?

Goxraysing-boxCloudflare Worker

How does it compare?

macan-dev/easysnisaiyam1814/kiacasymptote-labs/agent-beacon
Stars454544
LanguageGoGoGo
Setup difficultyeasymoderatehard
Complexity3/53/54/5
Audiencegeneralops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Ships as a single executable for Windows, macOS, and Linux with no installation required.

So what is it?

EasySNI (published under the name V2RayEz) is a desktop tool that helps users get around internet censorship systems. It is a single executable file that opens a control panel in your browser when you run it. From that panel, you can manage several methods for routing your internet traffic past filters. The README is available in both English and Persian. The core problem it solves is something called DPI blocking, where network filters read information in your internet connection to identify and block certain websites. V2RayEz works around this by manipulating a piece of that connection data called the SNI, which is a hostname sent in plain text during the setup of an encrypted connection. The tool connects to the real destination but writes a different, permitted hostname into that field so the filter sees an allowed address. Beyond the SNI trick, the app also includes support for running two widely-used proxy engines called xray and sing-box. These can operate either as a SOCKS5 proxy (which specific apps can be configured to use) or as a full system-level VPN that routes all traffic. A built-in configuration library lets you store and manage proxy connection details, import subscription feeds, and run speed tests. A more advanced feature called the Google Tunnel routes your traffic through a Google Apps Script you deploy yourself, plus a Cloudflare Worker, so that from the network's perspective the traffic looks like ordinary communication with Google. The app is written in Go and ships as a single file for Windows, macOS, and Linux. No installation is required beyond downloading and running it. The README notes it is intended for education, testing, and research, and that users are responsible for compliance with their local laws.

Copy-paste prompts

Prompt 1
Explain how SNI manipulation helps get around DPI-based internet blocking.
Prompt 2
Walk me through setting up EasySNI as a system-level VPN versus a SOCKS5 proxy.
Prompt 3
Show me how to deploy the Google Tunnel feature using Google Apps Script and Cloudflare Workers.
Prompt 4
Summarize the legal and educational disclaimers mentioned in this project's README.

Frequently asked questions

What is easysni?

A desktop tool that helps bypass internet censorship by disguising blocked website connections as allowed ones.

What language is easysni written in?

Mainly Go. The stack also includes Go, xray, sing-box.

How hard is easysni to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is easysni for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.