SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor · Оновлено 2026-10-14

Як розмістити .onion-сайт на VPS

Налаштуйте v3 onion-сервіс на Ubuntu: tor і nginx працюють через loopback, а перевірки допомагають не розкрити зв’язок адреси з публічною IP-адресою.

Що ви створюєте

Onion-сайт — це звичайний вебсервер, який відповідає лише через мережу Tor. Встановіть tor, додайте два рядки до /etc/tor/torrc, прочитайте адресу, яку tor запише для вас, а потім налаштуйте nginx на прослуховування 127.0.0.1, щоб сервер не відповідав на публічній IP-адресі. Установлення займає 10 хвилин. Решта цього посібника присвячена переліку можливих витоків, оскільки найчастіше onion-сайт виходить з ладу через те, що його власна конфігурація напряму вказує назад на оператора.

Tor спочатку називався "the onion router", а onion-сервіс — це сервіс, доступний лише через Tor. Адреса версії 3 містить 56 символів, за якими йде .onion. Ці символи є відкритим ключем сервісу ed25519, контрольною сумою та байтом версії, закодованими в base32. Адреси версії 2 (16 символів) вилучили з мережі у 2021 році, тому все, що ви створюєте сьогодні, є v3. Адреса і є ключем, і це має два наслідки. З’єднання шифрується та автентифікується наскрізним шифруванням без участі центру сертифікації, а втрата файлу ключа означає остаточну втрату адреси.

Ваш сервер ніколи не приймає вхідних з’єднань. Tor обирає кілька relay-вузлів як introduction points, завантажує підписаний дескриптор на directory-сервери та встановлює з’єднання з кожним відвідувачем через rendezvous relay, який обрав відвідувач. Усі ці з’єднання є вихідними з вашого сервера. Відкривати порт і публікувати DNS-запис не потрібно. Якщо ви хочете, щоб той самий VPS надавав мережі іншу послугу, це окреме завдання з протилежною схемою, оскільки міст obfs4 приймає вхідні з’єднання від клієнтів у цензурованих мережах і потребує доступного порту.

Встановлення tor з репозиторію Tor Project

Ubuntu постачає пакет tor у компоненті universe і оновлює його після випуску через pocket updates, але пакет відстає від upstream. 2026-10-11 у noble-updates був доступний пакет версії 0.4.9.11, тоді як Tor Project уже випустив версію 0.4.9.14 і надавав її через власний репозиторій. Цей репозиторій відстежує поточний стабільний випуск одразу після його виходу. Саме це потрібно для компонента, який визначає, чи залишиться ваша адреса під вашим контролем. Наявність пакета в дистрибутиві нічого не говорить про те, чи продовжується його розробка. Це варто перевіряти для всього, що ви розміщуєте самостійно, оскільки Searx не має комітів із кодом із 2023 року, тоді як SearXNG продовжує розвивати цей проєкт.

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/null

Запис репозиторію використовує формат deb822, а Suites має містити кодову назву вашої Ubuntu. Прочитайте її з /etc/os-release, а не вводьте вручну, оскільки неправильна кодова назва дає репозиторій, який успішно обробляється, але не містить пакетів для вашого випуску.

. /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-keyring

Пакет deb.torproject.org-keyring підтримує ключ підпису в актуальному стані, тому ротація ключа не зламає apt update через рік. Перевірте, що tor запустився та підключився до мережі:

tor --version
sudo journalctl -u tor@default -n 20

Журнал має завершуватися повідомленням Bootstrapped 100% (done): Done. Якщо tor застряг на стані Bootstrapped 10%, він не має вихідного маршруту. Перевірте мережевий firewall вашого провайдера та власні правила вихідного трафіку: sudo ufw status verbose має показувати allow (outgoing) як маршрут за замовчуванням.

Надалі важливі два імені. Пакет запускає tor від імені користувача debian-tor, а активний unit має назву tor@default.service, оскільки tor.service у Debian та Ubuntu є оболонкою над екземпляром. Запитуйте стан і журнали за іменем екземпляра, і ви завжди отримуватимете дані фактичного процесу.

