Установка

Windows или macOS

Загрузить OnionShare для Windows или macOS можно по ссылке: OnionShare.

Мобильный

Скачать OnionShare для мобильных устройств можно по следующим ссылкам

Linux

Существуют разные способы установки OnionShare на Linux. Рекомендуется использовать такие менеджеры пакетов, как Flatpak или Snap. Их использование гарантирует, что будет произведена установка самой свежей версии OnionShare и что его запуск будет производиться «в песочнице» (в специально выделенной (изолированной) среде для безопасного исполнения компьютерных программ).

По умолчанию поддержка Snap предусмотрена дистрибутивами Ubuntu, поддержка Flatpak — дистрибутивами Fedora. Нужно отметить, что окончательный выбор менеджера пакетов остаётся за пользователем, поскольку и тот, и другой работают во всех дистрибутивах Linux.

Установка OnionShare c использованием Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Установка OnionShare с использованием Snap: https://snapcraft.io/onionshare

Также, в случае необходимости, загрузить и установить имеющие цифровую PGP-подпись пакеты .flatpak или .snap можно отсюда: https://onionshare.org/dist/.

Ручная установка Flatpak

Если вы хотите установить OnionShare вручную с помощью Flatpak, используя подписанный PGP single-file bundle, вы можете сделать это следующим образом:

  • Установите Flatpak, следуя инструкциям на сайте https://flatpak.org/setup/.

  • Добавьте репозиторий Flathub, запустив flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Несмотря на то, что вы не будете загружать OnionShare с Flathub, OnionShare зависит от некоторых пакетов, которые доступны только там.

  • Перейдите на сайт https://onionshare.org/dist/, выберите последнюю версию OnionShare и загрузите файлы .flatpak и .flatpak.asc.

  • Проверка PGP-подписи файла .flatpak. Дополнительную информацию смотрите в Проверка подписей PGP.

  • Установите файл .flatpak, выполнив команду flatpak install OnionShare-VERSION.flatpak. Замените VERSION на номер версии загруженного файла.

Запустить OnionShare можно с помощью: flatpak run org.onionshare.OnionShare.

Руководство по установке Snapcraft

Если вы хотите установить OnionShare вручную с помощью Snapcraft, используя пакет Snapcraft с PGP-подписью, вы можете сделать это следующим образом:

  • Установите Snapcraft, следуя инструкциям на сайте https://snapcraft.io/docs/installing-snapd.

  • Перейдите на сайт https://onionshare.org/dist/, выберите последнюю версию OnionShare и загрузите файлы .snap и .snap.asc.

  • Проверка PGP-подписи файла .snap. Дополнительную информацию см. в Проверка подписей PGP.

  • Установите файл .snap, выполнив команду nap install --dangerous onionshare_VERSION_amd64.snap. Замените VERSION на номер версии загруженного файла. Обратите внимание, что вы должны использовать –dangerous, потому что пакет не подписан магазином Snapcraft, однако вы проверили его PGP-подпись, поэтому вы знаете, что он легитимный.

Вы можете запустить OnionShare с помощью: nap run onionshare.

Отдельная установка консольной версии

Консольную версию OnionShare можно установить отдельно на любую операционную систему при помощи менеджера пакетов Python pip. Больше информации можно найти по Интерфейс командной строки.

FreeBSD

Несмотря на то, что OnionShare официально не разрабатывался для этой платформы, его можно установить и на FreeBSD. Он доступен через коллекцию портов или в виде предварительно собранного пакета. Если вы решите установить и использовать OnionShare на операционной системе FreeBSD, пожалуйста, имейте в виду, что проект OnionShare НЕ официально поддерживается.

Несмотря на то, что разработчики OnionShare не предлагают и не поддерживают ее официально, пакеты и порты FreeBSD получают и проверяют исходные коды из официального репозитория OnionShare (или ее официальных релизных пакетов из PyPI). Если вы хотите проверить изменения, связанные с этой платформой, пожалуйста, обратитесь к следующим ресурсам:

Руководство по установке

Чтобы поставить бинарный пакет, используйте pkg install pyXY-onionshare, при этом pyXY указывает версию Python, для которой был собран пакет. Так, чтобы установить OnionShare для Python 3.9, используйте:

