Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/krlvm/PowerTunnel
Powerful and extensible proxy server with anti-censorship functionality
https://github.com/krlvm/PowerTunnel
anti-censorship anticensorship censorship-circumvention deep-packet-inspection dpi dpi-filtering government-censorship proxy
Last synced: about 1 month ago
JSON representation
Powerful and extensible proxy server with anti-censorship functionality
- Host: GitHub
- URL: https://github.com/krlvm/PowerTunnel
- Owner: krlvm
- License: gpl-3.0
- Created: 2019-10-25T21:08:09.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-09-06T22:37:27.000Z (over 1 year ago)
- Last Synced: 2024-08-02T05:17:04.924Z (4 months ago)
- Topics: anti-censorship, anticensorship, censorship-circumvention, deep-packet-inspection, dpi, dpi-filtering, government-censorship, proxy
- Language: Java
- Homepage:
- Size: 5.54 MB
- Stars: 963
- Watchers: 23
- Forks: 65
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
- Awesome-Daily - PowerTunnel
README
## What is it
PowerTunnel is an extensible proxy server built on top of [LittleProxy](https://github.com/adamfisk/LittleProxy).
PowerTunnel provides an SDK that allows you to extend its functionality however you like, and even handle encrypted HTTPS traffic (powered by [LittleProxy-MITM](https://github.com/ganskef/LittleProxy-mitm)), which can be especially useful in web development. PowerTunnel has an Android version, so any plugin you write can work on almost all devices.
PowerTunnel was originally developed and is best known as a censorship bypass tool. This functionality has been spun off in the [LibertyTunnel](https://github.com/krlvm/LibertyTunnel) plugin which is installed by default, just like [DNS Resolver](https://github.com/krlvm/PowerTunnel-DNS) with DNS over HTTPS support.
#### Anti-censorship tool
Digital censorship has become widespread in authoritarian and developing countries: governments install DPI - Deep Packet Inspection systems - for Internet Service Providers, which allows analyzing and blocking traffic to websites they don't want you to see, forcing you to use slow and often paid proxies or VPN services with dubious privacy policy.
PowerTunnel is an active DPI circumvention utility - it works only on your PC and do not route your traffic through some third-party webservers. It creates a local proxy server on your device and diverts your HTTP(S) traffic there, where PowerTunnel modifies your traffic in a special way to exploit bugs in DPI systems which makes it possible to bypass the lock - without (significantly) slowing down your Internet connection.
Anti-censorship module can be configured in Plugins window - it is called LibertyTunnel.
In this sense, PowerTunnel is a free cross-platform implementation of [GoodbyeDPI](https://github.com/ValdikSS/GoodbyeDPI) written in Java.
Please, note that PowerTunnel does not change your IP address.
## Configuring
### Downloading PowerTunnel
PowerTunnel binary can be downloaded from the [Releases](https://github.com/krlvm/PowerTunnel/releases) page.
If you don't trust the prebuilt binaries, you can build PowerTunnel from source - it is using Gradle build system.
### Launching PowerTunnel
PowerTunnel is a portable Java application, and it does not require additional steps to get it working.
You need to install [Java](https://java.com) to run PowerTunnel.
PowerTunnel can be started by double-clicking the executable .jar file or by starting it from command line ([see below](#launch-arguments)).
After the first launch, PowerTunnel will create directories for storing plugins and configuration files.
### Installing plugins
To install a plugin, just place its .jar file into `plugins` directory.
Please, make sure you do not have installed different versions of the same plugin.
### Configuring plugins
Installed plugins can be configured from the user interface - click the "Plugins" button of main window to see the list of plugins.
## Launch arguments
You can specify some params that will override settings through CLI:```
$ java -jar PowerTunnel.jar -help--help display help
--start start proxy server after load
--console run application in console mode
--ip set proxy server IP address
--port set proxy server port
--auth-username set proxy authorization username
--auth-password set proxy authorization password
--upstream-proxy-host set upstream proxy host
--upstream-proxy-port set upstream proxy port
--upstream-auth-password set upstream proxy password
--upstream-auth-username set upstream proxy username
--upstream-proxy-protocol set upstream proxy protocol [HTTP/SOCKS4/SOCKS5]
--minimized minimize UI to tray after start
--set-ui-scale-factor set UI scale factor
--auto-proxy-setup-ie setup proxy using Internet Explorer [Windows]
--disable-auto-proxy-setup disable auto proxy setup
--disable-native-skin disable platform native UI skin
--disable-tray disable tray mode
--disable-ui-scaling disable UI scaling
--disable-updater disable Update Notifier
--enable-logging enable logging to file
--lang set UI language
--cfg set preference value
--version print version details
```If you need to set a certain plugin preference, use `-cfg pluginID.preferenceKey [value]`
## Bundled Plugins
* [LibertyTunnel](https://github.com/krlvm/LibertyTunnel) - anti-censorship plugin for PowerTunnel
* [DNS Resolver](https://github.com/krlvm/PowerTunnel-DNS) - DNS Resolver with DNS over HTTPS (DoH) support## Dependencies
* [LittleProxy](https://github.com/adamfisk/LittleProxy) - proxy server, [forked version](https://github.com/LittleProxy/LittleProxy)
* [LittleProxy-MITM](https://github.com/ganskef/LittleProxy-mitm) - LittleProxy SSL extension
* [dnsjava](https://github.com/dnsjava/dnsjava) - DNS and DoH library
* [dnssecjava](https://github.com/ibauersachs/dnssecjava) - DNSSec implementation for dnsjava
* [SLF4J](http://www.slf4j.org/) - logging facade API
* [Log4j](https://logging.apache.org/log4j/2.x/) - logger implementation
* [Java Native Access](https://github.com/java-native-access/jna) - accessing system native API
* [SwingDPI](https://github.com/krlvm/SwingDPI) - High DPI scaling