Инсталиране

Windows или macOS

Изтеглете OnionShare за Windows и macOS от страницата на OnionShare.

Мобилно

Можете да изтеглите OnionShare за мобилни платформи от следните места

Linux

Има различни начини да инсталирате OnionShare за Linux, но препоръчителният е да използвате пакетите Flatpak или Snap. Flatpak и Snapcraft гарантират, че винаги ще използвате най-новото издание и OnionShare ще работи в контролирана среда.

Поддръжката за Snapcraft е вградена в Ubuntu, а Fedora идва с поддръжка за Flatpak, но изборът е изцяло ваш. И двата пакета работят във всички варианти на 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, използвайки подписания с 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 за всяка операционна система с използваща на управлението на пакети 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, вижте секция в официалното Ръководство за pkg.

Ръчна инсталация от port

За да инсталирате порта за FreeBSD, преминете към директорията на колекцията от портове, която сте извлекли предварително, и изпълнете следното:

make -s -C www/onionshare all install clean

Колекцията от портове също предлага и отделен порт само за команден ред на OnionShare. Заменете www/onionshare с www/onionshare-cli ако искате да инсталирате тази версия.

За допълнителна информация и подробности относно колекциите от пакети за FreeBSD, вижте `секция в официалното Ръководство за портовете<https://docs.freebsd.org/en/books/handbook/ports/#ports-using>`_.

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

Можете сами да се уверите в целостта на изтегления файл като проверите цифровия му подпис на PGP. За Windows и macOS тази стъпка не е задължителна, но дава допълнителна сигурност, тъй като двоичните файлове на OnionShare съдържат специални за тези операционни системи цифрови подписи. Можете да разчитате и само на тях.

Ключ за подписи

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

За да проверявате цифрови подписи трябва да имате инсталирано приложението GnuPG. За macOS е препоръчително GPGTools, а за Windows – Gpg4win.

Подписи

Можете да намерите подписите (като файлове с разширение .asc), както и пакети за Windows, macOS, Flatpak, Snap и изходен код на адрес https://onionshare.org/dist/ в папки, именувани за всяко издание на OnionShare. Можете също така да ги намерите на страницата с ` издания в GitHub <https://github.com/onionshare/onionshare/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, ръководствата за Qubes OS и Tor Project могат да ви бъдат полезни.