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

Windows або macOS

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

Для мобільного

Ви можете завантажити OnionShare для мобільного за цими посиланнями

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

Хоча OnionShare офіційно не розроблено для цієї платформи, його також можна встановити на FreeBSD. Він доступний через портовану збірку або у вигляді готового пакунка. Якщо ви вирішите встановити й використовувати OnionShare на операційній системі FreeBSD зауважте, що вона офіційно НЕ підтримується проєктом OnionShare.

Хоча розробники OnionShare не пропонують і офіційно не підтримують пакунки та порти FreeBSD, вони отримують і перевіряють код з офіційного репозиторію OnionShare (або його офіційних випусків пакунків з PyPI). Якщо ви захочете перевірити зміни, пов’язані з цією платформою зверніться до таких ресурсів:

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

Щоб установити двійковий пакунок, використовуйте pkg install pyXY-onionshare, де pyXY вказує на версію Python, для якої було зібрано пакунок. Отже, щоб встановити OnionShare для Python 3.9, використовуйте:

pkg install py39-onionshare

Існує також версія OnionShare тільки для командного рядка, яка доступна у вигляді попередньо зібраного пакунка. Замініть py39-onionshare на py39-onionshare-cli, якщо ви хочете встановити цю версію.

Додаткову інформацію та подробиці про попередньо зібрані пакунки FreeBSD можна знайти у розділі official Handbook про pkg.

Ручне встановлення з портувань

Щоб установити порт FreeBSD, змініть каталог на ports collection, з якого ви повинні були вийти раніше, і запустіть команду:

make -s -C www/onionshare all install clean

У збірці портів також є спеціальний порт для версії OnionShare Тільки для командного рядка. Замініть www/onionshare на www/onionshare-cli, якщо ви хочете встановити цю версію.

Додаткову інформацію про збірку портів FreeBSD можна знайти у розділі офіційного довідника про порти.

Перевірка підписів PGP

Ви можете переконатися, що пакет, який ви завантажуєте, є справжнім і не був підроблений, перевіривши його підпис PGP. Для Windows і macOS цей крок не є обов’язковим і забезпечує захист в глибині: двійкові файли OnionShare включають підписи, специфічні для операційної системи, і ви можете просто покладатися лише на них, якщо хочете.

Ключ підпису

Пакунки підписуються основним розробником, який відповідає за конкретний випуск. Ось ключова інформація GPG для кожного з основних розробників OnionShare:

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

Підписи

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

Перевірка

Після імпорту відкритих ключів основних розробників імпортовано до вашої збірки ключів 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 від Micah (основного розробника).

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