Skip to content
/ spior Public

(Spider|Tor) A tool to make TOR your default gateway.

License

Notifications You must be signed in to change notification settings

szorfein/spior

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spior


Gem Version GitHub Workflow Status (branch) Ruby Style Guide GitHub

(Spider|Tor) A tool to redirect all your local traffic to the Tor network.

Install

Spior is cryptographically signed, so add my public key (if you haven’t already) as a trusted certificate.

$ gem cert --add <(curl -Ls https://raw.githubusercontent.com/szorfein/spior/master/certs/szorfein.pem)

And install the gem:

$ gem install spior -P MediumSecurity

Or user wide (Spior will use sudo, doas will be supported in next release)

$ gem install --user-install spior

Requirements

Spior use iptables and tor, which can be installed with (if your distro is supported):

$ spior --install

Configuration

Spior look the /etc/tor/torrc for any of:

DNSPort 9061
TransPort 9040
VirtualAddrNetworkIpv4 10.192.0.0/10

You can customize any of theses variables.

When using spior -c | --clearnet, if you want Spior load custom iptables rules, place them at /etc/iptables/simple_firewall.rules.

Usage

$ spior -h

Examples

Redirect traffic through TOR:

$ spior --tor

Change your ip address by reloading the TOR circuit:

$ spior --reload

Look informations about your current ip address:

$ spior --status

Return to clearnet navigation

$ spior --clearnet

Left Over

Troubleshoooting

When you enable the --persist mode, Spior try to block ipv6 with sysctl. It can fail on some system, so you may need to manually disable ipv6 via kernel argument.
An exemple with GRUB, edit /etc/default/grub.cfg and change the line bellow:

GRUB_CMDLINE_LINUX_DEFAULT="ipv6.disable=1 quiet"

Reload grub after that grub-mkconfig -o /boot/grub/grub.cfg

Issues

For any questions, comments, feedback or issues, submit a new issue.

links