{"canonical_url":"https://engineer.company/uk/glossary/onion/","content_markdown":"# Onion-сервіс\n\n## Що це таке\n\nЗвичайний сайт знаходять за DNS-ім'ям, що вказує на IP-адресу, а onion-сервіс досяжний лише\nвсередині мережі Tor, і його ім'я виведене з власного відкритого ключа сервісу. У розмові часто\nкажуть просто onion, один демон tor може тримати кілька onion-сервісів поруч, а специфікація й\nдосі вживає давнішу назву hidden service.\n\nСаме ім'я — це 56 символів base32, за якими йде `.onion`. Після декодування з них виходить 35\nбайтів: 32-байтовий ідентифікаційний ключ ed25519, двобайтова контрольна сума, взята з геша\nSHA3-256 цього ключа, і байт версії зі значенням 3. Цей байт стоїть останнім, тому кожна чинна\nадреса закінчується літерою d. Мітку ніхто не обирає: це і є ключ, записаний літерами. Імена\nверсії 2, що були до неї, складалися з 16 символів, відрізаних від геша SHA-1 ключа RSA-1024, і\ntor відмовився від них у випуску 0.4.6.1-alpha 2021 року.\n\nЩоб дві сторони зустрілися й жодна не розкрила, де вона є, протокол використовує два види місць\nзустрічі. Сервіс обирає кілька ретрансляторів точками знайомства (introduction points), тримає до\nних відкриті ланцюжки й публікує на ретрансляторах-каталогах підписаний дескриптор з їхнім\nпереліком. Дескриптор зберігається під засліпленим ключем, який змінюється щоперіоду, а його вміст\nзашифровано, тож ретранслятор, що зберігає його, не знаючи адреси, переліку не прочитає. Клієнт,\nякому адреса відома, завантажує дескриптор, перевіряє підпис ключем з імені, сам обирає\nретранслятор точкою зустрічі (rendezvous point) і через одну з точок знайомства просить сервіс\nприйти туди. Сервіс будує власний ланцюжок до точки зустрічі й завершує рукостискання, а\nретранслятор з'єднує два ланцюжки. Увесь шлях проходить через шість ретрансляторів, по три від\nкожної сторони, і жоден кінець не дізнається IP-адреси іншого. Необов'язковий режим, що тепер\nзветься restricted discovery, а раніше звався client authorization, додатково шифрує дескриптор\nдля ключа кожного дозволеного клієнта, тож лише ці клієнти дізнаються, де точки знайомства.\n\n## Чому це важливо\n\nДля звичайного сайту DNS і центр сертифікації ділять між собою завдання сказати читачеві, з ким\nвін має справу. Onion-сервісу не потрібен жоден з них, бо цю роботу виконує саме ім'я. Перевіривши\nпідпис дескриптора й завершивши рукостискання, клієнт знає, що на тому боці той, хто володіє\nприватним ключем за адресою. RFC 7686, який резервує `.onion` як доменне ім'я спеціального\nпризначення, описує такі імена як поєднання розташування та автентифікації й робить висновок:\nonion-ім'я не можна зареєструвати, призначити, передати чи відкликати. Володіти ним означає\nрозпоряджатися парою ключів, і нічого більше.\n\nШифрування випливає з тієї самої конструкції. Трафік до onion-сервісу ніколи не залишає мережі\nTor, тож на дальньому кінці немає вихідного ретранслятора й немає останнього відрізка відкритим\nтекстом. Звичайний `http://` на onion-адресі несе сторінку, зашифровану на всьому шляху, до хоста,\nчию особу клієнт звірив з ім'ям, яке отримав.\n\nЗ погляду експлуатації не менш важливий напрямок з'єднань. Сервіс лише сам дзвонить назовні — до\nсвоїх точок знайомства й до кожної точки зустрічі, — тож йому не потрібен відкритий вхідний порт,\nі він працює за NAT. Перелік відкритих портів хоста лишається таким самим, як був.\n\nАдресу читачам усе одно треба якось дізнатися. Сайт може оголосити її заголовком відповіді\n`Onion-Location`, і тоді Tor Browser показує в адресному рядку фіолетову кнопку, що веде до\nonion-копії сторінки. Tor Project ставить три умови: значення — це URL `http:` або `https:` з\nonion-хостом, сторінку, що його надсилає, отримано через HTTPS, і сама вона не розміщена на onion.\nТам, де заголовки задати неможливо, те саме оголошення може нести метатег, але без шляху, тож\nкожна сторінка вказує на одну незмінну адресу.\n\n## Як це виглядає на практиці\n\n[Onion-дзеркало компанії на читабельній адресі](/uk/portfolio/published-a-readable-tor-onion-mirror/)\nописано крок за кроком. Демон встановлено з власного пакета дистрибутива, а вихідний порт проксі\nвимкнено. Приватний ключ, що відповідає адресі, згенеровано поза хостом, і він ніколи не потрапляв ні\nдо репозиторію, ні на ноутбук; роль відмовляється перезаписувати ідентифікаційні дані, яких не генерувала сама,\nтож покладений вручну ключ використовується як є. Адреса записана в інвентарі як оголошене\nзначення, і кожне застосування конфігурації перевіряє, чи файл ідентифікаційних даних на хості з ним збігається, тож підмінений ключ\nіз застарілим оголошенням зупиняє прогін. Обидві сторожі секретів ловлять файл ключа — після того\nяк вимірювання показало, що очевидний шаблон для файлу ключа збігався з ключем розгортання й\nпроминав цей.\n\nЧитабельний префікс можна знайти, але не обрати. Кожен наступний символ множить очікуваний пошук\nна 32, тож вісім літер `engineer` потребують у середньому близько 1,1 трильйона пар ключів.\nВипадкову адресу, з якою дзеркало запрацювало спершу, вивели з ужитку поетапним переходом, і\nопублікована адреса відповідала весь час. Один крок здавався останнім, але ним не був: ключ ліг на\nмісце, застосування конфігурації повідомило про відсутність змін, а нову адресу так і не опублікували, бо ніщо не\nназивало її теки. Тепер роль завершується помилкою, якщо на диску є ідентифікаційні дані, яких не використовує жодна служба.\n\n[Сторінка подяк](/uk/credits/) наводить повну адресу,\n`engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion`, поруч з адресами Gemini та\nGopher. Усі четверо вхідних дверей ведуть до однієї теки з файлами, тож onion-адресу оновлює те саме\nрозгортання, що й три інші, а вебверсія надсилає `Onion-Location`, і Tor Browser сам пропонує\nonion-адресу. Сторінка також пояснює, що бачить власна мережа читача крізь кожні двері: через Gopher\n— яку сторінку читають, через Gemini — яку адресу запитали, через onion-сервіс — ні того, ні іншого.\nПрефікс вона називає зручністю, а не доказом, і просить звіряти всю адресу.\n\nБудову адреси можна перевірити без мережі. Ці рядки декодують її й заново обчислюють контрольну\nсуму, і обидва порівняння друкують `True`:\n\n```python\nimport base64\nimport hashlib\n\nlabel = \"engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd\"\nraw = base64.b32decode(label.upper())\nkey, checksum, version = raw[:32], raw[32:34], raw[34:]\ndigest = hashlib.sha3_256(b\".onion checksum\" + key + version).digest()\nprint(version == b\"\\x03\", digest[:2] == checksum)\n```\n\nПравильна контрольна сума показує, що адресу складено коректно, але не те, кому вона належить. Це\nпідтверджує її поява на власних HTTPS-сторінках компанії.\n\n## Де виникають проблеми\n\n**Ключ — єдиний документ на володіння.** За ім'ям не стоїть жоден реєстратор, тож утрачений\nприватний ключ означає втрачену адресу, а скопійований дає змогу комусь іншому відповідати на ній.\nПосібник Tor Project з налаштування радить тримати файли ключів у таємниці й робити резервну копію\nключа, якщо сервіс має жити довго. Ставтеся до нього як до ключа підпису, а не як до конфігурації.\n\n**Читають лише перші літери.** RFC 7686 застерігає, що зловмисник може знайти ключі, чиї імена\nсхожі на потрібне, і що ризик більший, бо людині ці імена нічого не кажуть. Читабельні імена,\nздобуті ціною значних обчислень, RFC вважає одним із засобів захисту, але восьмисимвольний префікс\nлишає решту 48 символів такими ж непрозорими, як і раніше. Звіряйте всю адресу або приходьте через\nзакладку чи посилання на власних HTTPS-сторінках сайту.\n\n**Сервер видає себе сам.** Tor приховує, де працює сервіс, але програмне забезпечення за ним\nоднаково може це сказати. Серед способів, якими ламається захист, RFC 7686 називає сервер, що\nрозкриває свої ідентифікаційні дані в повідомленні рівня застосунку, і сторінка помилки зі справжнім іменем хоста\nмашини — саме такий випадок. Посібник з налаштування також радить передавати трафік вебсерверу\nчерез Unix-сокет, а не TCP, щоб сервіс не просочувався в локальну мережу:\n\n```text\nHiddenServiceDir /var/lib/tor/my-website/\nHiddenServicePort 80 unix:/var/run/tor/my-website.sock\n```\n\nНайбільше це важить там, де саме розташування і є таємницею.\n\n**Ім'я потрапляє до DNS.** Програма, що не вміє працювати з Tor, питає про onion-ім'я звичайний\nрезолвер, і локальна мережа та постачальник DNS дізнаються, про який onion ішлося. RFC 7686\nвимагає, щоб така програма повертала помилку без запиту, а DNS-сервери відповідали, що такого\nімені не існує. Передавайте ім'я клієнтові Tor.\n\n**Кнопка `Onion-Location`, яка так і не з'являється.** Заголовок, заданий лише на переадресації зі\nзвичайного HTTP, порушує умову про HTTPS, а заголовок з помилкою в адресі веде читачів у нікуди.\nПеревіряйте заголовок на остаточній HTTPS-відповіді.\n\n## Що почитати далі\n\n- [Tor Rendezvous Specification, version 3](https://spec.torproject.org/rend-spec/) — увесь\n  протокол: ідентифікаційні й засліплені ключі, дескриптори, знайомство та зустріч.\n- [Encoding onion addresses](https://spec.torproject.org/rend-spec/encoding-onion-addresses.html)\n  — формула, що перетворює відкритий ключ на 56-символьне ім'я, з прикладами адрес.\n- [How do Onion Services work?](https://community.torproject.org/onion-services/overview/) — точки\n  знайомства, дескриптори й точка зустрічі, розібрані крок за кроком.\n- [Set up Your Onion Service](https://community.torproject.org/onion-services/setup/) — рядки\n  torrc, файли, які створює tor, і поради щодо ключів та витоків розташування.\n- [Onion-Location](https://community.torproject.org/onion-services/advanced/onion-location/) —\n  налаштування заголовка й метатега для Apache, Nginx і Caddy та умови, яким має відповідати\n  заголовок.\n- [RFC 7686](https://www.rfc-editor.org/rfc/rfc7686) — чому `.onion` зарезервовано і що з ним\n  мають робити резолвери, оператори DNS та реєстратори.\n\n\u003chttps://engineer.company/uk/glossary/onion/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як працює onion-сервіс: ім'я, що кодує його відкритий ключ, точка зустрічі, яка ховає обидва кінці, і ключ, що його оператор мусить берегти.","formats":{"gemtext":"https://engineer.company/uk/glossary/onion/index.gmi","gopher":"https://engineer.company/uk/glossary/onion/gophermap","html":"https://engineer.company/uk/glossary/onion/","json":"https://engineer.company/uk/glossary/onion/index.json","markdown":"https://engineer.company/uk/glossary/onion/index.md","pdf":"https://engineer.company/uk/glossary/onion/index.pdf"},"kind":"page","language":"uk","title":"Що таке onion-сервіс?","url":"https://engineer.company/uk/glossary/onion/","version":1}