Skip to content

levouinse/sofinco-tor

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
bash-completion
bash-completion
 
 
service
service
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
FAQ.md
FAQ.md
 
 
LICENSE
LICENSE
 
 
QUICKSTART.md
QUICKSTART.md
 
 
README.md
README.md
 
 
install.sh
install.sh
 
 
sofinco-tor
sofinco-tor
 
 

Repository files navigation

SOFINCO-TOR v5.0.0 🔒

Production-ready Tor anonymizer for Linux, macOS, and VPS environments. Route all system traffic through Tor with advanced security features and comprehensive monitoring.

Version Platform License

Features

Core

  • System-wide Tor routing - All traffic automatically routed through Tor
  • DNS leak protection - All DNS queries through Tor (port 9053)
  • Dual firewall support - iptables and nftables backends
  • Multi-platform - Linux (all distros), macOS, VPS
  • Zero-config - Works out of the box
  • Lightweight - ~10MB RAM, minimal CPU usage

Security

  • IPv6 disabled (prevents leaks)
  • TCP timestamps disabled (anti-fingerprinting)
  • ICMP blocking (no ping responses)
  • Smart node selection (excludes risky countries)
  • Kill switch (blocks non-Tor traffic)
  • Automatic trace clearing
  • System hardening on startup

Advanced

  • 15+ IP verification sources with geolocation
  • Multi-source Tor verification (5+ services)
  • Speed & bandwidth testing (multiple file sizes)
  • Real-time monitoring dashboard
  • 10-point anonymity testing
  • Circuit & node information
  • Traffic statistics
  • Auto IP rotation
  • Country-specific exit nodes
  • Bridge support (bypass censorship)
  • Multi-hop routing
  • EXTREME mode (ultra-paranoid settings)

Performance

  • 64MB TCP buffers (4x default)
  • BBR congestion control
  • 512 concurrent circuits
  • 16 entry guards
  • 15s circuit build timeout
  • No disk writes (faster & more secure)

Quick Start

Installation

git clone https://github.com/levouinse/sofinco-tor
cd sofinco-tor
sudo ./install.sh

Basic Usage

# Start Tor anonymization
sudo sofinco-tor start

# Check status
sofinco-tor status

# Get current IP (15+ sources)
sofinco-tor ip

# Get new identity
sudo sofinco-tor newid

# Stop
sudo sofinco-tor stop

Commands

Basic

Command Description
start Start Tor anonymization
stop Stop and restore clearnet
restart Restart Tor service
status Show current status
newid Get new identity (change IP)
ip Show IP from 15+ sources with geolocation
check Verify Tor from multiple sources
bridges Enable Tor bridges (bypass censorship)
notrace Clear all traces and logs

Advanced

Command Description
speedtest Multi-endpoint speed test
bandwidth Comprehensive bandwidth test (100KB-10MB)
circuit Detailed circuit information
nodes Show Tor nodes and entry guards
country <code> Set exit node country (us, de, nl, etc.)
autorotate [sec] Auto-rotate IP every N seconds
stats Detailed system statistics
traffic Show traffic statistics
logs View Tor logs

Security & Testing

Command Description
anontest 10-point anonymity test
fullcheck Comprehensive security check
scan <target> Port scan through Tor
monitor Real-time monitoring dashboard
extreme Enable EXTREME anonymity mode

Configuration

Command Description
backup Backup current configuration
restore <file> Restore from backup
multihop Enable multi-hop routing (3+ nodes)

Examples

# Start and verify
sudo sofinco-tor start
sofinco-tor check
sofinco-tor ip

# Test anonymity
sofinco-tor anontest
sofinco-tor fullcheck

# Test performance
sofinco-tor speedtest
sofinco-tor bandwidth

# Use German exit nodes
sudo sofinco-tor country de

# Auto-rotate IP every 10 minutes
sudo sofinco-tor autorotate 600

# Real-time monitoring
sofinco-tor monitor

# Enable ultra-paranoid mode
sudo sofinco-tor extreme

Platform Support

Linux

  • Arch Linux / Manjaro
  • Debian / Ubuntu / Mint
  • Kali Linux
  • Gentoo
  • Void Linux
  • CentOS / RHEL / Fedora
  • Any distro with iptables or nftables

Other

  • macOS 10.15+
  • VPS (DigitalOcean, AWS, Vultr, Linode, etc.)
  • Dedicated servers

VPS Deployment

Perfect for VPS environments:

# SSH to VPS
ssh root@your-vps

# Install
git clone https://github.com/levouinse/sofinco-tor
cd sofinco-tor
./install.sh

# Start
sofinco-tor start

# Verify
sofinco-tor check
sofinco-tor ip

# Enable autostart
systemctl enable sofinco-tor

VPS Optimization

  • Minimal resource usage (~10MB RAM)
  • Fast startup (~2 seconds)
  • No disk writes (AvoidDiskWrites enabled)
  • BBR congestion control for better speed
  • 64MB TCP buffers for high throughput
  • 512 concurrent circuits

