Установка

Windows или macOS

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

Mobile

You can download OnionShare for Mobile from the follow links

Android
- Google Play: https://play.google.com/store/apps/details?id=org.onionshare.android
- F-Droid: https://github.com/onionshare/onionshare-android-nightly
iOS
- Apple App Store: https://apps.apple.com/app/onionshare/id1601890129
- Direct IPA download: https://github.com/onionshare/onionshare-ios/releases
- Testflight: https://testflight.apple.com/join/ZCJeY65W

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/.

Manual Flatpak Installation

If you’d like to install OnionShare manually with Flatpak using the PGP-signed single-file bundle, you can do so like this:

Install Flatpak by following the instructions at https://flatpak.org/setup/.
Добавьте репозиторий Flathub, запустив flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Несмотря на то, что вы не будете загружать OnionShare с Flathub, OnionShare зависит от некоторых пакетов, которые доступны только там.
Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the .flatpak and .flatpak.asc files.
Verify the PGP signature of the .flatpak file. See Проверка подписей PGP for more info.
Install the .flatpak file by running flatpak install OnionShare-VERSION.flatpak. Replace VERSION with the version number of the file you downloaded.

You can run OnionShare with: flatpak run org.onionshare.OnionShare.

Manual Snapcraft Installation

If you’d like to install OnionShare manually with Snapcraft using the PGP-signed Snapcraft package, you can do so like this:

Install Snapcraft by following the instructions at https://snapcraft.io/docs/installing-snapd.
Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the .snap and .snap.asc files.
Verify the PGP signature of the .snap file. See Проверка подписей PGP for more info.
Install the .snap file by running snap install --dangerous onionshare_VERSION_amd64.snap. Replace VERSION with the version number of the file you downloaded. Note that you must use –dangerous because the package is not signed by the Snapcraft store, however you did verify its PGP signature, so you know it’s legitimate.

You can run OnionShare with: snap run onionshare.

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

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

FreeBSD

Althought not being officially developed for this platform, OnionShare can also be installed on FreeBSD. It’s available via its ports collection or as pre-built package. Should you opt to install and use OnionShare on a FreeBSD operating system, please be aware that it’s NOT officially supported by the OnionShare project.

Though not being offered and officially maintained by the OnionShare developers, the FreeBSD packages and ports do fetch and verifies the source codes from the official OnionShare repository (or its official release packages from PyPI). Should you wish to check changes related to this platform, please refer to the following resources:

Manual pkg Installation

To install the binary package, use pkg install pyXY-onionshare, with pyXY specifying the version of Python the package was built for. So, in order to install OnionShare for Python 3.9, use:

pkg install py39-onionshare

There’s also a Command-line only version of OnionShare available as pre-built package. Replace py39-onionshare by py39-onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD pre-built packages, please refer to its official Handbook section about pkg.

Manual port Installation

To install the FreeBSD port, change directory to the ports collection you must have checked out before and run the following:

make -s -C www/onionshare all install clean

The ports collection also offers a dedicated port for the Command-line only version of OnionShare. Replace www/onionshare by www/onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD ports collection, please refer to its official Handbook section about ports.

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

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

Ключ подписи

Packages are signed by the core developer who is responsible for the particular release. Following are the informations of the core developers of OnionShare:

Micah Lee:
- PGP public key fingerprint 927F419D7EC82C2F149C1BD1403C2657CD994F73.
- You can download Micah’s key from the keys.openpgp.org keyserver.
Saptak Sengupta:
- PGP public key fingerprint 2AE3D40A6905C8E4E8ED95ECE46A2B977C14666B.
- You can download Saptak’s key from the keys.openpgp.org keyserver.

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

Подписи

You can find the signatures (as .asc files), as well as Windows, macOS, Flatpak, Snap, and source packages, at https://onionshare.org/dist/ in the folders named for each version of OnionShare. You can also find them on the GitHub Releases page.

Проверка

Once you have imported the core developers public keys into your GnuPG keychain, downloaded the binary and .asc signature, you can verify the binary in a terminal like this:

For Windows:

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

For macOS:

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

For 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)

and for the source file:

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

If you don’t see Good signature from, there might be a problem with the integrity of the file (malicious or otherwise), and you should not install the package.

The WARNING: shown above, is not a problem with the package, it only means you haven’t defined a level of «trust» of Micah’s (the core developer) PGP key.

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