Налаштуйте onion service у torrc

Додайте два рядки в /etc/tor/torrc:

HiddenServiceDir /var/lib/tor/onion_site/
HiddenServicePort 80 127.0.0.1:8080

HiddenServiceDir — це каталог, у якому tor зберігає ключі й адресу цього сервісу. Не створюйте його вручну. Під час запуску Tor створює його з потрібними власником і режимом. Каталог, створений від імені root, спричинить першу помилку зі списку нижче.

HiddenServicePort має дві частини, і найпоширеніша перша помилка — переплутати їх. Перше число — це порт, до якого відвідувач підключається всередині тунелю. Тому 80 — очікуване значення, і змінювати його немає потреби. Друга частина — локальна адреса, на яку tor переспрямовує цей трафік. Якщо вказати лише HiddenServicePort 80, трафік буде переспрямовано на 127.0.0.1:80. Тому явне зазначення адреси та використання порту з великим номером не дає onion vhost конфліктувати з тим, що вже прослуховує порт 80.

sudo systemctl restart tor@default
sudo ls -l /var/lib/tor/onion_site/

У каталозі мають бути hostname, hs_ed25519_public_key, hs_ed25519_secret_key і порожній каталог authorized_clients.

Прочитайте свою адресу .onion

sudo cat /var/lib/tor/onion_site/hostname

У відповідь буде один рядок: 56 символів у кодуванні base32 і .onion. Цей рядок є повною ідентичністю сайту. Його ніхто не призначає, не може передати чи забрати, поки у вас є файл ключа. Скопіюйте його зараз, оскільки він потрібен у кожній конфігурації нижче. Далі в цьому посібнику він позначається як <your-address>.onion.

Обслуговування сайту через nginx, прив’язаний до 127.0.0.1

sudo apt install -y nginx
sudo install -d -m 755 /srv/onion

Запишіть /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 nginx

Тепер перевірте з сервера дві речі. По-перше, nginx відповідає для onion-імені. Саме такий заголовок Host надішле tor:

curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/

По-друге, nginx відповідає на цій адресі й більше ніде:

sudo ss -tlnp | grep 8080

У стовпці адреси має бути 127.0.0.1:8080. Якщо там зазначено 0.0.0.0:8080 або *:8080, ваш onion-сайт також доступний у публічному інтернеті. Це перший пункт у списку витоків. Рядок listen 8080; без адреси прив’язує сервіс до всіх інтерфейсів. Це значення за замовчуванням.

Відкрийте адресу в Tor Browser. Перше завантаження триває кілька секунд, поки клієнт отримує ваш descriptor і будує rendezvous circuit.

У власній документації Tor Project надає перевагу unix socket замість loopback-порту: HiddenServicePort 80 unix:/var/run/tor/onion_site.sock, а nginx має слухати цей шлях. До socket не можна підключитися з іншого хоста, навіть якщо згодом на сервері з’явиться другий інтерфейс. Недолік полягає в правах доступу до файлів: nginx створює socket, а tor підключається до нього як debian-tor, тому обидва користувачі мають мати узгоджені права на каталог. Loopback із перевіреним результатом ss налаштувати простіше, тому далі в цьому посібнику використовується саме цей варіант.

Якщо сайт працює через loopback, для нього не потрібне жодне вхідне правило. Залиште відкритим порт 22 для себе, а решту забороніть (типові параметри ufw для VPS). Пам’ятайте: firewall не скасовує дію сервісу, прив’язаного до 0.0.0.0. Він лише фільтрує пакети, що доходять до firewall. Для контейнерів це особливо важливо, оскільки публікація Docker-порту створює правила iptables перед правилами ufw, тому -p 8080:80 робить ваш onion backend доступним через публічну IP-адресу, хоча ufw і далі показує порт як заборонений. Публікуйте порти контейнерів як -p 127.0.0.1:8080:80.

Витоки, які деанонімізують onion-сайт

Tor приховує розташування сервера. Tor не приховує вміст, який сервер передає. Кожен наведений нижче елемент публікує ваш власний стек. Аналізувати фактичні межі кожного засобу приватності, а не покладатися на його репутацію, потрібно так само, як під час перевірки того, що приховує self-hosted SearXNG: від пошукових систем приховується ваша IP-адреса і не більше.

