Разширени възможности

Запазване на раздели

Затварянето на разделите на OnionShare, в които има настроени услуги, ги унищожава, като предотвратява повторното им използване. Постоянните страници са достъпни на същия адрес, дори ако компютърът, от който са споделени, е рестартиран.

За да направите даден раздел постоянен отметнете „Отваряне на този раздел при стартиране на OnionShare“ преди да включите услугата.

Когато отворите OnionShare, запазените раздели ще бъдат отворени. След това всяка услуга ще може да бъде ръчно включена, като ще бъде достъпна на същия адрес на OnionShare и ще бъде защитена със същия частен ключ.

Когато запазите даден раздел, на компютъра се запазва и копие на тайния ключ на услугата на onion.

Изключване на тайния ключ

По подразбиране услугите на OnionShare са защитени с таен ключ, който Tor нарича „удостоверяване на клиента“.

Когато отворите услуга на OnionShare Tor Browser ще поиска да въведете тайния ключ. Ако искате да разрешите публично използване на услугата, по-добре е да изключите използването на таен ключ.

За да изключите частния ключ за някой раздел, отметнете „Общодостъпна услуга на OnionShare (без частен ключ)“, преди да включите услугата. Тогава сървърът ще бъде публичен и за зареждането му в Tor Browser няма да е необходим частен ключ.

Задаване на заглавия

Когато хората отварят услугите на OnionShare в Tor Browser, те виждат подразбираното заглавие за всеки вид услуга. Например заглавието по подразбиране за услугите за разговор е „Разговор“.

Ако промените настройката „Заглавие на раздела“ преди да включите услугата можете да го промемите.

График на включване и изключване

OnionShare поддържа точно планиране на времето, в което дадена услуга да бъде включена или изключена. Преди да включите сървъра, натиснете „Разширени настройки“ в същия раздел и след това отметнете „Включване на услугата в определен час“, „Изключване на услугата в определен час“ или и двете и задайте съответните дати и часове.

Услугите, планирани да бъдат включени в бъдеще, показват часовник с обратно броене при натискане на бутона „Споделяне“. Услугите, планирани да бъдат спрени в бъдеще, показват часовник с обратно броене при включване.

Насрочването на автоматично включване на услуга на OnionShare може да бъде използвано като сигнал за нередност. Това означава, че услугата ще стане публична в даден момент в бъдещето, ако вие не сте там, за да предотвратите това. Ако нищо не се случи с вас, можете да отмените включването на услугата, преди планираното ѝ включване.

_images/advanced-schedule-start-timer.png

Насрочването на автоматично спиране на услугата OnionShare ограничава излагането ѝ на риск. Ако искате да споделите тайна информация или нещо, което ще бъде остаряло, можете да го направите за избрано ограничено време.

_images/advanced-schedule-stop-timer.png

Интетфейс за команден ред

В допълнение към графичния интерфейс OnionShare има и интерфейс за команден ред.

Инсталиране на версията за команден ред

Ако сте инсталирали пакета от Snap, за macOS или Windows вече разполагате с версията за команден ред.

Можете да инсталирате само версията за команден ред на OnionShare, като използвате pip3:

pip3 install --user onionshare-cli

Обърнете внимание, че е необходимо да имате инсталиран и пакета tor. В macOS го инсталирайте с: brew install tor

След това го извикайте по следния начин:

onionshare-cli --help

Информация за инсталирането му на различни операционни системи можете да намерите във файла CLI README в хранилището на Git.

Работа с команден ред от Snap

Ако сте инсталирали OnionShare с помощта на пакет от Snap, можете да изпълните onionshare.cli, за да получите достъп до интерфейса за команднден ред.

Работа с команден ред в macOS

От терминала изпълнете /Applications/OnionShare.app/Contents/MacOS/onionshare-cli --help

Работа с команден ред в Windows

В инсталацията за Windows е достъпен изпълнимият файл onionshare-cli.exe.

Използване

