One of the things I’ve been meaning to do for a while is gain a better understanding of the onion protocol and how hidden services are hosted. I got about 50% through the Tor whitepaper before deciding to pivot to some practical applications, so this blog is now mirrored at http://xzjjcvowtdunfx4z6dkeund7sjvt3k7nphgcfdusy64smyqpmdusmpad.onion/. It’s v3, which can be quickly inferred from the 56 character address.
The static files for this blog reside on a 3rd gen Raspberry Pi and are served by nginx, so we’ll setup Tor there as well.
Installing Tor requires either building from source, or adding some 3rd party APT repositories. I used the repos because building will take a while. There are some gotchas, however, since Raspbian differs from Debian in a few ways. More detailed info here.
In short, it’s sufficient to add the following to your
[arch=amd64] is important else your
apt get update will fail. Also pay attention to your raspbian version. Is it jessie, stretch or buster? Double check with
deb [arch=amd64] https://deb.torproject.org/torproject.org buster main
deb-src [arch=amd64] https://deb.torproject.org/torproject.org buster main
Add the package signing GPG keys.
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | apt-key add -
Hope this works.
apt update && apt upgrade
apt install tor deb.torproject.org-keyring
Next, ensure the hidden service dir
/var/lib/tor/hidden_service exists and has the correct permissions.
sudo chown -R debian-tor /var/lib/tor/hidden_service
sudo chmod 700 /var/lib/tor/hidden_service
/etc/tor/torrc to reflect the setup
HiddenServicePort 80 127.0.0.1:8080
Finally, add a vhost to nginx. Your web root may vary so double check that.
Now, do a
service tor restart && service nginx reload and you should now find a
private_key file in
/var/lib/tor/hidden_service. Your hostname is your onion url so go ahead and test that. If something went wrong, which is highly likely, tail your
/var/log/nginx/error.log for hints. Apparently Tor is supposed to generate logs in
/var/log/tor but mine is empty.
Ah, one more thing
Setting up a middle/guard relay is pretty trivial, and a great way to help out the community. Add a few lines to
/etc/tor/torrc and ensure port 9001 is reachable via https://canyouseeme.org/. Then restart, and we’re good to go. Keep tailing syslog however, since it will indicate if things go wrong.
ContactInfo [email protected]
After about an hour we can verify the relay is operational at https://metrics.torproject.org/rs.html#search/CiaSurveillanceVan. Fantastic.
By hosting a hidden service however, I’ve now created a new set of problems for the poor pi, and by extension my home network connection, in the form of eventual ruthless DDoSing. These Posts discuss the problems & solutions, and are a good starting point for hardening the home network.
In theory though, v3 addresses should be impossible to crawl unless publicly advertised. Still, for my peace of mind it’s best to take precautions. For now the first step is getting some better network monitoring in place, which from my understanding is Munin. Updates to follow, as they’re implemented.
Now would be a good time to run a backup of the Pi’s SD card, to save our hours of toil. I have an additional usb drive attached and mounted so I will drop it there. Note that your SD card might have a different name, so check with
dd bs=4M if=/dev/mmcblk0 of=/media/pi-space/sd-card-backup-2021-02.img