Розширене використання

Збереження вкладок

Усе в OnionShare типово є тимчасовим. Якщо закрити вкладку OnionShare, її адреса більше не існуватиме й її більше не можна використовувати. Іноді вам може знадобитися, щоб служба OnionShare була постійною. Це корисно, якщо ви хочете розмістити вебсайт, доступний з тієї ж адреси OnionShare, навіть якщо ви перезапустите свій комп’ютер.

Щоб зробити будь-яку вкладку постійною, позначте «Зберегти цю вкладку та автоматично відкривати її, коли я відкриваю OnionShare» перед запуском сервера. Коли вкладку збережено, ліворуч від стану сервера з’являється фіолетова піктограма у вигляді шпильки.

_images/advanced-save-tabs.png

Коли ви вийдете з OnionShare, а потім знову відкриєте його, збережені вкладки почнуть відкриватися. Вам доведеться власноруч запускати кожну службу, але коли ви це зробите, вони запустяться з тієї ж адреси OnionShare і з тим же приватним ключем.

Якщо ви збережете вкладку, копія таємного ключа служби onion цієї вкладки зберігатиметься на вашому комп’ютері з налаштуваннями OnionShare.

Вимкнути приватний ключ

Типово всі служби OnionShare захищені приватним ключем, який Tor називає «автентифікацією клієнта».

Під час перегляду за допомогою служби OnionShare у Tor Browser, він запропонує ввести приватний ключ.

Іноді вам може знадобитися, щоб ваша служба OnionShare була загальнодоступною, наприклад, якщо ви хочете налаштувати службу отримання OnionShare, щоб інші могли безпечно та анонімно надсилати вам файли. У цьому випадку краще взагалі вимкнути приватний ключ.

Щоб вимкнути приватний ключ для будь-якої вкладки, установіть прапорець «Це загальнодоступна служба OnionShare (вимикає приватний ключ)» перед запуском сервера. Тоді сервер буде загальнодоступним і не потребуватиме приватного ключа для перегляду в Tor Browser.

Власні заголовки

Усталено, коли користувачі завантажують службу OnionShare у браузері Tor, вони бачать типову назву для типу служби. Наприклад, типовою назвою чату є «OnionShare Chat».

Якщо потрібно вибрати власний заголовок, перед запуском сервера встановіть параметр «Власний заголовок».

Запланований час

OnionShare підтримує планування, коли саме служба повинна запускатися та зупинятися. Перш ніж запускати сервер, натисніть «Показати розширені налаштування» на його вкладці, а потім позначте «Запускати службу onion у запланований час», «Зупинити службу onion у запланований час» або обидва і встановіть бажані дати та час.

Якщо ви запланували запуск послуги в майбутньому, після натискання кнопки «Почати надсилання» ви побачите таймер зі зворотним відліком до початку запуску. Якщо ви запланували його зупинку в майбутньому, після його запуску ви побачите таймер з відліком часу, коли його буде автоматично зупинено.

Планування служби OnionShare для автоматичного запуску може використовуватися як кнопка мерця, де вашу службу буде оприлюднено в певний час у майбутньому, якщо з вами щось станеться. Якщо з вами нічого не відбувається, ви можете вимкнути службу до запланованого запуску.

_images/advanced-schedule-start-timer.png

Планування автоматичної зупинки служби OnionShare може бути корисним для обмеження надсилання, наприклад, якщо ви хочете поділитися таємними документами й бути певними, що вони не доступні в інтернеті впродовж більше кількох днів.

_images/advanced-schedule-stop-timer.png

Інтерфейс командного рядка

Окрім графічного інтерфейсу, OnionShare має інтерфейс командного рядка.

Ви можете встановити версію для командного рядка OnionShare лише використовуючи pip3:

pip3 install --user onionshare-cli

Зауважте, що вам також знадобиться встановлений пакунок tor. У macOS встановіть його за допомогою: brew install tor

Потім запустіть його так:

onionshare-cli --help

Докладніше про його встановлення в різних операційних системах перегляньте файл CLI readme у git-репозиторії.

Якщо ви встановили OnionShare за допомогою пакунка Linux Snapcraft, ви можете просто запустити onionshare.cli для доступу до версії інтерфейсу командного рядка.

Користування

Ви можете переглянути документацію командного рядка, запустивши onionshare --help:

$ onionshare-cli --help
╭───────────────────────────────────────────╮
│    *            ▄▄█████▄▄            *    │
│               ▄████▀▀▀████▄     *         │
│              ▀▀█▀       ▀██▄              │
│      *      ▄█▄          ▀██▄             │
│           ▄█████▄         ███        -+-  │
│             ███         ▀█████▀           │
│             ▀██▄          ▀█▀             │
│         *    ▀██▄       ▄█▄▄     *        │
│ *             ▀████▄▄▄████▀               │
│                 ▀▀█████▀▀                 │
│             -+-                     *     │
│   ▄▀▄               ▄▀▀ █                 │
│   █ █     ▀         ▀▄  █                 │
│   █ █ █▀▄ █ ▄▀▄ █▀▄  ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄   │
│   ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █   ▀▄▄   │
│                                           │
│                  v2.4.1                   │
│                                           │
│          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] [--no-autostop-sharing] [--data-dir data_dir] [--webhook-url webhook_url] [--disable-text]
                      [--disable-files] [--disable_csp] [--custom_csp custom_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 private key
  --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)
  --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 the default Content Security Policy header (allows your website to use third-party resources)
  --custom_csp custom_csp   Publish website: Set a custom Content Security Policy header
  -v, --verbose             Log OnionShare errors to stdout, and web errors to disk