1. Enable Automatic Software Updates

One of the most important things to keep your relay secure is to install security updates timely and ideally automatically so you can not forget about it. Follow the instructions to enable automatic software updates for your operating system.

2. Install tor

To install the tor package on Void Linux, considering you are already on an up-to-date system:

# xbps-install -S tor

3. Install obfs4proxy

We are opting here to install and use obfs4 as pluggable transport, so we are going to install obfs4proxy.

Once we can rely on an official opbfs4proxy package provided by the Void Linux's maintainers, this is how we install it:

# xbps-install -S obfs4proxy
  • For more information on installing or building obfs4proxy from source, please refer to its official docummentation.

4. Edit your Tor config file, usually located at /etc/tor/torrc and replace its content with:

BridgeRelay 1

# შეცვალეთ „TODO1“ სასურველი Tor-პორტით.
# ეს პორტი გარედან მისაწვდომი უნდა იყოს.
# აირიდეთ 9001 ვინაიდან, მეტად გაიგივებულია Tor-თან და ცენზორებმა შეიძლება გადაამოწმონ ინტერნეტიდან ეს პორტი.
ORPort TODO1

ServerTransportPlugin obfs4 exec /usr/bin/obfs4proxy

# შეცვალეთ „TODO2“ სასურველი obfs4-პორტით.
# ეს პორტი გარედან მისაწვდომი უნდა იყოს და განსხვავდებოდეს OR-პორტისთვის განსაზღვრულისგან.
# აირიდეთ 9001 ვინაიდან, მეტად გაიგივებულია Tor-თან და ცენზორებმა შეიძლება გადაამოწმონ ინტერნეტიდან ეს პორტი.
ServerTransportListenAddr obfs4 0.0.0.0:TODO2

# ადგილობრივი კავშირის პორტი Tor-სა და obfs4-ს შორის.  ყოველთვის მიუთითეთ „auto“.
# „Ext“ ნიშნავს გაფართოებულს, „extended“ და არა გარეს, „external“.  არ სცადოთ ცალკეული პორტის ნომრის მითითება ან 0.0.0.0. პორტის დაყენება კავშირის მისაღებად.
ExtORPort auto

# შეცვალეთ „<address@email.com>“ თქვენი ელფოსტით, რომ შევძლოთ თქვენთან დაკავშირება, თუ რამე ხარვეზი წარმოექმნება გადამცემ ხიდს.
# ეს არაა სავალდებულო მაგრამ სასურველია.
ContactInfo <address@email.com>

# აირჩიეთ სასურველი მეტსახელი ხიდისთვის.  არასავალდებულოა.
Nickname PickANickname

არ დაგავიწყდეთ შეცვალოთ ORPort, ServerTransportListenAddr, ContactInfo და Nickname პარამეტრები.

  • Note that both Tor's OR port and its obfs4 port must be reachable. If your bridge is behind a firewall or NAT, make sure to open both ports. You can use our reachability test to see if your obfs4 port is reachable from the Internet.

5. Enable and Start tor

Different from most recent distributions, Void Linux does not uses systemd; it uses runit instead.

To enable tor's service on a booted system:

# ln -s /etc/sv/tor /var/service/.

Once you enabled the service, it will automatically start. If you already started the tor daemon before and made changes do its configurations, you can restart it with:

# sv restart tor

6. Monitor your logs

იმის დასამოწმებლად, რომ თქვენი გადამცემი ხიდი გაშვებულია უხარვეზოდ, უნდა იხილოთ ასეთი რამ (ჩვეულებრივ მისამართზე /var/log/tor/log ან /var/log/syslog):

[notice] Your Tor server's identity key fingerprint is '<NICKNAME> <FINGERPRINT>'
[notice] Your Tor bridge's hashed identity key fingerprint is '<NICKNAME> <HASHED FINGERPRINT>'
[notice] Registered server transport 'obfs4' at '[::]:46396'
[notice] Tor has successfully opened a circuit. Looks like client functionality is working.
[notice] Bootstrapped 100%: Done
[notice] Now checking whether ORPort <redacted>:3818 is reachable... (this may take up to 20 minutes -- look for log messages indicating success)
[ცნობა] თვითშემოწმება აჩვენებს, რომ თქვენი ORPort ხელმისაწვდომია გარედან. მშვენიერია. გამოქვეყნდება სერვერის აღმწერი.

7. Final Notes

If you are having trouble setting up your bridge, have a look at our help section. If your bridge is now running, check out the post-install notes.