Telepítés

Windows vagy macOS

Az OnionShare Windows és macOS rendszerhez letölthető az OnionShare webhelyről.

Mobil

Az OnionShare mobilváltozata az alábbi hivatkozásokról tölthető le

Linux

Az OnionShare többféleképpen telepíthető Linuxra, de a javasolt mód a Flatpak vagy a Snap csomag használata. A Flatpak és a Snapcraft biztosítja, hogy mindig a legújabb verziót használja, és az OnionShare elkülönített környezetben (sandbox) fusson.

Az Ubuntu beépített Snapcraft-támogatással, a Fedora pedig Flatpak-támogatással rendelkezik, de hogy melyiket használja, az Önön múlik. Mindkettő minden Linux-disztribúción működik.

Az OnionShare telepítése Flatpak segítségével: https://flathub.org/apps/details/org.onionshare.OnionShare

Az OnionShare telepítése Snapcraft segítségével: https://snapcraft.io/onionshare

Ha úgy kívánja, PGP-aláírással ellátott .flatpak vagy .snap csomagokat is letölthet és telepíthet a https://onionshare.org/dist/ oldalról.

Kézi telepítés Flatpakkel

Ha az OnionShare-t kézzel szeretné telepíteni Flatpakkel, a PGP-aláírással ellátott egyfájlos csomag használatával, a következőképpen teheti meg:

  • Telepítse a Flatpaket a https://flatpak.org/setup/ oldalon található útmutató szerint.

  • Adja hozzá a Flathub tárolót a flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo parancs futtatásával. Bár az OnionShare-t nem a Flathubról tölti le, az OnionShare néhány olyan csomagtól függ, amelyek csak ott érhetők el.

  • Nyissa meg a https://onionshare.org/dist/ oldalt, válassza ki az OnionShare legújabb verzióját, és töltse le a .flatpak és a .flatpak.asc fájlt.

  • Ellenőrizze a .flatpak fájl PGP-aláírását. További információ: PGP-aláírások ellenőrzése.

  • Telepítse a .flatpak fájlt a flatpak install OnionShare-VERSION.flatpak parancs futtatásával. A VERSION helyére a letöltött fájl verziószámát írja.

Az OnionShare a következő paranccsal futtatható: flatpak run org.onionshare.OnionShare.

Kézi telepítés Snapcrafttal

Ha az OnionShare-t kézzel szeretné telepíteni Snapcrafttal, a PGP-aláírással ellátott Snapcraft-csomag használatával, a következőképpen teheti meg:

  • Telepítse a Snapcraftot a https://snapcraft.io/docs/installing-snapd oldalon található útmutató szerint.

  • Nyissa meg a https://onionshare.org/dist/ oldalt, válassza ki az OnionShare legújabb verzióját, és töltse le a .snap és a .snap.asc fájlt.

  • Ellenőrizze a .snap fájl PGP-aláírását. További információ: PGP-aláírások ellenőrzése.

  • Telepítse a .snap fájlt a snap install --dangerous onionshare_VERSION_amd64.snap parancs futtatásával. A VERSION helyére a letöltött fájl verziószámát írja. Ne feledje, hogy a –dangerous kapcsolót azért kell használnia, mert a csomagot nem a Snapcraft áruház írta alá, Ön viszont ellenőrizte a PGP-aláírását, így tudja, hogy hiteles.

Az OnionShare a következő paranccsal futtatható: snap run onionshare.

Csak parancssoros változat

Bármely operációs rendszeren telepítheti az OnionShare csak parancssoros változatát a pip Python-csomagkezelővel. További információ: Parancssoros felület.

FreeBSD

Bár nem hivatalosan erre a platformra fejlesztik, az OnionShare a FreeBSD rendszerre is telepíthető. A portgyűjteményen keresztül vagy előre lefordított csomagként érhető el. Ha az OnionShare-t FreeBSD operációs rendszeren kívánja telepíteni és használni, vegye figyelembe, hogy az OnionShare projekt ezt hivatalosan NEM támogatja.