Configuration

Environment Variables

# Custom Tor user
export TOR_UID=tor

# Custom ports
export TOR_PORT=9040
export TOR_DNS=9053
export TOR_SOCKS=9050

# Start with custom config
sudo sofinco-tor start

Custom Torrc

Edit /etc/tor/torrc after installation:

sudo nano /etc/tor/torrc
sudo sofinco-tor restart

Security

DNS Leak Protection

All DNS queries routed through Tor (port 9053). Verify:

sofinco-tor check
# Visit: https://dnsleaktest.com

No-Trace Mode

Automatically clears on startup:

  • Bash history
  • System logs
  • Auth logs
  • All .log files

Manual clear:

sudo sofinco-tor notrace

System Hardening

Automatically applied:

  • TCP timestamps disabled
  • ICMP echo disabled
  • IPv6 disabled
  • ICMP redirects blocked
  • BBR congestion control
  • 64MB TCP buffers
  • TCP Fast Open

Performance

Benchmarks

  • Startup time: ~2 seconds
  • Identity change: ~2 seconds
  • Memory usage: ~10MB
  • CPU usage: <1%

Expected Speed

  • Download: 2-10 MB/s (depends on Tor network)
  • Latency: 300-1500ms
  • Circuit build: 5-15 seconds

Test your speed:

sofinco-tor speedtest
sofinco-tor bandwidth

Troubleshooting

Tor won't start

# Check Tor service
sudo systemctl status tor

# Check logs
sudo journalctl -u tor -n 50

# Restart
sudo systemctl restart tor
sudo sofinco-tor start

No internet after starting

# Stop and restore
sudo sofinco-tor stop

# Check firewall
sudo iptables -L -n -v
# or
sudo nft list ruleset

# Try again
sudo sofinco-tor start

Slow connection

# Get new identity
sudo sofinco-tor newid

# Enable bridges
sudo sofinco-tor bridges

# Test speed
sofinco-tor speedtest

DNS leaks

# Verify Tor
sofinco-tor check

# Restart
sudo sofinco-tor restart

# Test at: https://dnsleaktest.com

Autostart

Enable autostart on boot:

# Enable
sudo systemctl enable sofinco-tor

# Start now
sudo systemctl start sofinco-tor

# Check status
sudo systemctl status sofinco-tor

Tips

Maximum Anonymity

  1. Use Tor Browser alongside this tool
  2. Change identity regularly: sudo sofinco-tor newid
  3. Don't log into personal accounts
  4. Disable WebRTC in browser
  5. Use HTTPS sites only
  6. Don't torrent over Tor
  7. Run anonymity test: sofinco-tor anontest

VPS Best Practices

  1. Use dedicated VPS for anonymity
  2. Pay with cryptocurrency
  3. Use fake registration info
  4. Enable autostart: systemctl enable sofinco-tor
  5. Monitor regularly: sofinco-tor monitor
  6. Clear traces: sudo sofinco-tor notrace

Performance Tips

  1. Change identity if slow: sudo sofinco-tor newid
  2. Enable bridges in censored regions: sudo sofinco-tor bridges
  3. Use during off-peak hours
  4. Choose VPS with good network
  5. Test speed: sofinco-tor speedtest

How It Works

  1. Backup - Saves current firewall and DNS config
  2. Configure - Generates optimized Tor config
  3. DNS - Routes all DNS through Tor (127.0.0.1:9053)
  4. Firewall - Redirects all traffic through Tor (127.0.0.1:9040)
  5. Harden - Applies security optimizations
  6. No-Trace - Clears logs and history
  7. Start - Launches Tor with optimized settings

Security Checklist

  • DNS leak protection
  • IPv6 disabled
  • TCP timestamps disabled
  • ICMP blocking
  • Smart node selection
  • Kill switch (blocks non-Tor)
  • No disk writes
  • Automatic trace clearing
  • Multiple SOCKS ports
  • Circuit isolation

Documentation

  • README.md - This file
  • QUICKSTART.md - Quick start guide
  • FAQ.md - Frequently asked questions
  • ADVANCED.md - Advanced usage
  • COMMANDS.md - Command reference
  • ULTRA-FEATURES.md - Ultra-OP features

Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create feature branch
  3. Test thoroughly
  4. Submit pull request

License

GPL-3.0 License - See LICENSE file

Disclaimer

This tool is for privacy and educational purposes only. Users are responsible for compliance with local laws. The authors assume no liability for misuse.

Links

Support

Made with ❤️ for privacy and anonymity

Stay anonymous, stay safe! 🔒

About

Powerfull tools to connect to tor network with bunch of usefull tools.

Resources

Readme

License

GPL-3.0 license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

v5.0.0 Latest
Jan 24, 2026

Packages

 
 
 

Contributors

Languages