Прегледайте документацията за команден ред, като изпълните 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] [--log-filenames] [--qr] [--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 scheduled time (N seconds from now)
  --no-autostop-sharing     Share files: Continue sharing after files have been sent (the default is to stop sharing)
  --log-filenames           Log file download activity to stdout
  --qr                      Display a QR code in the terminal for share links
  --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

Работа с команден ред като файл на systemd

Възможно е OnionShare автоматично да бъде стартиран като файл на systemd.

Тази възможност е удачна ако целта ви е всеки път при стартиране на машината да зареждат едни и същи услуги на Onion.

За целта първо трябва да подготвите някои настройки на OnionShare в JSON.

Това е файлът с основните настройки на OnionShare. В този пример се намира в /home/user/.config/onionshare/onionshare.json. Може да се наложи да промените някои от настройките, но ако вече имате инсталирано приложението OnionShare, вероятно файлът много прилича на този:

{
  "version": "2.6.2",
  "connection_type": "bundled",
  "control_port_address": "127.0.0.1",
  "control_port_port": 9051,
  "socks_address": "127.0.0.1",
  "socks_port": 9050,
  "socket_file_path": "/var/run/tor/control",
  "auth_type": "no_auth",
  "auth_password": "",
  "auto_connect": true,
  "use_autoupdate": true,
  "autoupdate_timestamp": null,
  "bridges_enabled": false,
  "bridges_type": "built-in",
  "bridges_builtin_pt": "obfs4",
  "bridges_moat": "",
  "bridges_custom": "",
  "bridges_builtin": {},
  "persistent_tabs": [
      "my-persistent-onion"
  ],
  "locale": "en",
  "theme": 0
}

Забележете секцията „persistent_tabs“. Ще създадем файла /home/user/.config/onionshare/persistent/my-persistent-onion.json със следното съдържание:

{
  "onion": {
      "private_key": "UDIaZD8QgoXRP8JnAJ+pnlogQazfZ0wrfWJk5zPBGUBqg6+lozzjUJKTYWxwrxR33pDgJdTFtCUN1CX1FE22UQ==",
      "client_auth_priv_key": "RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ",
      "client_auth_pub_key": "J4YLYAHS25UU3TZTE27H32RN3MCRGLR345U52XS2JNQ76CCHCRSQ"
  },
  "persistent": {
      "mode": "share",
      "enabled": true
  },
  "general": {
      "title": null,
      "public": false,
      "autostart_timer": 0,
      "autostop_timer": 0,
      "service_id": "niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid",
      "qr": false
  },
  "share": {
     "autostop_sharing": true,
     "filenames": [
       "/home/user/my-shared-file.txt"
     ]
  },
  "receive": {
     "data_dir": "/home/user/OnionShare",
     "webhook_url": null,
     "disable_text": false,
     "disable_files": false
  },
  "website": {
     "disable_csp": false,
     "custom_csp": null,
     "filenames": []
  },
  "chat": {}
}

Don’t actually use this private key, service_id or client_auth keys! They are shown only as an example. Never share the private_key with anyone.

The easiest way to generate the onion address and private key is to first create a ‚pinned‘ OnionShare tab in the desktop app and started the share for the first time. This will then have saved the persistent settings to your .config/onionshare/persistent/ folder with a random name. You can unpin that tab once you’ve generated it the first time. Or, you can leave it where it is, and use that persistent file in your systemd unit file below.

Now you can create a systemd unit file in /etc/systemd/system/onionshare-cli.service. Be sure to adjust the User and Group to your own user/group, as well as changes to any paths to the onionshare-cli binary or the paths to your JSON configs and shares.

The systemd unit file should look like this:

[Unit]
Description=OnionShare CLI
After=network.target

[Service]
ExecStart=/home/user/.local/bin/onionshare-cli --persistent /home/user/.config/onionshare/persistent/my-persistent-onion.json /home/user/my-shared-file.txt
Restart=on-failure
User=user
Group=user

[Install]
WantedBy=multi-user.target

Note that although /home/user/my-shared-file.txt was defined in the filenames section of the my-persistent-onion.json file, it’s still necessary to specify it as the argument to the onionshare-cli command.

Be sure to run sudo systemctl daemon-reload after creating the unit file.

Now you can run sudo systemctl start onionshare-cli.service. If you have journalctl installed, you can run sudo journalctl -f -t onionshare-cli, and you should see some output of your service starting:

[...]
Feb 09 10:14:09 onionshare onionshare-cli[18852]: [6.5K blob data]
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Compressing files.
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Give this address and private key to the recipient:
Feb 09 10:14:18 onionshare onionshare-cli[18852]: http://niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid.onion
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Private key: RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Press Ctrl+C to stop the server

If you don’t want your users to use a Private Key, set public to be true in the general settings of the my-persistent-onion.json file.

Клавиши конбинации

Десктоп приложението OnionShare използва някои клавишни комбинации за удобство и достъпност:

Ctrl T - New Tab
Ctrl X - Closes current tab

И на основния екран за избор на режим:

Ctrl S - Share mode
Ctrl R - Receive mode
Ctrl W - Website mode
Ctrl C - Chat mode
Ctrl H - Settings tab

Migrating your OnionShare data to another computer

You may want to migrate your OnionShare data when switching to another computer. This is especially true if you had a ‚persistent‘ onion address and you want to preserve it.

OnionShare stores all such data in a specific folder. Copy the relevant folder for your operating system below, to your new computer:

Linux: ~/.config/onionshare

macOS: ~/Library/Application Support/OnionShare

Windows: %APPDATA%\OnionShare

Configuration file parameters

OnionShare stores its settings in a JSON file. Both the CLI and the Desktop versions use this configuration file. The CLI also lets you specify a path to a custom configuration file with --config.

Below are the configuration file parameters and what they mean. If your configuration file has other parameters not listed here, they may be obsolete from older OnionShare versions.

Parameter	Type	Explanation
version	`string`	The version of OnionShare. You should not ever need to change this value.
connection_type	`string`	The way in which OnionShare connects to Tor. Valid options are ‚bundled‘, ‚automatic‘ (use Tor Browser’s Tor connection), ‚control_port‘ or ‚socket_file‘. Default: ‚bundled‘
control_port_address	`string`	The IP address of Tor’s Control port, if `connection_type` is set to ‚control_port‘. Default: ‚127.0.0.1‘
control_port_port	`integer`	The port number of Tor’s Control port, if `connection_type` is set to ‚control_port‘. Default: ‚9051‘
socks_address	`string`	The IP address of Tor’s SOCKS proxy, if `connection_type` is set to ‚control_port‘ or ‚socket_file‘. Default: ‚127.0.0.1‘
socks_port	`integer`	The port number of Tor’s SOCKS proxy, if `connection_type` is set to ‚control_port‘ or ‚socket_file‘. Default: ‚‘9050‘
socket_file_path	`string`	The path to Tor’s socket file, if `connection_type` is set to ‚socket_file‘. Default: ‚/var/run/tor/control‘
auth_type	`string`	If access to Tor’s control port requires a password, this can be set to ‚password‘, otherwise ‚no_auth‘. Default: ‚no_auth‘
auth_password	`string`	If access to Tor’s control port requires a password, and `auth_type` is set to ‚password‘, specify the password here. Default: ‚‘
auto_connect	`boolean`	Whether OnionShare should automatically connect to Tor when it starts. Default: False
use_autoupdate	`boolean`	Whether OnionShare should automatically check for updates (over Tor). This setting is only valid for MacOS or Windows installations. Default: True.
autoupdate_timestamp	`integer`	The last time OnionShare checked for updates. Default: None
bridges_enabled	`boolean`	Whether to connect to Tor using bridges. Default: False
bridges_type	`string`	When `bridges_enabled` is True, where to load bridges from. Options are „built-in“ (bridges shipped with OnionShare and which may get updated from Tor), „moat“ (request bridges from Tor’s Moat API), or „custom“ (user-supplied bridges). Default: „built-in“
bridges_builtin_pt	`string`	When `bridges_type` is set to „built-in“, this specifies which type of bridge protocol to use. Options are „obfs4“, „meek-azure“ or „snowflake“. Default: „obfs4“
bridges_moat	`string`	When `bridges_type` is set to „moat“, the bridges returned from Tor’s Moat API are stored here. Default: „“
bridges_custom	`string`	When `bridges_type` is set to „custom“, the bridges specified by the user are stored here. Separate each bridge line in the string with ‚n‘. Default: „“
bridges_builtin	`dict`	When `bridges_type` is set to „built-in“, OnionShare obtains the latest built-in bridges recommended by Tor and stores them here. Default: {}
persistent_tabs	`list`	If the user has defined any tabs as ‚saved‘ (meaning that they are persistent each time OnionShare starts, and their onion address doesn’t change), these are given a random identifier which gets listed here. The persistent onion is stored as a JSON file with the same name as this identifier, in a subfolder of the OnionShare configuration folder called ‚persistent‘. Default: []
locale	`string`	The locale used in OnionShare. Default: None (which is the same as ‚en‘). For valid locale codes, see ‚available_locales‘ in https://github.com/onionshare/onionshare/blob/main/cli/onionshare_cli/settings.py
theme	`boolean`	The theme for the OnionShare desktop app. Valid options are 0 (automatically detect the user’s computer’s light or dark theme), 1 (light) or 2 (dark).

Configuration file parameters for persistent onions

As described above, each ‚persistent‘ onion has parameters of its own which are stored in its own JSON file. The path to this file can be specified for the CLI tool with --persistent.

Here is an example persistent JSON configuration:

{
  "onion": {
      "private_key": "0HGxILDDwYhxAB2Zq8mM3Wu3MirBgK7Fw2/tVrTw1XraElH7MWbVn3lzKbcJEapVWz2TFjaoCAVN48hGqraiRg==",
      "client_auth_priv_key": "UT55HDBA5VSRWOUERMGOHEIBKZCMOOGZAFFNI54GDQFZ6CMCUGIQ",
      "client_auth_pub_key": "TPQCMCV26UEDMCWGZCWAWM4FOJSQKZZTVPC5TC3CAGMDWKV255OA"
  },
  "persistent": {
      "mode": "share",
      "enabled": true,
      "autostart_on_launch": false
  },
  "general": {
      "title": null,
      "public": false,
      "autostart_timer": false,
      "autostop_timer": false,
      "service_id": "hvsufvk2anyadehahfqiacy4wbrjt2atpnagk4itlkh4mdfsg6vhd5ad"
  },
  "share": {
      "autostop_sharing": true,
      "filenames": [
          "/home/user/git/onionshare/desktop/org.onionshare.OnionShare.svg"
      ],
      "log_filenames": false
  },
  "receive": {
      "data_dir": "/home/user/OnionShare",
      "webhook_url": null,
      "disable_text": false,
      "disable_files": false
  },
  "website": {
      "disable_csp": false,
      "custom_csp": null,
      "log_filenames": false,
      "filenames": []
  },
  "chat": {}
}

Below are the configuration file parameters for a persistent onion and what they mean, for each section in the JSON

onion

Parameter	Type	Explanation
private_key	`string`	Base64-encoded private key of the onion service
client_auth_priv_key	`string`	The private key when using Client Authentication. Send this to the user.
client_auth_pub_key	`string`	The public key when using Client Authentication. Used on OnionShare’s side.

persistent

Parameter	Type	Explanation
mode	`string`	The mode used by this persistent onion. Options are „share“, „receive“, „website“ or „chat“.
enabled	`boolean`	Whether persistence is enabled for this onion. When the persistent option is unchecked in the desktop, this entire JSON file is deleted. Default: true
autostart_on_launch	`boolean`	Whether to automatically start this persistent onion when OnionShare starts and once Tor is connected. Default: false

general

Parameter	Type	Explanation
title	`string`	An optional custom title for displaying on the onion service. Default: null („OnionShare“ will be shown instead)
public	`boolean`	Whether the onion service can be accessed with or without a Private Key (Client Authentication). If true, no Private Key is required.
autostart_timer	`boolean`	Whether the onion service is configured to start at a specific time. The time can be set in the desktop app or specified in seconds with `--auto-start-timer` with the CLI tool. Default: false
autostop_timer	`boolean`	Whether the onion service is configured to stop at a specific time. The time can be set in the desktop app or specified in seconds with `--auto-stop-timer` with the CLI tool. Default: false
service_id	`string`	The 32-character onion service URL, without the scheme and without the ‚.onion‘ suffix.

The below are settings specific to the ‚mode‘ specified in the persistent section above.

share

Parameter	Type	Explanation
autostop_sharing	`boolean`	Whether to automatically stop the share once files are downloaded the first time. Default: true
filenames	`list`	A list of files to share. Default: []
log_filenames	`boolean`	Whether to log URL requests to stdout when using the CLI tool. Default: false

receive

Parameter	Type	Explanation
data_dir	`string`	The path where received files or text messages will be stored. Default: the ‚OnionShare‘ folder of the user’s home directory.
webhook_url	`string`	A webhook URL that OnionShare will POST to when it receives files or text messages. Default: null
disable_text	`boolean`	Whether to disable receiving text messages. Default: false
disable_files	`boolean`	Whether to disable receiving files. Default: false

website

Parameter	Type	Explanation
disable_csp	`boolean`	If set to `true`, OnionShare won’t set its default Content Security Policy header for the website. Default: `false`
custom_csp	`string`	A custom Content Security Policy header to send instead of the default.
log_filenames	`boolean`	Whether to log URL requests to stdout when using the CLI tool. Default: false
filenames	`list`	A list of files to share. Default: []

chat

There are currently no configurable settings for the Chat mode.