- Compatible XF 2.x versions
- 2.3
- Additional requirements
- [Olakunlevpn] Telegram Free Cloud Backup 1.3.0+
- License
- MIT License
Telegram Backup - Tor Extension
Back up Tor hidden service keys and configs directly to Telegram cloud storage.
Why Back Up Tor Hidden Service Keys?
Tor onion services rely entirely on private cryptographic keys stored in protected system directories (such as
If your server suffers hardware failure, disk corruption, or accidental loss:
[Olakunlevpn] Telegram Backup - Tor Extension solves this by integrating directly with [Olakunlevpn] Telegram Free Cloud Backup to securely package, encrypt, and upload your Tor hidden service keys directly to your private Telegram storage vault.
Features
Setup Guide (3 Steps)
Step 1: Create the Backup Script on Your Server
Create
Make it executable:
Step 2: Add Sudoers Rule for PHP User
In
Step 3: Configure XenForo Options
Go to Tools -> Telegram Backup and click Backup Tor Keys!
Disaster Recovery
When your backup completes, the bot posts the archive and the exact commands to restore on your replacement server:
Requirements
Back up Tor hidden service keys and configs directly to Telegram cloud storage.
Why Back Up Tor Hidden Service Keys?
Tor onion services rely entirely on private cryptographic keys stored in protected system directories (such as
/var/lib/tor/<service_name>/).If your server suffers hardware failure, disk corruption, or accidental loss:
- Your
.onionaddress cannot be recovered without the private key. - Your forum reputation, onion bookmarks, and user trust are permanently lost.
- You must generate a completely new onion address from scratch.
[Olakunlevpn] Telegram Backup - Tor Extension solves this by integrating directly with [Olakunlevpn] Telegram Free Cloud Backup to securely package, encrypt, and upload your Tor hidden service keys directly to your private Telegram storage vault.
Features
- Dedicated Admin Action: Injects an amber Backup Tor Keys button into your Telegram Backup dashboard in Admin CP.
- Zero-Privilege Security Pipeline: Keeps your Tor keys secure by delegating archive creation to a single restricted root script via sudo, preventing full root access from PHP.
- Client-Side AES-256 Encryption: Uses the master encryption key from your main Telegram Backup add-on to encrypt your sensitive Tor keys before transmission to Telegram.
- Instant Telegram Delivery & Recovery Guide: Delivers your compressed Tor keys archive directly to Telegram accompanied by ready-to-run copy-paste terminal restore commands.
- Safe Disk Cleanup: Unlinks temporary archives from local disk immediately upon cloud transfer completion.
Setup Guide (3 Steps)
Step 1: Create the Backup Script on Your Server
Create
/usr/local/bin/backup_tor_keys.sh:
Bash:
#!/bin/bash
if [ -z "$1" ]; then
echo "Usage: $0 <output_tar_gz_path>"
exit 1
fi
tar -czvf "$1" /var/lib/tor/your_hidden_service_directory/
Make it executable:
Bash:
chmod 750 /usr/local/bin/backup_tor_keys.sh
chown root:root /usr/local/bin/backup_tor_keys.sh
Step 2: Add Sudoers Rule for PHP User
In
/etc/sudoers.d/tor_backup (replace www-data with your web server user):
Code:
www-data ALL=(ALL) NOPASSWD: /usr/local/bin/backup_tor_keys.sh
Step 3: Configure XenForo Options
- Install [Olakunlevpn] Telegram Backup - Tor Extension via Admin CP.
- Go to Setup -> Options -> [Olakunlevpn] Telegram Free Cloud Backup Options.
- Set Tor Backup Script Path to
/usr/local/bin/backup_tor_keys.sh. - Set Tor Hidden Service Directory to your onion directory path (e.g.
/var/lib/tor/hidden_service/). - Ensure Execute Tor Script with Sudo is enabled and click Save.
Go to Tools -> Telegram Backup and click Backup Tor Keys!
Disaster Recovery
When your backup completes, the bot posts the archive and the exact commands to restore on your replacement server:
Bash:
systemctl stop tor
tar -xzvf filename.tar.gz -C /
chown -R debian-tor:debian-tor /var/lib/tor/your_hidden_service/
chmod 700 /var/lib/tor/your_hidden_service/
chmod 600 /var/lib/tor/your_hidden_service/*
systemctl start tor
Requirements
- XenForo 2.3.0 or higher
- [Olakunlevpn] Telegram Free Cloud Backup 1.3.0 or higher installed and configured
- Sudo execution permissions on the backup script for your web server user
- Related resources