Розширене використання¶
Збереження вкладок¶
Усе в OnionShare типово є тимчасовим. Якщо закрити вкладку OnionShare, її адреса більше не існуватиме й її більше не можна використовувати. Іноді вам може знадобитися, щоб служба OnionShare була постійною. Це корисно, якщо ви хочете розмістити вебсайт, доступний з тієї ж адреси OnionShare, навіть якщо ви перезапустите свій комп’ютер.
Щоб зробити будь-яку вкладку постійною, позначте «Зберегти цю вкладку та автоматично відкривати її, коли я відкриваю OnionShare» перед запуском сервера. Коли вкладку збережено, ліворуч від стану сервера з’являється фіолетова піктограма у вигляді шпильки.
Коли ви вийдете з OnionShare, а потім знову відкриєте його, збережені вкладки почнуть відкриватися. Вам доведеться власноруч запускати кожну службу, але коли ви це зробите, вони запустяться з тієї ж адреси OnionShare і з тим же паролем.
Якщо ви збережете вкладку, копія таємного ключа служби onion цієї вкладки зберігатиметься на вашому комп’ютері з налаштуваннями OnionShare.
Вимкнення паролів¶
Типово всі служби OnionShare захищені іменем користувача onionshare і випадково створеним паролем. Якщо хтось вводить пароль неправильно 20 разів, ваша служба onion автоматично зупиняється, щоб запобігти спробі грубого зламу служби OnionShare.
Іноді вам може знадобитися, щоб ваша служба OnionShare була загальнодоступною, наприклад, якщо ви хочете налаштувати службу отримання OnionShare, щоб інші могли безпечно та анонімно надсилати вам файли. У цьому випадку краще взагалі вимкнути пароль. Якщо ви цього не зробите, хтось може змусити ваш сервер зупинитися, просто зробивши 20 неправильних спроб введення паролю, навіть якщо вони знають правильний пароль.
Щоб вимкнути пароль для будь-якої вкладки, просто позначте «Не використовувати пароль» перед запуском сервера. Тоді сервер буде загальнодоступним і не матиме пароля.
Власні заголовки¶
Усталено, коли користувачі завантажують службу OnionShare у браузері Tor, вони бачать типову назву для типу служби. Наприклад, типовою назвою чату є «OnionShare Chat».
Якщо потрібно вибрати власний заголовок, перед запуском сервера встановіть параметр «Власний заголовок».
Запланований час¶
OnionShare підтримує планування, коли саме служба повинна запускатися та зупинятися. Перш ніж запускати сервер, натисніть «Показати розширені налаштування» на його вкладці, а потім позначте «Запускати службу onion у запланований час», «Зупинити службу onion у запланований час» або обидва і встановіть бажані дати та час.
Якщо ви запланували запуск послуги в майбутньому, після натискання кнопки «Почати надсилання» ви побачите таймер зі зворотним відліком до початку запуску. Якщо ви запланували його зупинку в майбутньому, після його запуску ви побачите таймер з відліком часу, коли його буде автоматично зупинено.
Планування служби OnionShare для автоматичного запуску може використовуватися як кнопка мерця, де вашу службу буде оприлюднено в певний час у майбутньому, якщо з вами щось станеться. Якщо з вами нічого не відбувається, ви можете вимкнути службу до запланованого запуску.
Планування автоматичної зупинки служби OnionShare може бути корисним для обмеження надсилання, наприклад, якщо ви хочете поділитися таємними документами й бути певними, що вони не доступні в Інтернеті впродовж більше кількох днів.
Інтерфейс командного рядка¶
Окрім графічного інтерфейсу, OnionShare має інтерфейс командного рядка.
Ви можете встановити версію для командного рядка OnionShare лише використовуючи pip3:
pip3 install --user onionshare-cli
Зауважте, що вам також знадобиться встановлений пакунок tor. У macOS встановіть його за допомогою: brew install tor
Потім запустіть його так:
onionshare-cli --help
Якщо ви встановили OnionShare за допомогою пакунка Linux Snapcraft, ви можете просто запустити onionshare.cli для доступу до версії інтерфейсу командного рядка.
Користування¶
Ви можете переглянути документацію командного рядка, запустивши onionshare --help:
$ onionshare-cli --help
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.3.3 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
usage: onionshare-cli [-h] [--receive] [--website] [--chat] [--local-only] [--connect-timeout SECONDS] [--config FILENAME]
[--persistent FILENAME] [--title TITLE] [--public] [--auto-start-timer SECONDS]
[--auto-stop-timer SECONDS] [--legacy] [--client-auth] [--no-autostop-sharing] [--data-dir data_dir]
[--webhook-url webhook_url] [--disable-text] [--disable-files] [--disable_csp] [-v]
[filename ...]
positional arguments:
filename List of files or folders to share
optional arguments:
-h, --help show this help message and exit
--receive Receive files
--website Publish website
--chat Start chat server
--local-only Don't use Tor (only for development)
--connect-timeout SECONDS
Give up connecting to Tor after a given amount of seconds (default: 120)
--config FILENAME Filename of custom global settings
--persistent FILENAME Filename of persistent session
--title TITLE Set a title
--public Don't use a password
--auto-start-timer SECONDS
Start onion service at scheduled time (N seconds from now)
--auto-stop-timer SECONDS
Stop onion service at schedule time (N seconds from now)
--legacy Use legacy address (v2 onion service, not recommended)
--client-auth Use client authorization (requires --legacy)
--no-autostop-sharing Share files: Continue sharing after files have been sent (default is to stop sharing)
--data-dir data_dir Receive files: Save files received to this directory
--webhook-url webhook_url
Receive files: URL to receive webhook notifications
--disable-text Receive files: Disable receiving text messages
--disable-files Receive files: Disable receiving files
--disable_csp Publish website: Disable Content Security Policy header (allows your website to use third-party
resources)
-v, --verbose Log OnionShare errors to stdout, and web errors to disk
Застарілі адреси¶
Типово, OnionShare використовує служби onion Tor v3. Це сучасні адреси onion, що мають 56 символів, наприклад:
uf3wmtpbstcupvrrsetrtct7qcmnqvdcsxqzxthxbx2y7tidatxye7id.onion
OnionShare досі підтримує адреси onion v2, старий тип адрес onion, які мають 16 символів, наприклад:
lc7j6u55vhrh45eq.onion
OnionShare називає адреси onion v2 «застарілими адресами» і вони не рекомендовані, оскільки адреси onion v3 безпечніші.
Щоб вживати застарілі адреси, перед запуском сервера натисніть «Показати розширені налаштування» на його вкладці та позначте «Користуватися застарілою адресою (служба onion v2, не рекомендовано)». У застарілому режимі ви можете додатково ввімкнути автентифікацію клієнта Tor. Після запуску сервера у застарілому режимі ви не зможете вилучити застарілий режим у цій вкладці. Натомість ви повинні запустити окрему службу в окремій вкладці.
Проєкт Tor планує повністю припинити роботу службами onion v2 15 жовтня 2021 р. і застарілі служби onion також буде вилучено з OnionShare незадовго до цього часу.