Встановлення

Windows або macOS

Ви можете завантажити OnionShare для Windows та macOS із вебсайту OnionShare.

Mobile

You can download OnionShare for Mobile from the follow links

Linux

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

Підтримку Snapcraft вбудовано в Ubuntu, а Flatpak — у Fedora, але ви самі можете обрати чим користуватися. Вони обоє працюють у всіх дистрибутивах Linux.

Установити OnionShare за допомогою Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Установити OnionShare за допомогою Snapcraft: https://snapcraft.io/onionshare

Ви також можете завантажити та встановити пакунки з PGP-підписом .flatpak або .snap з https://onionshare.org/dist/, якщо хочете.

Ручне встановлення Flatpak

Якщо ви хочете встановити OnionShare вручну за допомогою Flatpak, використовуючи підписаний PGP однофайловий пакунок, ви можете зробити це так:

  • Установіть 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, запустивши snap install --dangerous onionshare_VERSION_amd64.snap. Замініть VERSION на номер версії файлу, який ви завантажили. Зауважте, що ви повинні використовувати –dangerous, оскільки пакунок не підписано магазином Snapcraft, проте ви перевірили його підпис PGP, тому знаєте, що він справжній.

Запустити OnionShare можна за допомогою: 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:

Для перевірки підписів потрібно встановити GnuPG. Для macOS ви, ймовірно, захочете GPGTools, а для Windows ви, ймовірно, захочете Gpg4win.

Підписи

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

Перевірка

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:

Для 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 від Micah (основного розробника).

Докладніше про перевірку підписів PGP читайте у настановах для Qubes OS та Tor Project.