pkg install py39-onionshare

Существует также версия OnionShare только для командной строки, доступная в виде предварительно собранного пакета. Замените py39-onionshare на py39-onionshare-cli, если вы хотите установить эту версию.

Для получения дополнительной информации и подробностей о предварительно собранных пакетах FreeBSD, пожалуйста, обратитесь к разделу официального руководства о pkg.

Установка порта вручную

Чтобы установить порт FreeBSD, перейдите в каталог ports collection, который вы должны были проверить ранее, и выполните следующее:

make -s -C www/onionshare all install clean

Коллекция портов также предлагает специальный порт для Command-line only версии OnionShare. Замените www/onionshare на www/onionshare-cli, если вы хотите установить эту версию.

За дополнительной информацией и подробностями о коллекции портов FreeBSD обращайтесь к разделу `Официального справочника по портам<https://docs.freebsd.org/en/books/handbook/ports/#ports-using>`_.

Проверка подписей PGP

Пользователь может произвести проверку целостности самостоятельно загруженных пакетов при помощи цифровой подписи PGP. Это необязательный шаг для операционных систем Windows и macOS, по скольку бинарные файлы OnionShare уже содержат в себе цифровые подписи, специфичные для каждой из этих операционных систем. Тем не менее, возможность такой проверки предусмотрена, в случае если есть необходимость дополнительно удостовериться в безопасности загруженных файлов.

Ключ подписи

Packages are signed by the core developer who is responsible for the particular release. Here is the GPG key information for each of the core developers of OnionShare:

  • Майка Ли:
  • Саптак Сенгупта:

    • Отпечаток открытого ключа PGP 2AE3D40A6905C8E4E8ED95ECE46A2B977C14666B.

    • Вы можете скачать ключ Саптака с сервера ключей keys.openpgp.org.

  • Miguel Jacq:

Для проверки цифровых подписей PGP на компьютере пользователя должно быть установлено программное обеспечение GnuPG. Для macOS рекомендуется использовать GPGTools, для Windows Gpg4win.

Подписи

Вы можете найти сигнатуры (в виде файлов .asc), а также пакеты для Windows, macOS, Flatpak, Snap и исходные тексты по адресу https://onionshare.org/dist/ в папках, названных для каждой версии OnionShare. Вы также можете найти их на странице GitHub Releases.

Проверка

После того как вы импортировали открытые ключи разработчиков ядра в свою связку ключей GnuPG, загрузили бинарник и подпись .asc, вы можете проверить бинарник в терминале следующим образом:

Для Windows:

gpg --verify OnionShare-win64-2.6.msi.asc OnionShare-win64-2.6.msi (Windows 64-bit)

Для macOS:

gpg --verify OnionShare-2.6.dmg.asc OnionShare-2.6.dmg

Для Linux:

gpg --verify OnionShare-2.6.flatpak.asc OnionShare-2.6.flatpak (Flatpak)

gpg --verify onionshare_2.6_amd64.snap.asc onionshare_2.6_amd64.snap (Snap)

и для исходного файла:

gpg --verify onionshare-2.6.tar.gz.asc onionshare-2.6.tar.gz

Ожидаемый результат выполнения команды:

gpg: Signature made Mo 10 Okt 2022 02:27:16 CEST
gpg:                using RSA key 927F419D7EC82C2F149C1BD1403C2657CD994F73
gpg: Good signature from "Micah Lee <micah@micahflee.com>" [unknown]
gpg:                 aka "Micah Lee <micah.lee@firstlook.media>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 927F 419D 7EC8 2C2F 149C  1BD1 403C 2657 CD99 4F73

Если вы не видите Good signature from, возможно, существует проблема с целостностью файла (вредоносная или иная), и вам не следует устанавливать пакет.

Предупреждение WARNING:, показанное выше, не является проблемой с пакетом, оно лишь означает, что вы не определили уровень «доверия» к PGP-ключу Михи (основного разработчика).

Дополнительную информацию о проверке цифровых подписей PGP можно здесь: Qubes OS и здесь: Tor Project .