Instalacja

Windows lub macOS

Możesz pobrać OnionShare dla Windows i macOS ze strony OnionShare.

Mobile

You can download OnionShare for Mobile from the follow links

Linux

Istnieją różne sposoby instalacji OnionShare dla systemu Linux, ale zalecanym sposobem jest użycie pakietu Flatpak lub Snap . Flatpak i Snap zapewnią, że zawsze będziesz korzystać z najnowszej wersji i uruchamiać OnionShare w piaskownicy.

Obsługa Snapcraft jest wbudowana w Ubuntu, a Fedora jest dostarczana z obsługą Flatpak, ale to, z którego korzystasz, zależy od Ciebie. Oba działają we wszystkich dystrybucjach Linuksa.

Instalacja OnionShare przy użyciu Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Instalacja OnionShare przy użyciu Snapcraft: https://snapcraft.io/onionshare

Jeśli wolisz, możesz również pobrać i zainstalować podpisane przez PGP pakiety .flatpak lub .snap z https://onionshare.org/dist/.

Ręczna instalacja Flatpak

Jeśli chcesz ręcznie zainstalować OnionShare z Flatpak, używając podpisanego PGP single-file bundle, możesz to zrobić w ten sposób:

  • Zainstaluj Flatpak, postępując zgodnie z instrukcjami na stronie https://flatpak.org/setup/.

  • Dodaj repozytorium Flathub, uruchamiając flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Nawet jeśli nie będziesz pobierać OnionShare z Flathub, OnionShare zależy od niektórych pakietów, które są dostępne tylko tam.

  • Przejdź do https://onionshare.org/dist/, wybierz najnowszą wersję OnionShare i pobierz pliki .flatpak i .flatpak.asc.

  • Sprawdź podpis PGP pliku .flatpak. Zobacz Weryfikacja sygnatur PGP, aby uzyskać więcej informacji.

  • Zainstaluj plik .flatpak, uruchamiając flatpak install OnionShare-VERSION.flatpak. Zastąp VERSION numerem wersji pobranego pliku.

Możesz uruchomić OnionShare za pomocą: flatpak run org.onionshare.OnionShare.

Ręczna instalacja Snapcraft

Jeśli chcesz ręcznie zainstalować OnionShare za pomocą Snapcraft przy użyciu pakietu Snapcraft podpisanego przez PGP, możesz to zrobić w następujący sposób:

  • Zainstaluj Snapcraft, postępując zgodnie z instrukcjami na stronie https://snapcraft.io/docs/installing-snapd.

  • Przejdź do https://onionshare.org/dist/, wybierz najnowszą wersję OnionShare i pobierz pliki .snap i .snap.asc.

  • Sprawdź podpis PGP pliku .snap. Zobacz Weryfikacja sygnatur PGP, aby uzyskać więcej informacji.

  • Zainstaluj plik .snap, uruchamiając snap install --dangerous onionshare_VERSION_amd64.snap. Zastąp VERSION numerem wersji pobranego pliku. Pamiętaj, że musisz użyć –dangerous, ponieważ pakiet nie jest podpisany przez sklep Snapcraft, jednak zweryfikowano jego podpis PGP, więc wiesz, że jest legalny.

Możesz uruchomić OnionShare za pomocą: snap run onionsshare.

Wiersz poleceń

Możesz zainstalować tylko wersję wiersza poleceń OnionShare na dowolnym systemie operacyjnym za pomocą menedżera pakietów Python pip. Zobacz Wiersz Poleceń, aby uzyskać więcej informacji.

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.

Weryfikacja sygnatur PGP

Możesz sprawdzić, czy pobrany pakiet jest poprawny i nie został naruszony, weryfikując jego podpis PGP. W przypadku systemów Windows i macOS ten krok jest opcjonalny i zapewnia dogłębną ochronę: pliki binarne OnionShare zawierają podpisy specyficzne dla systemu operacyjnego i jeśli chcesz, możesz po prostu na nich polegać.

Klucz podpisujący

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

Aby zweryfikować podpisy, musisz mieć zainstalowane GnuPG. Dla macOS prawdopodobnie potrzebujesz GPGTools, a dla Windows Gpg4win.

Sygnatury

Podpisy (jako pliki .asc), a także pakiety Windows, macOS, Flatpak, Snap i źródła można znaleźć pod adresem https://onionshare.org/dist/ w folderach nazwanych od każdej wersji OnionShare. Możesz je również znaleźć na stronie Releases serwisu GitHub.

Weryfikacja

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:

Dla Windows:

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

Dla macOS:

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

Dla Linuksa:

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)

oraz dla pliku źródłowego:

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

Oczekiwany rezultat wygląda następująco:

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

Jeśli nie widzisz Good signature from, może występować problem z integralnością pliku (złośliwy lub inny) i nie należy instalować pakietu.

WARNING: pokazane powyżej nie stanowi problemu z pakietem, oznacza jedynie, że nie określono poziomu „zaufania” dla klucza PGP Micaha (głównego programisty).

Jeśli chcesz dowiedzieć się więcej o weryfikowaniu podpisów PGP, przydatne mogą być przewodniki dotyczące Qubes OS i Tor Project.