Instalacja

Windows lub macOS

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

Mobilne

Możesz pobrać OnionShare na urządzenia mobilne, korzystając z poniższych łączy

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

Chociaż nie jest on oficjalnie opracowany dla tej platformy, OnionShare można również zainstalować na FreeBSD. Jest dostępny poprzez kolekcję portów lub jako gotowy pakiet. Jeśli zdecydujesz się zainstalować i używać OnionShare w systemie operacyjnym FreeBSD, pamiętaj, że NIE jest oficjalnie wspierany przez projekt OnionShare.

Chociaż pakiety i porty FreeBSD nie są oferowane ani oficjalnie utrzymywane przez twórców OnionShare, pobierają i weryfikują kody źródłowe z oficjalnego repozytorium OnionShare (lub jego oficjalnych pakietów wydań z PyPI). Jeśli chcesz sprawdzić zmiany związane z tą platformą, zapoznaj się z poniższymi zasobami:

Ręczna instalacja pkg

Aby zainstalować pakiet binarny, użyj pkg install pyXY-onionshare, gdzie pyXY określa wersję Pythona, dla której pakiet został skompilowany. Aby więc zainstalować OnionShare dla Pythona 3.9, użyj:

pkg install py39-onionshare

Dostępna jest także wersja OnionShare wyłącznie w wierszu poleceń, dostępna jako gotowy pakiet. Zamień py39-onionshare na py39-onionshare-cli, jeśli chcesz zainstalować tę wersję.

Dodatkowe informacje i szczegóły dotyczące prekompilowanych pakietów FreeBSD można znaleźć w jego oficjalnej sekcji podręcznika na temat pkg.

Ręczna instalacja portu

Aby zainstalować port FreeBSD, zmień katalog na kolekcję portów, które należało wcześniej sprawdzić i uruchom następujące polecenie:

make -s -C www/onionshare all install clean

Kolekcja portów oferuje także dedykowany port dla wersji OnionShare tylko w wierszu poleceń. Zamień www/onionshare na www/onionshare-cli, jeśli chcesz zainstalować tę wersję.

Dodatkowe informacje i szczegóły dotyczące kolekcji portów FreeBSD można znaleźć w jego oficjalnej sekcji podręcznika na temat portów.

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

Pakiety są podpisywane przez głównego programistę, który jest odpowiedzialny za daną wersję. Oto najważniejsze informacje GPG o każdym z głównych twórców 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

Po zaimportowaniu kluczowych kluczy publicznych programistów do pęku kluczy GnuPG, pobraniu pliku binarnego i podpisu .asc, możesz zweryfikować plik binarny w terminalu w następujący sposób:

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.