trojan README

The project's README from github.com/trojan-gfw/trojan. As one markdown file: README.md.

trojan

Build Status

An unidentifiable mechanism that helps you bypass GFW.

Trojan features multiple protocols over TLS to avoid both active/passive detections and ISP QoS limitations.

Trojan is not a fixed program or protocol. It's an idea, an idea that imitating the most common service, to an extent that it behaves identically, could help you get across the Great FireWall permanently, without being identified ever. We are the GreatER Fire; we ship Trojan Horses.

Documentations

An online documentation can be found here.
Installation guide on various platforms can be found in the wiki.

Contributing

See CONTRIBUTING.md.

Dependencies

License

GPLv3

trojan (trojan-gfw/trojan)

Searching Database…

19.8K ·GitHub
What is this?Trojan is a censorship-circumvention proxy — an 'unidentifiable mechanism' built to get your traffic across China's Great Firewall (GFW).
It calls itself an 'idea' rather than a program — what does that mean?There is no single fixed protocol to name: the idea is to imitate the most common internet service so closely that your traffic behaves identically to it and is never identified.
How do I get it running?The wiki has installation guides for various platforms, plus online documentation; with Docker you can deploy it as a container instead of building from source.
Will my ISP be able to detect or throttle this traffic?That is what the design defends against: multiple protocols over TLS avoid both active and passive detection and ISP QoS throttling.
So is this an app I put on my devices, or something I run on a server?You host it yourself: Trojan is a self-hosted proxy program written in C++ that you deploy on your own server, not a regular end-user app.
Why is it called Trojan?The README quips: 'We are the GreatER Fire; we ship Trojan Horses.' Like the myth, the trick is smuggling your traffic inside something that looks completely ordinary.
Is the project still maintained?The repository is not archived; it dates back to October 2017 and has close to 20,000 GitHub stars.
Creator
trojan-gfw
Size
0.9 MB
Stars
19.8K
Age
8y
Commits · 90 Days