Paano Mag-host ng .onion Site sa VPS
Magpatakbo ng v3 onion service sa Ubuntu gamit ang tor at nginx sa loopback. Alamin ang eksaktong config para maiwasang maiugnay ang .onion address sa public IP.
Ang binubuo mo
Ang onion site ay isang karaniwang web server na tumutugon lamang sa Tor network. I-install ang tor, magdagdag ng dalawang linya sa /etc/tor/torrc, basahin ang address na isinusulat ng tor para sa iyo, at i-bind ang nginx sa 127.0.0.1 upang walang tumugon sa public IP. Sampung minuto ang kailangan para sa installation. Ang natitirang bahagi ng guide na ito ay listahan ng mga posibleng leak, dahil karaniwang nagkakaroon ng problema ang onion site kapag ang sarili nitong configuration ay direktang tumuturo pabalik sa operator.
Nagsimula ang Tor bilang “the onion router,” at ang onion service ay isang service na maaabot lamang sa pamamagitan nito. Ang version 3 address ay may 56 character na sinusundan ng .onion. Ang mga character na ito ay ed25519 public key ng service, kasama ang checksum at version byte, na naka-encode sa base32. Inalis sa network ang version 2 address na may 16 character noong 2021, kaya v3 ang anumang gagawin mo ngayon. Ang address mismo ang key, at may dalawang epekto ito. Naka-encrypt at authenticated end to end ang connection nang walang certificate authority. Kapag nawala ang key file, tuluyan ding mawawala ang address.
Hindi kailanman tumatanggap ang server mo ng inbound connection. Pumipili ang Tor ng ilang relay bilang introduction point, nag-a-upload ng signed descriptor sa directory server, at nakikipagkita sa bawat visitor sa rendezvous relay na pinili ng visitor. Outbound mula sa server mo ang lahat ng connection na ito. Walang port na kailangang buksan at walang DNS record na kailangang i-publish. Kung gusto mong magbigay ang parehong VPS ng serbisyo pabalik sa network, ibang gawain iyon na kabaligtaran ang setup, dahil ang obfs4 bridge ay tumatanggap ng inbound connection mula sa mga censored client at nangangailangan ng reachable port.
Mag-install ng tor mula sa Tor Project repository
May tor package ang Ubuntu sa universe at ina-update ito pagkatapos ng release sa pamamagitan ng updates pocket, ngunit nahuhuli ito sa upstream. Noong 2026-10-11, may 0.4.9.11 ang noble-updates, samantalang nailabas na ng Tor Project ang 0.4.9.14 at inihahatid na ito mula sa sarili nitong repository. Sinusubaybayan ng repository na iyon ang kasalukuyang stable release habang inilalabas ito. Ito ang kailangan mo para sa software na nagpapasya kung mananatiling sa iyo ang iyong address. Ang pagkakaroon ng package sa isang distribution ay hindi nangangahulugang aktibo pa itong mina-maintain. Mahalagang suriin ito sa anumang self-hosted na software, dahil walang code commit ang Searx mula pa noong 2023, samantalang ipinagpapatuloy ng SearXNG ang proyektong iyon.
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/nullGumagamit ang repository entry ng deb822 format, at dapat na Ubuntu codename mo ang Suites. Basahin ito mula sa /etc/os-release sa halip na manu-manong i-type. Kapag mali ang codename, maayos na nareresolba ang repository ngunit wala itong mga package para sa release mo.
. /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-keyringPinananatiling napapanahon ng deb.torproject.org-keyring package ang signing key, kaya hindi masisira ang apt update pagkalipas ng isang taon kapag nagkaroon ng key rotation. Suriin kung nagsimula ang tor at nakakonekta ito sa network:
tor --version
sudo journalctl -u tor@default -n 20Dapat magtapos ang journal sa Bootstrapped 100% (done): Done. Kapag nananatili ang tor sa Bootstrapped 10%, wala itong outbound path. Suriin ang network firewall ng provider mo at ang sarili mong egress rules: dapat ipakita ng sudo ufw status verbose ang allow (outgoing) bilang default.
Dalawang pangalan ang mahalaga mula rito. Pinapatakbo ng package ang tor bilang user na debian-tor, at ang tumatakbong unit ay tor@default.service, dahil wrapper ang tor.service sa Debian at Ubuntu para sa instance. Humingi ng status at logs gamit ang pangalan ng instance upang palagi mong makuha ang aktuwal na proseso.
I-configure ang onion service sa torrc
Idagdag ang dalawang linya sa /etc/tor/torrc:
HiddenServiceDir /var/lib/tor/onion_site/
HiddenServicePort 80 127.0.0.1:8080Ang HiddenServiceDir ang lokasyon kung saan iniimbak ng Tor ang mga key at address para sa service na ito. Huwag mo itong gawin nang mano-mano. Ginagawa ito ng Tor sa pagsisimula, gamit ang kinakailangang owner at mode. Kapag ginawa mo ang directory bilang root, lalabas ang unang failure sa listahan ng mga failure sa ibaba.
May dalawang bahagi ang HiddenServicePort, at ang pagpapalit sa pagkakasunod ng mga ito ang karaniwang unang pagkakamali. Ang unang numero ay ang port na kinokonektahan ng visitor sa loob ng tunnel, kaya ang 80 ang karaniwang inaasahan at wala itong kailangang baguhin. Ang ikalawang bahagi ay ang local address kung saan ipinapasa ng Tor ang traffic. Ang isang simpleng HiddenServicePort 80 ay nagpapasa sa 127.0.0.1:80. Kaya, kapag isinulat nang buo ang address at gumamit ng high port, hindi maaapektuhan ng onion vhost ang anumang kasalukuyang nakikinig sa port 80.
sudo systemctl restart tor@default
sudo ls -l /var/lib/tor/onion_site/Dapat naglalaman ang listing ng hostname, hs_ed25519_public_key, hs_ed25519_secret_key, at isang walang-lamang authorized_clients directory.
Basahin ang iyong .onion address
sudo cat /var/lib/tor/onion_site/hostnameIsang linya ang lalabas: 56 na base32 character at .onion. Ang string na iyon ang buong identity ng site. Walang nagtatalaga nito, walang makapaglilipat nito, at walang makakakuha nito habang nasa iyo ang key file. Kopyahin ito ngayon dahil kailangan ito ng lahat ng configuration sa ibaba. Isinusulat ito ng natitirang bahagi ng gabay na ito bilang <your-address>.onion.
Ihatid ang site mula sa nginx na nakabind sa 127.0.0.1
sudo apt install -y nginx
sudo install -d -m 755 /srv/onionIsulat ang /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 nginxNgayon, patunayan ang dalawang bagay mula sa server. Una, tumutugon ang nginx para sa onion name, na siyang eksaktong Host header na ipapadala ng tor:
curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/Ikalawa, tumutugon ito roon at wala nang iba pa:
sudo ss -tlnp | grep 8080Dapat 127.0.0.1:8080 ang mabasa sa address column. Kung 0.0.0.0:8080 o *:8080 ang mabasa, nasa public internet din ang onion site mo. Ito ang unang item sa listahan ng mga leak. Ang listen 8080; line na walang address ay nagb-bind sa lahat ng interface. Ito ang default.
Buksan ang address sa Tor Browser. Aabutin ng ilang segundo ang unang load habang kinukuha ng client ang descriptor mo at bumubuo ng rendezvous circuit.
Mas pinapaboran ng sariling documentation ng Tor Project ang unix socket kaysa loopback port: HiddenServicePort 80 unix:/var/run/tor/onion_site.sock, kung saan nakikinig ang nginx sa path na iyon. Hindi maaabot mula sa ibang host ang socket, kahit magkaroon pa ang box ng ikalawang interface. Ang kapalit nito ay file permissions, dahil ginagawa ng nginx ang socket at kumokonekta rito ang tor bilang debian-tor. Kaya kailangang magkasundo ang dalawang user sa directory. Mas madaling i-configure nang tama ang loopback kapag na-verify ang output ng ss, at ito ang ipinapalagay ng natitirang bahagi ng guide na ito.
Kapag nasa loopback ang site, hindi na kailangan ng box ng inbound rule para rito. Panatilihing bukas ang 22 para sa sarili mong access at i-deny ang iba (mga ufw default na dapat i-set sa isang VPS). Tandaan na hindi ina-undo ng firewall ang isang service na nagbi-bind sa 0.0.0.0. Sinasala lamang nito ang mga packet na umaabot sa firewall. Mas mahalaga ito sa mga container, dahil ang pag-publish ng Docker port ay nagsusulat ng iptables rules bago ang ufw. Dahil dito, inilalagay ng -p 8080:80 ang onion backend sa public IP kahit iniulat pa rin ng ufw na denied ang port. I-publish ang mga container port bilang -p 127.0.0.1:8080:80.
Mga leak na nag-aalis ng anonymity ng isang onion site
Itinatago ng Tor kung nasaan ang server. Walang itinatago ang Tor tungkol sa sinasabi ng server. Ang bawat item sa ibaba ay inilalabas ng sarili mong stack. Ang pagbasa sa anumang privacy tool batay sa aktuwal nitong saklaw, hindi sa reputasyon nito, ay kaparehong gawi na nagpapaliwanag kung ano ang itinatago ng isang self-hosted SearXNG, at na ang IP address mo lamang ang itinatago nito mula sa mga search engine.
Ang parehong site na sumasagot sa public IP mo
Ito ang madalas nakakaligtaan. Patuloy na ini-index ng mga scanner ang HTTP response ng bawat routable address, at public at searchable ang mga resultang iyon. Kung ihahatid mo ang parehong page sa public IP mo at sa onion address, isang query lang ang kailangan para pagdugtungin ang mga ito: parehong title, parehong favicon hash, parehong ETag, at parehong pagkakasunod-sunod ng mga header. Ang listen 127.0.0.1:8080; line sa itaas ang solusyon. I-verify ito mula sa ibang machine, hindi mula sa server:
curl -sv --max-time 5 http://<your-public-ip>:8080/Ang Connection refused o timeout ang tamang resulta. Anumang HTML ay nangangahulugang public ang site. Kung may clearnet site din ang box, bigyan ang vhost na iyon ng sarili nitong root at panatilihin ang isang tahasang default_server block sa public listener, upang hindi kailanman mapunta ang hindi tumugmang Host header sa onion vhost.
Mga version banner
curl -sI http://127.0.0.1:8080/ | grep -i '^server'Ang default na nginx ay sumasagot ng Server: nginx/1.24.0. Ang version string na iyon, kasama ang eksaktong pagkakasunod-sunod ng iba pang mga header, ay fingerprint na maaaring magtugma sa onion site mo at sa clearnet host mo. Binabawasan ito ng server_tokens off; sa Server: nginx. Hindi nito inaalis ang header, at walang built-in directive ang nginx para gawin iyon, kaya karaniwang ginagamit ang headers-more module kung gusto mo itong tuluyang alisin. Nagdaragdag ang PHP ng X-Powered-By hanggang itakda mo ang expose_php = Off. Kasama sa parehong listahan ang etag off;, dahil binubuo ng nginx ang ETag mula sa modification time at size ng file, kaya ang parehong file na kinopya sa dalawang server ay nagbibigay ng parehong ETag sa pareho.
Mga absolute URL na tumuturo sa clearnet domain mo
Isang rel="canonical" tag, isang Open Graph og:url, RSS feed, sitemap, password reset email, o hardcoded logo URL. Kahit isa sa mga ito ay maaaring magbanggit ng clearnet site sa loob ng page na ihinahatid sa onion. Gumamit ng root-relative path gaya ng /static/logo.svg, at hayaang basahin ng application ang base URL nito mula sa request host sa halip na mula sa isang constant. Pareho ring bug ang mga redirect sa ibang lugar: ipinapadala ng return 301 https://example.com$request_uri; sa catch-all block ang onion visitor sa totoong domain mo, at direktang ibinibigay sa kanila ng Location header ang sagot.
TLS certificate na kapareho ng gamit ng clearnet site
Ina-authenticate ng onion address ang sarili nito dahil ang address ang public key, kaya ang http:// sa onion connection ay naka-encrypt na end to end at itinuturing ito ng Tor Browser bilang secure context. Kapag inilagay mo ang dati mong certificate sa onion vhost, inilalabas nito ang ugnayan ng dalawa, dahil itinatala ang bawat publicly trusted certificate sa Certificate Transparency logs, at ang mga log na iyon ay public, permanent, at searchable ayon sa pangalan. Panatilihin ang Let's Encrypt certificates sa clearnet vhost at iwan ang onion vhost sa plain HTTP.
Mga third-party font at analytics
Font mula sa CDN (content delivery network), o analytics script. Direktang kinukuha ng browser ng visitor ang bawat isa, kaya nalalaman ng third party na may nag-load ng page mo at karaniwan kung aling page iyon. Hinaharang din naman ng mas mahigpit na security level ng Tor Browser ang request, kaya maaaring masira ang layout. I-self-host ang bawat asset na kailangan ng page.
Hindi nagtutugmang Host header
Kung hindi tumutugma ang server_name sa Host header na ipinapadala ng tor, nagfa-fallback ang nginx sa default server para sa listen address na iyon. Sa box na may isang vhost, hindi ito mapapansin dahil ang nag-iisang server block ang default din. Kung magdagdag ka kalaunan ng clearnet vhost, maaaring mapunta rito ang mga onion request, kasama ang canonical tags at mga redirect nito. Ulitin ang curl -H 'Host: ...' check pagkatapos ng bawat pagbabago sa nginx, at i-grep ang resulta para sa totoong domain mo:
curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/ | grep -o 'https\?://[^"]*' | sort -uMalaking bahagi ng gawaing ito ang pagtukoy kung aling process ang nagmamay-ari ng aling socket (kung paano gumagana ang mga port at listening socket sa Linux).
Ano ang naiiwan sa mga log
Dumarating ang bawat request mula sa 127.0.0.1, kaya walang visitor address na maire-record ang nginx at walang gastos sa iyo ang access_log off;. Iba ang application sa itaas nito, dahil ikaw ang may pananagutan sa paghawak ng order, email address, o metadata ng na-upload na file. Mahalaga rin ang sarili mong mga gawi: ang pag-administer ng box gamit ang hindi hardened na login ay hindi saklaw ng anumang proteksiyong ibinibigay ng Tor, kaya ituring ang SSH hardening sa parehong VPS bilang bahagi ng build na ito.
Mag-backup ng private key, dahil ito ang address
/var/lib/tor/onion_site/hs_ed25519_secret_key ang service. Walang registrar at walang recovery. Kapag nawala ito, mawawala ang address. Kopyahin ito, at maaaring mag-serve ng sarili nilang content sa address mo ang sinumang may hawak ng kopya, nang wala kang paraan para i-revoke ang anuman.
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@defaultI-encrypt ang archive na iyon (gpg -c onion-keys.tgz) at ilipat ito palabas ng server. Ang pag-restore sa bagong VPS ay binubuo ng archive at ng ownership na inaasahan ng tor:
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/hostnameBabalik ang parehong address sa bagong hardware, isa o dalawang minuto matapos muling i-publish ng tor ang descriptor. Iyon lang ang buong migration: walang pagbabago sa DNS at walang muling pag-isyu ng certificate.
Onion-Location kapag nasa clearnet din ang site
Kung convenience lang ang onion address at hindi ito lihim, i-advertise ito mula sa clearnet vhost:
add_header Onion-Location http://<your-address>.onion$request_uri;Ipapakita ng Tor Browser ang .onion available button sa address bar at iaalok ang paglipat. Tinatanggap lang ang header kapag inihahatid ang clearnet page sa HTTPS at valid na onion URL ang value.
May isang mahalagang tuntunin sa nginx. Namamana lang ng isang location block ang mga add_header directive kapag wala itong sarili nitong mga directive, kaya tahimik na inaalis ng location na may sarili nitong add_header ang Onion-Location. Ulitin ang header doon, o ilagay sa iisang lugar ang lahat ng response header. Sinasadyang pinag-uugnay ng pag-publish ng header na ito ang dalawang site. Tama ito para sa mirror, pero mali para sa anumang site na dapat manatiling hindi magkakaugnay.
Mga Vanity Address
Ang mkp224o ay paulit-ulit na gumagawa ng mga key pair hanggang sa may makabuo ng address na nagsisimula sa prefix na hiniling mo. Brute-force search ito, kaya wala nang kailangang i-configure bukod sa prefix at kung gaano katagal kang handang maghintay.
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 blogNapupunta ang bawat nahanap na address sa onionkeys/<address>.onion/ na naglalaman ng hostname at hs_ed25519_secret_key. Para mag-install ng isa, ihinto ang tor, kopyahin ang directory na iyon sa iyong HiddenServiceDir, at pagkatapos ay ilapat ang parehong chown at chmod 700 na ginamit sa restore sa itaas.
Ang haba ng prefix ang pangunahing katumbas na gastos. Base32 ang address, kaya sa bawat karagdagang character na hinihingi mo, namumultiply nang 32 ang inaasahang dami ng key na kailangang subukan. Mabilis matapos ang maikling prefix sa isang laptop. Hindi matatapos ang mahaba sa anumang device na pagmamay-ari mo. Itinuturo rin ng vanity prefix sa mga mambabasa na kilalanin ang unang ilang character sa halip na ang buong address. Ito ang ugaling sinasamantala ng mga phishing copy ng onion site.
Mga failure mode at ang mga string na makikita mo
Walang hostname file pagkatapos ng restart. Hindi nagsimula ang Tor, o tinanggihan nito ang directory. Tinutukoy ito ng sudo journalctl -u tor@default -n 50:
/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?Ganito ang hitsura ng directory na mano-manong ginawa. Ayusin ang ownership at mode nito, o burahin ang directory at hayaang gawin ito ng tor.
Ipinapakita ng Tor Browser ang Onionsite Not Found (0xF0). Hindi nakakuha ang client ng descriptor, kaya para sa network ay walang nai-publish sa address na iyon. Tiyaking tumatakbo at naka-bootstrap ang tor, pagkatapos ay suriin ang orasan. Kailangan ng Tor ng tamang oras para mag-publish at mag-validate ng mga descriptor, at dapat iulat ng timedatectl ang System clock synchronized: yes. Bihirang typo sa address ang sanhi nito. May two-byte checksum ang v3 address, kaya halos palaging hindi papasa sa check na iyon ang maling address at sa halip ay ipapakita ng Tor Browser ang Invalid Onionsite Address (0xF6). Kapag nakita mo ito, kopyahin muli ang address mula sa sudo cat /var/lib/tor/onion_site/hostname.
Naresolba ang address pero hindi kailanman naglo-load ang page. Nakumpleto ng Tor ang rendezvous, pero nabigo ito sa huling hop, mula tor papunta sa nginx. Local ang hop na iyon kaya walang lumalabas sa tor log. Patakbuhin ang curl -sI http://127.0.0.1:8080/ sa server. Ibig sabihin ng Connection refused ay down ang nginx o nakikinig ito sa ibang address kaysa sa tinutukoy ng HiddenServicePort.
Naglo-load ang page pero napupunta ang bawat link sa tunay mong domain. Absolute URLs ang nasa templates. Patakbuhin ang grep -o 'https\?://[^"]*' check sa itaas at ayusin ang inilalabas nito bago mo ibahagi ang address kahit saan.
Gumagana ito, pero humihinto pagkatapos ng reboot. Sadyang i-reboot nang isang beses ang machine bago mo asahan ang site, pagkatapos ay patakbuhin ang sudo systemctl status tor@default at sudo systemctl status nginx. Magkapareho ang hitsura ng serbisyong mano-manong sinimulan at ng enabled na service hanggang sa mag-restart ang machine.
FAQ
Kailangan ko bang magbukas ng port sa firewall para sa Tor onion service?
Hindi. Ang tor daemon ay gumagawa lamang ng outbound connections papunta sa directory servers, introduction points nito, at bawat rendezvous relay. Kaya walang inbound rule na kailangan, at ang web server mismo ay nakikinig sa 127.0.0.1. Panatilihing default deny sa incoming traffic ang ufw, habang pinapayagan ang SSH. Dahil dito, gumagana ang onion service mula sa machine na nasa likod ng NAT (network address translation), kahit wala itong public IP.
Bakit hindi ko maabot ang aking .onion address sa Tor Browser?
Magsimula sa server at mag-troubleshoot palabas. Dapat ipakita ng sudo journalctl -u tor@default -n 50 ang Bootstrapped 100% (done): Done, pagkatapos ay dapat magbalik ng status line ang curl -sI http://127.0.0.1:8080/ sa server. Halos hindi kailanman napupunta ang maling address sa ibang service, dahil may checksum ang v3 address. Dahil dito, tatanggihan ito ng Tor Browser bilang Invalid Onionsite Address (0xF6), kaya kopyahin itong muli mula sa hostname file. Ibig sabihin ng Onionsite Not Found (0xF0) ay walang descriptor na natagpuan para sa address. Karaniwan itong nangangahulugang hindi tumatakbo ang tor o mali ang system clock.
Maaari ko bang ilipat ang aking onion site sa bagong server at panatilihin ang parehong address?
Oo. Hinango ang address mula sa hs_ed25519_secret_key. Kopyahin ang buong HiddenServiceDir sa bagong machine, itakda ang ownership nito sa debian-tor at ang mode sa 700, pagkatapos ay simulan ang tor. Gagana muli ang address kapag nai-publish na muli ang descriptor, at walang DNS record na kailangang i-update. Kapag nawala ang file na iyon, hindi na mababawi ang address. Kaya i-back up ito nang naka-encrypt at nasa labas ng server sa mismong araw na ginawa ito.
Kailangan ba ng HTTPS certificate ang isang onion site?
Hindi. Ang 56-character na address ang public key ng service. Dahil dito, encrypted at authenticated na end to end ang connection, at itinuturing ng Tor Browser na secure context ang http:// sa .onion name. Mas masama pa sa walang gawin ang muling paggamit ng iyong clearnet certificate sa onion vhost, dahil public ang Certificate Transparency logs at permanenteng itinatala ng mga ito kung aling mga name ang gumagamit ng parehong certificate. Ang tanging dahilan para bumili ng certificate para sa .onion name ay ang brand assurance mula sa CA na nag-iisyu ng mga ito, at public ang link na iyon ayon sa disenyo.