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
- Android
- iOS
Apple App Store: https://apps.apple.com/app/onionshare/id1601890129
Direct IPA download: https://github.com/onionshare/onionshare-ios/releases
Testflight: https://testflight.apple.com/join/ZCJeY65W
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ącflatpak install OnionShare-VERSION.flatpak
. ZastąpVERSION
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ącsnap install --dangerous onionshare_VERSION_amd64.snap
. ZastąpVERSION
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:
- Micah Lee:
PGP public key fingerprint
927F419D7EC82C2F149C1BD1403C2657CD994F73
.You can download Micah’s key from the keys.openpgp.org keyserver.
- Saptak Sengupta:
PGP public key fingerprint
2AE3D40A6905C8E4E8ED95ECE46A2B977C14666B
.You can download Saptak’s key from the keys.openpgp.org keyserver.
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.