https://github.com/enfein/mieru

mieru is a socks5 / HTTP / HTTPS proxy to bypass censorship. 見える是一款 socks5 / HTTP / HTTPS 网络代理翻墙工具。
https://github.com/enfein/mieru

anti-censorship gfw network proxy socks5 tunnel

Last synced: 14 days ago
JSON representation

mieru is a socks5 / HTTP / HTTPS proxy to bypass censorship. 見える是一款 socks5 / HTTP / HTTPS 网络代理翻墙工具。

• Host: GitHub
• URL: https://github.com/enfein/mieru
• Owner: enfein
• License: gpl-3.0
• Created: 2021-09-25T04:54:02.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-23T04:30:38.000Z (6 months ago)
• Last Synced: 2024-05-23T05:32:38.910Z (6 months ago)
• Topics: anti-censorship, gfw, network, proxy, socks5, tunnel
• Language: Go
• Homepage:
• Size: 1.03 MB
• Stars: 931
• Watchers: 13
• Forks: 122
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: docs/security.md

Awesome Lists containing this project

README

        
# 見える / mieru

[![Build Status](https://github.com/enfein/mieru/actions/workflows/ci.yaml/badge.svg)](https://github.com/enfein/mieru/actions/workflows/ci.yaml)

[![Releases](https://img.shields.io/github/release/enfein/mieru/all.svg?style=flat)](https://github.com/enfein/mieru/releases)

[![Downloads](https://img.shields.io/github/downloads/enfein/mieru/total.svg?style=flat)](https://github.com/enfein/mieru/releases)

[![LICENSE](https://img.shields.io/github/license/enfein/mieru.svg?style=flat)](./LICENSE)

[中文文档](./README.zh_CN.md)

mieru is a secure, hard to classify, hard to probe, TCP or UDP protocol-based socks5 / HTTP / HTTPS network proxy software.

The mieru proxy software suite consists of two parts, a client software called mieru, and a proxy server software called mita.

## Protocol

The principle of mieru is similar to shadowsocks / v2ray etc. It creates an encrypted channel between the client and the proxy server outside the firewall. GFW cannot decrypt the encrypted transmission and cannot determine the destination you end up visiting, so it has no choice but to let you go.

For an explanation of the mieru protocol, see [mieru Proxy Protocol](./docs/protocol.md).

## Features

1. Provides socks5, HTTP, and HTTPS proxy interfaces.

1. Does not use TLS protocol. No need to register a domain name or set up a fake website.

1. Uses the high-strength XChaCha20-Poly1305 encryption algorithm that generates encryption keys based on username, password and system time.

1. Utilizes random padding and replay attack detection to prevent GFW from detecting the mieru service.

1. Supports multiple users sharing a single proxy server.

1. Supports both IPv4 and IPv6.

1. The server software supports socks5 outbound (proxy chain).

1. The client software supports Windows, Mac OS, Linux and Android. Android clients include

   - [NekoBox](https://github.com/MatsuriDayo/NekoBoxForAndroid) with [mieru plugin](https://github.com/enfein/NekoBoxPlugins).

   - [Exclave](https://github.com/dyhkwong/Exclave) with [mieru plugin](https://github.com/dyhkwong/Exclave/releases?q=mieru-plugin).

   - [husi](https://github.com/xchacha20-poly1305/husi) with [mieru plugin](https://github.com/xchacha20-poly1305/husi/releases?q=plugin-mieru).

1. If you need advanced features like global proxy or customized routing rules, you can use mieru as the backend of a proxy platform such as [Xray](https://github.com/XTLS/Xray-core) and [sing-box](https://github.com/SagerNet/sing-box).

## User Guide

1. [Server Installation & Configuration](./docs/server-install.md)

1. [Client Installation & Configuration](./docs/client-install.md)

1. [Client Installation & Configuration - OpenWrt](./docs/client-install-openwrt.md)

1. [Maintenance & Troubleshooting](./docs/operation.md)

1. [Security Guide](./docs/security.md)

1. [Compilation](./docs/compile.md)

## Share

If you think this software is helpful, please share to your friends. Thanks!

## Contact Us

Use GitHub issue.

## License

Use of this software is subject to the GPL-3 license.