Cara Host Situs .onion di VPS dengan Tor dan Nginx
Pelajari cara menjalankan onion service v3 di Ubuntu dengan Tor dan nginx pada loopback, lalu menutup kebocoran yang dapat mengaitkan alamat .onion ke IP publik VPS.
Yang Anda bangun
Situs onion adalah web server biasa yang hanya merespons melalui jaringan Tor. Instal tor, tambahkan dua baris ke /etc/tor/torrc, baca alamat yang ditulis Tor, lalu bind nginx ke 127.0.0.1 agar tidak ada layanan yang merespons pada IP publik. Proses instalasi membutuhkan waktu sepuluh menit. Bagian lainnya dalam panduan ini membahas daftar potensi kebocoran, karena situs onion biasanya gagal ketika konfigurasinya sendiri mengarah langsung kembali ke operator.
Tor pada awalnya disebut "the onion router", dan onion service adalah service yang hanya dapat diakses melaluinya. Alamat versi 3 terdiri atas 56 karakter yang diikuti .onion. Karakter tersebut berisi public key ed25519 milik service, checksum, dan byte versi yang dikodekan dalam base32. Alamat versi 2 (16 karakter) dihapus dari jaringan pada 2021, sehingga apa pun yang Anda buat saat ini adalah v3. Alamat tersebut adalah key, dan hal ini memiliki dua konsekuensi. Koneksi dienkripsi dan diautentikasi secara end-to-end tanpa melibatkan certificate authority, dan kehilangan file key berarti kehilangan alamat tersebut secara permanen.
Server Anda tidak pernah menerima koneksi masuk. Tor memilih beberapa relay sebagai titik pengenalan, mengunggah descriptor yang ditandatangani ke directory server, lalu bertemu dengan setiap pengunjung melalui rendezvous relay yang dipilih pengunjung. Semua koneksi tersebut merupakan koneksi keluar dari server Anda. Tidak ada port yang perlu dibuka dan tidak ada DNS record yang perlu dipublikasikan. Jika Anda ingin VPS yang sama menyediakan layanan bagi jaringan, itu merupakan tugas berbeda dengan bentuk yang berlawanan, karena bridge obfs4 menerima koneksi masuk dari klien yang terkena sensor dan memerlukan port yang dapat dijangkau.
Instal tor dari repositori Tor Project
Ubuntu menyediakan paket tor di universe dan tetap memperbaruinya setelah rilis melalui pocket updates, tetapi versinya tertinggal dari upstream. Pada 2026-10-11, noble-updates menyediakan versi 0.4.9.11, sedangkan Tor Project telah merilis versi 0.4.9.14 dan menyediakannya dari repositorinya sendiri. Repositori tersebut mengikuti rilis stabil terbaru saat dirilis. Inilah yang Anda perlukan untuk komponen perangkat lunak yang menentukan apakah alamat Anda tetap menjadi milik Anda. Keberadaan suatu paket dalam distribusi tidak menunjukkan bahwa paket tersebut masih dikembangkan. Hal ini perlu diperiksa untuk apa pun yang Anda self-host, karena Searx tidak memiliki commit kode sejak 2023, sedangkan SearXNG melanjutkan pengembangan proyek tersebut.
sudo apt update
sudo apt install -y apt-transport-https gnupg wget
KEYURL=https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc
wget -qO- "$KEYURL" | gpg --dearmor | sudo tee /usr/share/keyrings/deb.torproject.org-keyring.gpg >/dev/nullEntri repositori menggunakan format deb822, dan Suites harus berupa codename Ubuntu Anda. Baca nilainya dari /etc/os-release, bukan mengetiknya, karena codename yang salah dapat menghasilkan repositori yang berhasil di-resolve tetapi tidak memiliki paket untuk rilis Anda.
. /etc/os-release
sudo tee /etc/apt/sources.list.d/tor.sources >/dev/null <<EOF
Types: deb deb-src
URIs: https://deb.torproject.org/torproject.org/
Suites: $VERSION_CODENAME
Components: main
Signed-By: /usr/share/keyrings/deb.torproject.org-keyring.gpg
EOF
sudo apt update
sudo apt install -y tor deb.torproject.org-keyringPaket deb.torproject.org-keyring menjaga signing key tetap mutakhir, sehingga rotasi key tidak membuat apt update berhenti berfungsi setahun kemudian. Pastikan tor telah start dan terhubung ke jaringan:
tor --version
sudo journalctl -u tor@default -n 20Journal seharusnya diakhiri dengan Bootstrapped 100% (done): Done. tor yang berhenti pada Bootstrapped 10% tidak memiliki jalur keluar, jadi periksa firewall jaringan provider Anda dan aturan egress Anda sendiri: sudo ufw status verbose seharusnya menampilkan allow (outgoing) sebagai default.
Mulai dari sini, ada dua nama yang penting. Paket tersebut menjalankan tor sebagai user debian-tor, sedangkan unit yang berjalan adalah tor@default.service, karena tor.service pada Debian dan Ubuntu merupakan wrapper untuk instance tersebut. Minta status dan log berdasarkan nama instance agar Anda selalu mendapatkan proses yang sebenarnya.
Konfigurasikan layanan onion di torrc
Tambahkan dua baris ke /etc/tor/torrc:
HiddenServiceDir /var/lib/tor/onion_site/
HiddenServicePort 80 127.0.0.1:8080HiddenServiceDir adalah lokasi tor menyimpan kunci dan alamat untuk layanan ini. Jangan membuatnya sendiri. Tor membuatnya saat dijalankan, dengan pemilik dan mode yang diperlukan. Direktori yang dibuat sebagai root menyebabkan kegagalan pertama dalam daftar kegagalan di bawah.
HiddenServicePort memiliki dua bagian. Kesalahan pertama yang umum adalah menukar kedua bagian tersebut. Angka pertama adalah port yang digunakan pengunjung untuk terhubung di dalam tunnel. Karena itu, 80 adalah nilai yang diharapkan dan tidak ada alasan untuk mengubahnya. Bagian kedua adalah alamat lokal yang menerima penerusan trafik oleh tor. Nilai HiddenServicePort 80 tanpa alamat meneruskan ke 127.0.0.1:80. Jadi, menuliskan alamat secara eksplisit dan menggunakan port tinggi membuat vhost onion tidak bertabrakan dengan layanan yang sudah mendengarkan pada port 80.
sudo systemctl restart tor@default
sudo ls -l /var/lib/tor/onion_site/Daftar tersebut harus memuat hostname, hs_ed25519_public_key, hs_ed25519_secret_key, serta direktori authorized_clients yang kosong.
Baca alamat .onion Anda
sudo cat /var/lib/tor/onion_site/hostnameSatu baris ditampilkan: 56 karakter base32 dan .onion. String tersebut merupakan seluruh identitas situs. Tidak ada pihak yang menetapkannya, memindahkannya, atau dapat mengambilnya selama Anda memegang file key. Salin sekarang, karena semua konfigurasi di bawah memerlukannya. Bagian selanjutnya dalam panduan ini menuliskannya sebagai <your-address>.onion.
Sajikan situs dari nginx yang terikat ke 127.0.0.1
sudo apt install -y nginx
sudo install -d -m 755 /srv/onionTulis /etc/nginx/sites-available/onion:
server {
listen 127.0.0.1:8080;
server_name <your-address>.onion;
root /srv/onion;
index index.html;
server_tokens off;
etag off;
access_log off;
error_log /var/log/nginx/onion.error.log error;
}echo '<h1>hello from the onion</h1>' | sudo tee /srv/onion/index.html
sudo ln -s /etc/nginx/sites-available/onion /etc/nginx/sites-enabled/onion
sudo nginx -t
sudo systemctl reload nginxSekarang buktikan dua hal dari server. Pertama, nginx merespons nama onion, yaitu header Host persis yang akan dikirim tor:
curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/Kedua, nginx hanya merespons di alamat tersebut dan tidak di alamat lain:
sudo ss -tlnp | grep 8080Kolom alamat harus berisi 127.0.0.1:8080. Jika berisi 0.0.0.0:8080 atau *:8080, situs onion Anda juga tersedia di Internet publik. Ini adalah item pertama dalam daftar kebocoran. Baris listen 8080; tanpa alamat akan mengikat semua interface, dan itulah perilaku default.
Buka alamat tersebut di Tor Browser. Pemuatan pertama memerlukan beberapa detik saat klien mengambil descriptor Anda dan membangun sirkuit rendezvous.
Dokumentasi resmi Tor Project lebih menyarankan unix socket daripada port loopback: HiddenServicePort 80 unix:/var/run/tor/onion_site.sock, dengan nginx yang mendengarkan pada path tersebut. Socket tidak dapat dijangkau dari host lain, bahkan jika server nantinya memiliki interface kedua. Konsekuensinya adalah pengaturan izin file, karena nginx membuat socket tersebut dan tor terhubung sebagai debian-tor. Jadi, kedua pengguna harus memiliki izin yang sesuai pada direktori tersebut. Loopback dengan output ss yang telah diverifikasi lebih mudah dikonfigurasi dengan benar, dan itulah yang diasumsikan dalam panduan ini.
Jika situs berjalan pada loopback, server sama sekali tidak memerlukan aturan inbound untuk situs tersebut. Biarkan port 22 tetap terbuka untuk Anda dan tolak port lainnya (default ufw yang sebaiknya diatur pada VPS). Ingat bahwa firewall tidak membatalkan service yang terikat ke 0.0.0.0. Firewall hanya memfilter paket yang mencapai firewall. Container membuat hal ini lebih penting karena mempublikasikan port Docker menulis aturan iptables sebelum ufw, sehingga -p 8080:80 menempatkan backend onion Anda pada IP publik, sementara ufw tetap melaporkan port tersebut sebagai ditolak. Publikasikan port container sebagai -p 127.0.0.1:8080:80.
Kebocoran yang menghapus anonimitas onion site
Tor menyembunyikan lokasi server. Tor tidak menyembunyikan apa yang dikirimkan server. Setiap item di bawah ini adalah sesuatu yang dipublikasikan oleh stack Anda sendiri. Membaca batas perlindungan setiap alat privasi berdasarkan fungsi sebenarnya, bukan reputasinya, adalah kebiasaan yang sama yang menjelaskan apa yang disembunyikan SearXNG yang di-host sendiri, yaitu alamat IP Anda dari mesin pencari dan tidak lebih.
Site yang sama merespons pada IP publik Anda
Inilah hal yang sering luput. Scanner terus-menerus mengindeks respons HTTP dari setiap alamat yang dapat dirutekan, dan hasilnya dapat diakses serta dicari secara publik. Sajikan halaman yang sama pada IP publik dan alamat onion Anda, lalu keduanya dapat dihubungkan hanya dengan satu kueri: judul yang sama, hash favicon yang sama, ETag yang sama, serta urutan header yang sama. Baris listen 127.0.0.1:8080; di atas adalah perbaikannya. Verifikasi dari mesin lain, bukan dari server:
curl -sv --max-time 5 http://<your-public-ip>:8080/Connection refused atau timeout adalah hasil yang benar. HTML apa pun berarti site tersebut bersifat publik. Jika box tersebut juga menjalankan site clearnet, berikan root sendiri untuk vhost itu dan pertahankan blok default_server eksplisit pada listener publik, agar header Host yang tidak cocok tidak pernah diteruskan ke vhost onion.
Banner versi
curl -sI http://127.0.0.1:8080/ | grep -i '^server'nginx default merespons dengan Server: nginx/1.24.0. String versi tersebut, bersama urutan persis header lainnya, menjadi fingerprint yang dapat menghubungkan onion Anda dengan host clearnet. server_tokens off; menguranginya menjadi Server: nginx. Ini tidak menghapus header tersebut, dan nginx tidak memiliki directive bawaan untuk melakukannya. Karena itu, modul headers-more biasanya digunakan jika Anda ingin menghapusnya. PHP menambahkan X-Powered-By sampai Anda menetapkan expose_php = Off. etag off; juga harus dimasukkan ke daftar yang sama, karena nginx membentuk ETag dari waktu modifikasi dan ukuran file. Dengan demikian, file yang sama dan disalin ke dua server akan menghasilkan ETag yang sama pada keduanya.
URL absolut yang mengarah ke domain clearnet Anda
Tag rel="canonical", og:url Open Graph, RSS feed, sitemap, email pengaturan ulang kata sandi, atau URL logo yang ditulis langsung dalam kode. Salah satu saja sudah cukup untuk mencantumkan site clearnet di dalam halaman yang disajikan melalui onion. Gunakan path relatif terhadap root seperti /static/logo.svg, dan biarkan aplikasi membaca base URL dari host dalam request, bukan dari konstanta. Redirect merupakan bug yang sama di tempat lain: return 301 https://example.com$request_uri; dalam blok catch-all mengarahkan pengunjung onion ke domain nyata Anda, sedangkan header Location memberikan jawabannya secara langsung.
Sertifikat TLS yang digunakan bersama site clearnet
Alamat onion mengautentikasi dirinya sendiri karena alamat tersebut adalah public key. Karena itu, http:// melalui koneksi onion sudah terenkripsi end-to-end, dan Tor Browser memperlakukannya sebagai secure context. Memasang sertifikat yang sudah ada pada vhost onion memublikasikan hubungan antara keduanya, karena setiap sertifikat yang dipercaya secara publik dicatat dalam log Certificate Transparency, dan log tersebut bersifat publik, permanen, serta dapat dicari berdasarkan nama. Simpan sertifikat Let's Encrypt pada vhost clearnet dan biarkan vhost onion menggunakan HTTP biasa.
Font pihak ketiga dan analytics
Font dari CDN (content delivery network) atau script analytics. Browser pengunjung mengambil masing-masing item tersebut secara langsung, sehingga pihak ketiga mengetahui bahwa seseorang memuat halaman Anda dan biasanya juga mengetahui halaman yang dimuat. Level keamanan Tor Browser yang lebih ketat juga memblokir request tersebut, sehingga tata letak menjadi rusak. Host sendiri setiap asset yang diperlukan halaman.
Ketidaksesuaian header Host
Jika server_name tidak cocok dengan header Host yang dikirim tor, nginx akan menggunakan server default untuk alamat listen tersebut. Pada box dengan satu vhost, hal ini tidak terlihat karena satu-satunya server block juga merupakan server default. Jika Anda menambahkan vhost clearnet nanti, request onion dapat mulai diarahkan ke vhost tersebut, lengkap dengan canonical tag dan redirect-nya. Jalankan kembali pemeriksaan curl -H 'Host: ...' setiap kali mengubah nginx, lalu gunakan grep pada hasilnya untuk mencari domain nyata Anda:
curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/ | grep -o 'https\?://[^"]*' | sort -uMengetahui proses mana yang memiliki socket mana mencakup sebagian besar pekerjaan ini (cara kerja port dan listening socket di Linux).
Apa yang masih tersisa di log
Setiap request datang dari 127.0.0.1, sehingga nginx tidak memiliki alamat pengunjung untuk dicatat dan access_log off; tidak membebani Anda. Aplikasi di atasnya merupakan hal yang berbeda, karena order, alamat email, atau metadata file yang diunggah harus Anda tangani. Kebiasaan Anda sendiri juga berpengaruh: mengelola box melalui login yang belum diperkuat berada di luar perlindungan Tor. Karena itu, anggap penguatan SSH pada VPS yang sama sebagai bagian dari build ini.
Cadangkan private key karena key tersebut merupakan alamat
/var/lib/tor/onion_site/hs_ed25519_secret_key adalah service. Tidak ada registrar dan tidak ada mekanisme pemulihan. Jika key hilang, alamat tersebut juga hilang. Salin key tersebut, dan siapa pun yang memegang salinannya dapat menyajikan konten mereka sendiri pada alamat Anda tanpa cara bagi Anda untuk mencabut akses apa pun.
sudo systemctl stop tor@default
sudo tar -C /var/lib/tor -czf onion-keys.tgz onion_site
sudo chmod 600 onion-keys.tgz
sudo systemctl start tor@defaultEnkripsi arsip tersebut (gpg -c onion-keys.tgz), lalu pindahkan ke luar server. Untuk memulihkannya pada VPS baru, tor mengharapkan arsip dan kepemilikan berikut:
sudo systemctl stop tor@default
sudo tar -C /var/lib/tor -xzf onion-keys.tgz
sudo chown -R debian-tor:debian-tor /var/lib/tor/onion_site
sudo chmod 700 /var/lib/tor/onion_site
sudo systemctl start tor@default
sudo cat /var/lib/tor/onion_site/hostnameAlamat yang sama akan kembali pada hardware baru satu atau dua menit setelah tor menerbitkan ulang descriptor. Itulah seluruh proses migrasi: tidak perlu mengubah DNS dan tidak perlu menerbitkan ulang sertifikat.
Onion-Location saat situs juga tersedia di clearnet
Jika alamat onion digunakan untuk kemudahan akses, bukan kerahasiaan, umumkan alamat tersebut dari vhost clearnet:
add_header Onion-Location http://<your-address>.onion$request_uri;Tor Browser kemudian menampilkan tombol .onion available di bilah alamat dan menawarkan perpindahan. Header ini hanya dipatuhi jika halaman clearnet disajikan melalui HTTPS dan nilainya merupakan URL onion yang valid.
Ada satu aturan nginx yang perlu diperhatikan. Direktif add_header diwariskan oleh blok location hanya jika blok tersebut tidak mendeklarasikan direktifnya sendiri. Karena itu, location yang memiliki add_header sendiri akan menghilangkan Onion-Location secara diam-diam. Ulangi direktif tersebut di sana, atau simpan semua header respons di satu tempat. Publikasi header ini secara sengaja menghubungkan kedua situs. Hal itu benar untuk mirror, tetapi keliru untuk situs yang harus tetap tidak terhubung.
Alamat vanity
mkp224o menghasilkan pasangan kunci hingga salah satunya menghasilkan alamat yang diawali dengan prefiks yang Anda minta. Proses ini merupakan pencarian brute force. Tidak ada yang perlu dikonfigurasi selain prefiks dan lamanya waktu yang bersedia Anda tunggu.
sudo apt install -y git gcc libc6-dev libsodium-dev make autoconf
git clone https://github.com/cathugger/mkp224o
cd mkp224o
./autogen.sh
./configure --enable-amd64-51-30k
make
./mkp224o -d onionkeys blogSetiap alamat yang ditemukan disimpan di onionkeys/<address>.onion/, yang berisi hostname dan hs_ed25519_secret_key. Instal alamat tersebut dengan menghentikan tor, menyalin direktori itu ke HiddenServiceDir, lalu menerapkan chown dan chmod 700 yang sama seperti pada proses pemulihan sebelumnya.
Panjang prefiks menentukan seluruh biaya proses. Alamat tersebut menggunakan base32, sehingga setiap karakter tambahan yang Anda minta meningkatkan jumlah kunci yang diharapkan sebanyak 32 kali lipat. Prefiks pendek dapat selesai di laptop. Prefiks panjang tidak akan selesai pada perangkat apa pun yang Anda miliki. Prefiks vanity juga membiasakan pembaca mengenali beberapa karakter pertama, bukan seluruh alamat. Kebiasaan inilah yang dimanfaatkan oleh salinan situs onion untuk melakukan phishing.
Mode kegagalan dan string yang akan Anda lihat
Tidak ada file hostname setelah restart. Tor tidak berjalan atau menolak direktori tersebut. sudo journalctl -u tor@default -n 50 menampilkan penyebabnya:
/var/lib/tor/onion_site/ is not owned by this user (debian-tor, 108) but by root (0). Perhaps you are running Tor as the wrong user?Seperti itulah tampilan direktori yang dibuat secara manual. Perbaiki kepemilikan dan modenya, atau hapus direktori tersebut dan biarkan tor membuatnya.
Tor Browser menampilkan Onionsite Not Found (0xF0). Klien tidak dapat mengambil descriptor. Dari sudut pandang jaringan, tidak ada apa pun yang dipublikasikan pada alamat tersebut. Pastikan tor berjalan dan telah menyelesaikan bootstrap, lalu periksa waktu sistem. Tor memerlukan waktu yang akurat untuk memublikasikan dan memvalidasi descriptor, dan timedatectl seharusnya melaporkan System clock synchronized: yes. Kesalahan pengetikan alamat jarang menjadi penyebabnya. Alamat v3 memiliki checksum dua byte, sehingga alamat yang salah ketik hampir selalu gagal dalam pemeriksaan tersebut dan Tor Browser menampilkan Invalid Onionsite Address (0xF6). Jika melihat pesan itu, salin kembali alamat dari sudo cat /var/lib/tor/onion_site/hostname.
Alamat berhasil di-resolve, tetapi halaman tidak pernah dimuat. Tor menyelesaikan rendezvous, lalu gagal pada hop terakhir, yaitu dari tor ke nginx. Hop tersebut bersifat lokal, sehingga log tor tetap tidak menampilkan apa pun. Jalankan curl -sI http://127.0.0.1:8080/ pada server. Connection refused berarti nginx berhenti atau mendengarkan pada alamat yang berbeda dari alamat yang ditunjuk oleh HiddenServicePort.
Halaman dimuat, tetapi setiap link mengarah ke domain asli Anda. Penyebabnya adalah URL absolut dalam template. Jalankan pemeriksaan grep -o 'https\?://[^"]*' di atas dan perbaiki hasilnya sebelum membagikan alamat tersebut di mana pun.
Berfungsi, lalu berhenti setelah reboot. Lakukan reboot pada mesin sekali secara sengaja sebelum mengandalkan situs tersebut, lalu jalankan sudo systemctl status tor@default dan sudo systemctl status nginx. Service yang dijalankan seseorang secara manual terlihat sama seperti service yang diaktifkan sampai mesin di-restart.
FAQ
Apakah saya perlu membuka port di firewall untuk layanan onion Tor?
Tidak. Daemon tor hanya membuat koneksi keluar ke server direktori, introduction point, dan setiap relay rendezvous. Karena itu, aturan masuk tidak diperlukan, dan web server itu sendiri listen pada 127.0.0.1. Biarkan ufw menggunakan kebijakan default deny untuk trafik masuk, dengan SSH tetap diizinkan. Sifat yang sama memungkinkan layanan onion berjalan dari mesin di belakang NAT (network address translation) tanpa alamat IP publik sama sekali.
Mengapa alamat .onion saya tidak dapat diakses di Tor Browser?
Lakukan pemeriksaan dari server ke luar. sudo journalctl -u tor@default -n 50 seharusnya menampilkan Bootstrapped 100% (done): Done, kemudian curl -sI http://127.0.0.1:8080/ di server seharusnya mengembalikan baris status. Alamat yang salah ketik hampir tidak pernah mengarah ke layanan lain, karena alamat v3 memiliki checksum. Tor Browser akan menolaknya sebagai Invalid Onionsite Address (0xF6), sehingga Anda harus menyalinnya kembali dari file hostname. Onionsite Not Found (0xF0) berarti tidak ada descriptor yang ditemukan untuk alamat tersebut. Biasanya, ini berarti tor tidak berjalan atau jam sistem salah.
Dapatkah saya memindahkan situs onion ke server baru dan mempertahankan alamat yang sama?
Ya. Alamat tersebut diturunkan dari hs_ed25519_secret_key. Karena itu, salin seluruh HiddenServiceDir ke mesin baru, tetapkan kepemilikan debian-tor dan mode 700, lalu jalankan tor. Alamat akan aktif kembali setelah descriptor dipublikasikan ulang, dan tidak ada record DNS yang perlu diperbarui. Jika file tersebut hilang, alamat tidak dapat dipulihkan. Karena itu, cadangkan file tersebut dalam bentuk terenkripsi di luar server pada hari pembuatannya.
Apakah situs onion memerlukan sertifikat HTTPS?
Tidak. Alamat sepanjang 56 karakter tersebut adalah public key layanan. Dengan demikian, koneksi sudah dienkripsi dan diautentikasi secara end-to-end, dan Tor Browser memperlakukan http:// pada nama .onion sebagai secure context. Menggunakan kembali sertifikat clearnet pada onion vhost lebih buruk daripada tidak melakukan apa pun, karena log Certificate Transparency bersifat publik dan mencatat secara permanen nama-nama yang menggunakan sertifikat yang sama. Satu-satunya alasan membeli sertifikat untuk nama .onion adalah untuk memberikan jaminan merek dari CA yang menerbitkannya. Tautan tersebut memang dirancang untuk bersifat publik.