Bár nem az OnionShare fejlesztői kínálják és tartják karban hivatalosan, a FreeBSD-csomagok és -portok a hivatalos OnionShare-tárolóból (vagy a PyPI-n található hivatalos kiadási csomagokból) töltik le és ellenőrzik a forráskódot. Ha szeretné nyomon követni az erre a platformra vonatkozó változásokat, tekintse meg a következő forrásokat:

Kézi telepítés pkg segítségével

A bináris csomag telepítéséhez használja a pkg install pyXY-onionshare parancsot, ahol a pyXY azt a Python-verziót adja meg, amelyhez a csomag készült. Az OnionShare Python 3.9-hez való telepítéséhez tehát ezt használja:

pkg install py39-onionshare

Az OnionShare csak parancssoros változata is elérhető előre lefordított csomagként. Ha ezt a változatot szeretné telepíteni, a py39-onionshare helyett a py39-onionshare-cli csomagot adja meg.

A FreeBSD előre lefordított csomagjaival kapcsolatos további információkért és részletekért tekintse meg a kézikönyv pkg-ről szóló hivatalos fejezetét.

Kézi telepítés porttal

A FreeBSD-port telepítéséhez lépjen be a korábban letöltött portgyűjtemény könyvtárába, és futtassa a következőt:

make -s -C www/onionshare all install clean

A portgyűjtemény külön portot is kínál az OnionShare csak parancssoros változatához. Ha ezt a változatot szeretné telepíteni, a www/onionshare helyett a www/onionshare-cli portot adja meg.

A FreeBSD portgyűjteményével kapcsolatos további információkért és részletekért tekintse meg a kézikönyv portokról szóló hivatalos fejezetét.

PGP-aláírások ellenőrzése

A PGP-aláírás ellenőrzésével meggyőződhet arról, hogy a letöltött csomag hiteles, és nem módosították. Windows és macOS esetén ez a lépés nem kötelező, és többrétegű védelmet nyújt: az OnionShare bináris fájljai operációs rendszer-specifikus aláírásokat tartalmaznak, és ha szeretné, egyedül ezekre is hagyatkozhat.

Aláíró kulcs

A csomagokat az adott kiadásért felelős fő fejlesztő írja alá. Az OnionShare egyes fő fejlesztőinek GPG-kulcsadatai a következők:

Az aláírások ellenőrzéséhez telepítve kell lennie a GnuPG-nek. macOS rendszeren valószínűleg a GPGTools, Windowson pedig a Gpg4win a megfelelő választás.

Aláírások

Az aláírásokat (.asc fájlokként), valamint a Windows-, macOS-, Flatpak-, Snap- és forráscsomagokat a https://onionshare.org/dist/ oldalon találja, az OnionShare egyes verzióiról elnevezett mappákban. A GitHub kiadási oldalán is megtalálhatók.

Ellenőrzés

Miután importálta a fő fejlesztők nyilvános kulcsait a GnuPG-kulcstartójába, és letöltötte a bináris fájlt és a .asc aláírást, a bináris fájlt egy terminálban így ellenőrizheti:

Windows esetén:

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

macOS esetén:

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

Linux esetén:

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)

a forrásfájl esetén pedig:

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

A várt kimenet így néz ki:

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

Ha nem látja a Good signature from szöveget, probléma lehet a fájl sértetlenségével (akár rosszindulatú, akár más okból), és nem szabad telepítenie a csomagot.

A fent látható WARNING: nem a csomag hibáját jelzi, csak azt, hogy Ön nem határozott meg „megbízhatósági” szintet Micah (a fő fejlesztő) PGP-kulcsához.

Ha többet szeretne megtudni a PGP-aláírások ellenőrzéséről, hasznosak lehetnek a Qubes OS és a Tor Project útmutatói.