Run multiple Tor instances with different configuration files (torrc) to host different hidden services/tunnels on the same machine. This setup is particularly useful when working with tools like SoCat for offensive security purposes.

• Prerequisites
• Setup Instructions
  • 1. Install Tor Service
  • 2. Create Configuration Directories
  • 3. Create Configuration Files
  • 4. Set Up Directories and Permissions
  • 5. Create Systemd Service Files
  • 6. Reload Systemd and Start Services
  • 7. Check Service Status
  • 8. Retrieve .onion Addresses
• Ethical Guidelines
• License

Make sure you have the Tor service installed on your system.

Ensure Tor is installed on your system:

sudo apt-get install tor

Create a new directory for each hidden service configuration:

sudo mkdir -p /etc/tor/instances/hidden_service_1
sudo mkdir -p /etc/tor/instances/hidden_service_2

Replace hidden_service_1 and hidden_service_2 with the desired names for your hidden services.

Create new configuration files for each hidden service:

sudo nano /etc/tor/instances/hidden_service_1/torrc
sudo nano /etc/tor/instances/hidden_service_2/torrc

Add the following configuration to each torrc file, adjusting the HiddenServiceDir and HiddenServicePort values as needed:

RunAsDaemon 1
DataDirectory /var/lib/tor/instances/hidden_service_1
PidFile /var/run/tor/instances/hidden_service_1.pid
SocksPort 0
HiddenServiceDir /var/lib/tor/hidden_service_1/
HiddenServicePort 80 127.0.0.1:8080

Replace hidden_service_1 with the appropriate hidden service name, and adjust the HiddenServicePort value to point to the correct local address and port for the associated web service (e.g., Nginx reverse proxy listening on a different port for each hidden service).

Save the changes and exit the editor.

Create the required directories and set the correct ownership for the data directories:

sudo mkdir -p /var/lib/tor/instances/hidden_service_1
sudo mkdir -p /var/lib/tor/instances/hidden_service_2
sudo chown -R debian-tor:debian-tor /var/lib/tor/instances

Create a new systemd service file for each Tor instance:

sudo nano /etc/systemd/system/tor@hidden_service_1.service
sudo nano /etc/systemd/system/tor@hidden_service_2.service

Add the following content to each systemd service file, adjusting the hidden_service_1 and hidden_service_2 values as needed:

[Unit]
Description=Tor Hidden Service %I
After=network.target

[Service]
User=debian-tor
Type=simple
ExecStart=/usr/sbin/tor -f /etc/tor/instances/%I/torrc
Restart=on-failure

[Install]
WantedBy=multi-user.target

Save the changes and exit the editor.

Reload the systemd configuration:

sudo systemctl daemon-reload

Enable and start the new Tor instances:

sudo systemctl enable tor@hidden_service_1.service
sudo systemctl start tor@hidden_service_1.service
sudo systemctl enable tor@hidden_service_2.service
sudo systemctl start tor@hidden_service_2.service

Check the status of the new Tor instances to ensure they are running correctly:

sudo systemctl status tor@hidden_service_1.service
sudo systemctl status tor@hidden_service_2.service

Retrieve the .onion addresses for your hidden services:

sudo cat /var/lib/tor/hidden_service_1/hostname
sudo cat /var/lib/tor/hidden_service_2/hostname

Note the .onion addresses for each hidden service, as you will use them to access the respective services.

Now you have multiple Tor instances running with different torrc files, each hosting a separate hidden service/tunnel.

This information is intended for educational purposes and to support ethical security testing. It is crucial to use these instructions responsibly. Unauthorized use of this knowledge for malicious purposes is strictly prohibited.

• No Unauthorized Use: Do not use these instructions to access, disrupt, or compromise any systems or networks without explicit permission from the owner.
• Ethical Responsibility: Use these instructions to improve security, understand network anonymity, and for lawful research and educational purposes only.
• No Support for Malicious Activities: Any requests for assistance with illegal activities will be ignored.

If you find this project useful and want to support it, there are several ways to do so:

• If you find the white paper helpful, please ⭐ it on GitHub. This helps make the project more visible and reach more people.
• Become a Follower: If you're interested in updates and future improvements, please follow my GitHub account. This way you'll always stay up-to-date.
• Learn more about my work: I invite you to check out all of my work on GitHub and visit my developer site https://volkansah.github.io. Here you will find detailed information about me and my projects.
• Share the project: If you know someone who could benefit from this project, please share it. The more people who can use it, the better. If you appreciate my work and would like to support it, please visit my GitHub Sponsor page. Any type of support is warmly welcomed and helps me to further improve and expand my work.

Thank you for your support! ❤️ S. Volkan Kücükbudak

This project is licensed under the MIT - see the LICENSE file for details.