Той самий сайт, доступний за вашою публічною IP-адресою

Саме це найчастіше стає проблемою. Сканери безперервно індексують HTTP-відповідь кожної доступної з мережі адреси, і ці результати є публічними та доступними для пошуку. Якщо передавати ту саму сторінку за вашою публічною IP-адресою та onion-адресою, об’єднати їх можна одним запитом: однаковий заголовок, однаковий хеш favicon, однаковий ETag і однаковий порядок заголовків. Рядок listen 127.0.0.1:8080; вище усуває цю проблему. Перевіряйте це з іншої машини, а не із сервера:

curl -sv --max-time 5 http://<your-public-ip>:8080/

Connection refused або timeout є правильним результатом. Будь-який HTML означає, що сайт доступний публічно. Якщо на сервері також працює clearnet-сайт, призначте цьому vhost окремий root і залиште явний блок default_server на публічному listener, щоб заголовок Host без відповідності не міг перейти до onion-vhost.

Банери версій

curl -sI http://127.0.0.1:8080/ | grep -i '^server'

Стандартний nginx повертає Server: nginx/1.24.0. Цей рядок із версією разом із точним порядком інших заголовків створює fingerprint, за яким onion-сайт можна зіставити з вашим clearnet-хостом. server_tokens off; скорочує його до Server: nginx. Це не видаляє заголовок, а nginx не має вбудованої директиви для цього, тому зазвичай використовують модуль headers-more, якщо потрібно повністю прибрати заголовок. PHP додає X-Powered-By, доки не встановити expose_php = Off. У цей самий список належить etag off;, оскільки nginx формує ETag з часу зміни та розміру файлу. Тому однакові файли, скопійовані на два сервери, матимуть однаковий ETag на обох.

Абсолютні URL-адреси, що вказують на ваш clearnet-домен

Тег rel="canonical", властивість Open Graph og:url, RSS-стрічка, sitemap або email для скидання пароля, жорстко задана URL-адреса логотипу. Будь-який із цих елементів вказує на clearnet-сайт зі сторінки, переданої через onion. Використовуйте шляхи від кореня, наприклад /static/logo.svg, а базову URL-адресу застосунок має отримувати з host у запиті, а не з константи. Редиректи створюють ту саму проблему в іншому місці: return 301 https://example.com$request_uri; у catch-all-блоці перенаправляє відвідувача onion на ваш реальний домен, а заголовок Location безпосередньо передає йому цю адресу.

Сертифікат TLS, спільний із clearnet-сайтом

Onion-адреса автентифікує сама себе, оскільки адреса є публічним ключем. Тому http:// через onion-з’єднання вже зашифровано наскрізним шифруванням, а Tor Browser вважає такий контекст захищеним. Встановлення на onion-vhost вашого наявного сертифіката публікує зв’язок між двома сайтами, оскільки кожен сертифікат, якому довіряють публічно, записується в журнали Certificate Transparency, а ці журнали є публічними, постійними та доступними для пошуку за іменем. Залиште сертифікати Let's Encrypt на clearnet-vhost і використовуйте для onion-vhost звичайний HTTP.

Сторонні шрифти та аналітика

Шрифт із CDN (content delivery network) або скрипт аналітики. Браузер відвідувача завантажує кожен із них безпосередньо. Тому сторонній сервіс дізнається, що хтось відкрив вашу сторінку, і зазвичай бачить, яку саме сторінку. Крім того, суворіші рівні безпеки Tor Browser все одно блокують такий запит, через що макет сторінки може відображатися неправильно. Розміщуйте локально всі ресурси, потрібні сторінці.

Невідповідність заголовка Host

Якщо server_name не відповідає заголовку Host, який надсилає tor, nginx використовує default server для цієї адреси listen. На сервері з одним vhost це непомітно, оскільки єдиний server block одночасно є default. Якщо згодом додати clearnet-vhost, onion-запити можуть почати потрапляти до нього разом із його canonical-тегами та редиректами. Повторюйте перевірку curl -H 'Host: ...' після кожної зміни nginx і виконуйте grep результату для пошуку вашого реального домену:

