Installation

Windows eller macOS

Du kan ladda ner OnionShare för Windows och macOS från OnionShares webbplats.

Mobil

Du kan hämta OnionShare för mobila enheter från följande länkar

Linux

Det finns olika sätt att installera OnionShare för Linux, men det rekommenderade sättet är att använda antingen Flatpak eller Snap paketet. Flatpak och Snapcraft säkerställer att du alltid använder den senaste versionen och kör OnionShare inuti en sandlåda.

Snapcraft-stöd är inbyggt i Ubuntu och Fedora har stöd för Flatpak, men vilket du använder är upp till dig. Båda fungerar i alla Linux-distributioner.

Installera OnionShare som Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Installera OnionShare med Snapcraft: https://snapcraft.io/onionshare

Du kan också ladda ner och installera PGP-signerad .flatpak eller .snap från https://onionshare.org/dist/ om du föredrar det.

Manuell Flatpak-installation

Om du vill installera OnionShare manuellt med Flatpak med hjälp av det PGP-signerade single-file bundle, kan du göra det så här:

  • Installera Flatpak genom att följa instruktionerna på https://flatpak.org/setup/.

  • Lägg till Flathub-arkivet genom att köra flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Även om du inte kommer att ladda ner OnionShare från Flathub, är OnionShare beroende av vissa paket som bara är tillgängliga där.

  • Gå till https://onionshare.org/dist/, välj den senaste versionen av OnionShare och hämta filerna .flatpak och .flatpak.asc.

  • Verifiera PGP-signaturen för .flatpak-filen. Se Verifiera PGP-signaturer för mer information.

  • Installera .flatpak-filen genom att köra flatpak install OnionShare-VERSION.flatpak. Ersätt VERSION med versionsnumret på filen du hämtade.

Du kan köra OnionShare med: flatpak run org.onionshare.OnionShare.

Manuell Snapcraft-installation

Om du vill installera OnionShare manuellt med Snapcraft med hjälp av det PGP-signerade Snapcraft-paketet kan du göra det så här:

  • Installera Snapcraft genom att följa instruktionerna på https://snapcraft.io/docs/installing-snapd.

  • Gå till https://onionshare.org/dist/, välj den senaste versionen av OnionShare och hämta filerna .snap och .snap.asc.

  • Verifiera PGP-signaturen för .snap-filen. Se Verifiera PGP-signaturer för mer information.

  • Installera .snap-filen genom att köra snap install --dangerous onionshare_VERSION_amd64.snap. Ersätt VERSION med versionsnumret på filen du hämtade. Observera att du måste använda –dangerous eftersom paketet inte är signerat av Snapcraft-butiken, men du verifierade dess PGP-signatur, så du vet att den är legitim.

Du kan köra OnionShare med: snap run onionshare.

Endast kommandorad

Du kan installera kommandoradsversionen av OnionShare på vilket operativsystem som helst med hjälp av Pythons pakethanterare pip. Gränssnitt för kommandoraden har mer information.

FreeBSD

Även om det inte officiellt utvecklats för denna plattform, kan OnionShare också installeras på FreeBSD. Det är tillgängligt via dess portsamling eller som ett förbyggt paket. Om du väljer att installera och använda OnionShare på ett FreeBSD-operativsystem, var vänlig medveten om att det INTE officiellt stöds av OnionShare-projektet.

Även om de inte erbjuds och officiellt underhålls av OnionShare-utvecklarna, hämtar och verifierar FreeBSD-paketen och porteringarna källkoden från det officiella OnionShare-arkivet (eller dess officiella utgåvor från PyPI). Om du vill kontrollera ändringar relaterade till denna plattform, se följande resurser:

Manuell pkg-installation

För att installera binärpaketet, använd pkg install pyXY-onionshare, där pyXY anger vilken version av Python som paketet byggdes för. Så, för att installera OnionShare för Python 3.9, använd:

pkg install py39-onionshare

Det finns också en version endast kommandorad av OnionShare tillgänglig som förbyggt paket. Ersätt py39-onionshare med py39-onionshare-cli om du vill installera den versionen.

För ytterligare information och detaljer om FreeBSDs förbyggda paket, se dess officiella handbokavsnitt om paket.

Manuell portinstallation

För att installera FreeBSD-porten, ändra katalogen till portsamling som du måste ha checkat ut tidigare och kör följande:

make -s -C www/onionshare all install clean

Portsamlingen erbjuder också en dedikerad port för kommandoradsversionen av OnionShare. Ersätt www/onionshare med www/onionshare-cli om du vill installera den versionen.

För ytterligare information och detaljer om FreeBSD-portsamlingen, vänligen se dess officiella handbokavsnitt om portar.

Verifiera PGP-signaturer

Du kan verifiera att paketet du laddar ned är legitimt och inte har manipulerats genom att verifiera dess PGP-signatur. För Windows och macOS är det här steget valfritt och ger försvar på djupet: OnionShare-binärfilerna innehåller operativsystemspecifika signaturer, och du kan bara lita på enbart dem om du vill.

Signeringsnyckel

Paketen signeras av den kärnutvecklare som ansvarar för den specifika utgåvan. Här är GPG-nyckelinformationen för var och en av OnionShares kärnutvecklare:

Du måste ha GnuPG installerat för att verifiera signaturer. För macOS vill du förmodligen ha GPGTools, och för Windows vill du förmodligen ha Gpg4win.

Signaturer

Du hittar signaturerna (som .asc-filer), såväl som Windows-, macOS-, Flatpak-, Snap- och källkodspaket, på https://onionshare.org/dist/ i mapparna som namnges för varje version av OnionShare. Du hittar dem också på sidan GitHub Releases.

Verifierar

När du har importerat utvecklarnas publika nycklar till din GnuPG-nyckelring, hämtat binärfilen och .asc-signaturen, kan du verifiera binärfilen i en terminal så här:

För Windows:

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

För macOS:

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

För 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)

och för källfilen:

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

Förväntad utdata ser ut så här:

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

Om du inte ser Bra signatur från kan det vara ett problem med filens integritet (skadlig eller annan), och du bör inte installera paketet.

VARNINGEN: som visas ovan är inte ett problem med paketet, det betyder bara att du inte har definierat en nivå av ”tillit” för Micahs (huvudutvecklaren) PGP-nyckel.

Om du vill veta mer om hur du verifierar PGP-signaturer kan guiderna för ”Qubes OS <https://www.qubes-os.org/security/verifying-signatures/>” och Tor Project <https://support.torproject.org/tbb/how-to-verify-signature/>_ vara användbara.