Skip to main content

No project description provided

Project description

rete

Containerized Web Browsing for Added Protection

Install

python3 -m pip install rete

NOTE : Install requires $USER to be in the docker group, or sudo permissions.

Usage

➜ rete -h      
usage: rete version 1.0.2 [-h] [-p PROFILE] [-t] [--config | --rm | --update]
                          [{brave,chromium,firefox,opera,tbb}]

positional arguments:
  {brave,chromium,firefox,opera,tbb}
                        Supported Browsers

optional arguments:
  -h, --help            show this help message and exit
  -p PROFILE, --profile PROFILE
                        Profile Name
  -t                    Temporary Profile
  --config              Open Config for Editing
  --rm                  Stop and Remove ALL Browsers
  --update              Check for Upates

Config

➜ cat ~/.config/rete/rete.yml
browser:
  name: firefox
  #proxy:
  #dns:
  #  ip: 
  #  host:
  #  doh: false

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

#vpn:
#  provider:
#  user:
#  pass:
#  config: 

proxy

Currently the expected value is an HTTP/HTTPS/SOCKS proxy value in the form of: PROTO://IP:PORT
Proxy also supports BurpSuite by passing the value burpsuite.

dns

ip: as the name implies, the ip of the dns server you want to use.
host: the appropriate hostname and is the value used when DoH is enabled
doh: enabled or disabled DNS over HTTP

profile

default: the profile to load by default on browser start
list: the list of available profiles to use, feel free to add/remove any of them
the lan profile is a special restricted profile that only has access to RFC1918 IPs

vpn

See retenet/tunle for more detailed documentation.

provider: one of the supported providers
user: username for login
pass: password for login
config: this is used for custom openvpn configs. It must be fullpath
Typical args would be provider with user/pass, or simply just a config

Example configs

Standard Usage

browser:
  name: firefox
  dns:
    ip: 1.1.1.1
    host: cloudflare-dns.com
    doh: true

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

Burpsuite

browser:
  name: firefox
  proxy: burpsuite

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

OpenVPN

browser:
  name: firefox

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

vpn:
  config: /home/user/ovpn/wh1tf3fox.ovpn

Tor Transparent Proxy

browser:
  name: firefox

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

vpn:
  provider: tor

Pia

browser:
  name: firefox

profile:
  default: personal
  list: [htb, lan, media, personal, shopping, work]

vpn:
  provider: pia
  user: abcdef
  pass: abcdef

NOTE: if OpenVPN fails to load try adding:

pull-filter ignore "ifconfig-ipv6 "
pull-filter ignore "route-ipv6 "

to your ovpn config

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rete, version 1.0.15
Filename, size File type Python version Upload date Hashes
Filename, size rete-1.0.15.tar.gz (13.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page