curl -s -H 'Host: <your-address>.onion' http://127.0.0.1:8080/ | grep -o 'https\?://[^"]*' | sort -u

Розуміння того, який процес володіє яким socket, становить значну частину цієї роботи (як працюють порти та listening sockets у Linux).

Що залишається в журналах

Кожен запит надходить із 127.0.0.1, тому nginx не має адреси відвідувача для запису, а access_log off; нічого вам не коштує. Застосунок, що працює поверх nginx, — інша справа, оскільки замовлення, email-адреса або метадані завантаженого файлу потребують належної обробки з вашого боку. Важливі й ваші власні звички: адміністрування сервера через незахищений login не належить до того, що захищає Tor. Тому вважайте посилення захисту SSH на тому самому VPS частиною цієї конфігурації.

Створіть резервну копію приватного ключа, оскільки він є адресою

/var/lib/tor/onion_site/hs_ed25519_secret_key — це сервіс. Реєстратора та механізму відновлення немає. Якщо втратити ключ, адресу буде втрачено. Скопіюйте його, і будь-хто, хто матиме копію, зможе розміщувати власний вміст за вашою адресою. Ви не зможете відкликати цей ключ.

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@default

Зашифруйте цей архів (gpg -c onion-keys.tgz) і перенесіть його за межі сервера. Для відновлення на новому VPS потрібні архів і права власності, які очікує 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/hostname

Та сама адреса з’явиться на новому обладнанні через 1–2 хвилини після того, як tor повторно опублікує дескриптор. На цьому міграцію завершено: змінювати DNS або повторно випускати сертифікат не потрібно.

Onion-Location, якщо сайт також доступний у clearnet

Якщо onion-адреса потрібна для зручності, а не для приховування сайту, повідомте її в clearnet vhost:

add_header Onion-Location http://<your-address>.onion$request_uri;

Після цього Tor Browser показує кнопку .onion available в адресному рядку та пропонує перейти на onion-адресу. Заголовок враховується лише тоді, коли сторінка clearnet доступна через HTTPS, а його значення є дійсною onion URL.

Тут є важливий нюанс nginx. Директиви add_header успадковуються блоком location лише тоді, коли цей блок не містить власних директив, тому location із власним add_header непомітно втрачає Onion-Location. Повторіть директиву в цьому блоці або зберігайте всі заголовки відповіді в одному місці. Публікація цього заголовка навмисно пов’язує два сайти. Це правильно для дзеркала, але неправильно для ресурсів, які мають залишатися непов’язаними.

Власні адреси

mkp224o генерує пари ключів, доки одна з них не створить адресу, що починається із заданого префікса. Це перебір, тому потрібно налаштувати лише префікс і час, який ви готові чекати.

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 blog

Кожен знайдений результат зберігається в onionkeys/<address>.onion/, де містяться hostname і hs_ed25519_secret_key. Щоб установити такий результат, зупиніть tor, скопіюйте цей каталог у HiddenServiceDir, а потім застосуйте ті самі chown і chmod 700, що й під час описаної вище процедури відновлення.

Довжина префікса визначає всі витрати. Адреса має кодування base32, тому кожен додатковий потрібний символ збільшує очікувану кількість ключів у 32 рази. Короткий префікс можна отримати на ноутбуці. Для довгого префікса не вистачить жодного доступного вам обладнання. Власний префікс також привчає читачів розпізнавати лише перші кілька символів, а не всю адресу. Саме на цій звичці будуються фішингові копії onion-сайтів.

Типові сценарії відмови та повідомлення, які ви побачите

Після перезапуску немає файлу hostname. Tor не запустився або відмовився використовувати каталог. 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?

Так виглядає каталог, створений вручну. Виправте власника та права доступу або видаліть каталог і дозвольте tor створити його.

Tor Browser показує Onionsite Not Found (0xF0). Клієнт не зміг отримати дескриптор, тому з погляду мережі за цією адресою нічого не опубліковано. Переконайтеся, що tor запущений і завершив bootstrap, а потім перевірте час на сервері. Для публікації та перевірки дескрипторів Tor потребує точного часу, а timedatectl має повідомити System clock synchronized: yes. Помилка в адресі рідко є причиною цієї проблеми. Адреса v3 містить двобайтову контрольну суму, тому помилково введена адреса майже завжди не проходить цю перевірку, і Tor Browser натомість показує Invalid Onionsite Address (0xF6). Якщо ви бачите це повідомлення, скопіюйте адресу ще раз із sudo cat /var/lib/tor/onion_site/hostname.

Адреса визначається, але сторінка не завантажується. Tor завершив rendezvous, а потім не зміг пройти останню ділянку — від tor до nginx. Ця ділянка локальна, тому журнал tor залишається порожнім. Виконайте curl -sI http://127.0.0.1:8080/ на сервері. Connection refused означає, що nginx не запущений або слухає іншу адресу, ніж та, на яку вказує HiddenServicePort.

Сторінка завантажується, але кожне посилання веде на ваш реальний домен. Причина — абсолютні URL у шаблонах. Виконайте перевірку grep -o 'https\?://[^"]*' вище та виправте все, що вона виведе, перш ніж ділитися адресою.

Сайт працює, а після перезавантаження перестає. Навмисно перезавантажте сервер один раз, перш ніж покладатися на цей сайт, а потім виконайте sudo systemctl status tor@default і sudo systemctl status nginx. Сервіс, запущений вручну, не відрізняється від увімкненого для автозапуску, доки машину не перезавантажено.

FAQ

Чи потрібно відкривати порт у firewall для onion-сервісу Tor?

Ні. Демон tor встановлює лише вихідні з’єднання із серверами каталогів, introduction points і кожним rendezvous relay, тому правило для вхідного трафіку не потрібне, а сам вебсервер прослуховує 127.0.0.1. Залиште для вхідного трафіку політику ufw default deny, дозволивши SSH. Ця сама властивість дає змогу onion-сервісу працювати на машині за NAT (network address translation), навіть без публічної IP-адреси.

Чому я не можу відкрити свою адресу .onion у Tor Browser?

Перевіряйте проблему від сервера назовні. sudo journalctl -u tor@default -n 50 має показати Bootstrapped 100% (done): Done, після чого curl -sI http://127.0.0.1:8080/ на сервері має повернути рядок зі статусом. Неправильно введена адреса майже ніколи не веде до іншого сервісу, оскільки адреса v3 містить контрольну суму, тому Tor Browser відхиляє її як Invalid Onionsite Address (0xF6), а вам слід повторно скопіювати її з файлу hostname. Onionsite Not Found (0xF0) означає, що для адреси не знайдено дескриптор. Зазвичай це означає, що tor не запущений або системний годинник показує неправильний час.

Чи можна перенести onion-сайт на новий сервер і зберегти ту саму адресу?

Так. Адреса походить із hs_ed25519_secret_key, тому скопіюйте весь HiddenServiceDir на новий сервер, призначте йому власника debian-tor і режим 700, а потім запустіть tor. Адреса знову стане доступною після повторної публікації дескриптора, і оновлювати DNS-запис не потрібно. Якщо втратити цей файл, адресу неможливо відновити, тому в день її створення зробіть його зашифровану резервну копію та збережіть її поза сервером.

Чи потрібен onion-сайту сертифікат HTTPS?

Ні. Адреса завдовжки 56 символів є відкритим ключем сервісу, тому з’єднання вже зашифроване й автентифіковане від кінця до кінця, а Tor Browser вважає http:// на імені .onion безпечним контекстом. Повторне використання сертифіката clearnet для onion vhost гірше, ніж повна відмова від сертифіката, оскільки журнали Certificate Transparency є публічними й назавжди фіксують імена, для яких використовується один сертифікат. Єдина причина придбати сертифікат для імені .onion — підтвердження бренду від CA, який видає такі сертифікати; цей зв’язок за задумом є публічним.

Чи була ця стаття корисною?