Installazione

Windows o macOS

Puoi scaricare OnionShare per Windows e macOS dal sito web di OnionShare.

Mobile

You can download OnionShare for Mobile from the follow links

Linux

Ci sono diversi modi per installare OnionShare su Linux, ma la maniera consigliata è usare o il pacchetto Flatpak o Snap . Flatpak e Snapcraft garantiscono l’utilizzo della versione più aggiornata e l’avvio di OnionShare all’interno di una sandbox.

Il supporto Snapcraft è integrato in Ubuntu e il supporto Flatpak è integrato in Fedora, ma quale scegliere dipende da te. Entrambi funzionano in tutte le distro Linux.

Installa OnionShare usando Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Installa OnionShare usando Snapcraft: https://snapcraft.io/onionshare

Se preferisci puoi anche scaricare e installare pacchetti .flatpak o .snap con firma PGP da https://onionshare.org/dist/.

Installazione manuale con Flatpak

Se si desidera installare OnionShare manualmente con Flatpak utilizzando il bundle single-file firmato PGP, è possibile farlo in questo modo:

  • Installate Flatpak seguendo le istruzioni di https://flatpak.org/setup/.

  • Aggiungere il repository Flathub eseguendo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Anche se non si scarica OnionShare da Flathub, OnionShare dipende da alcuni pacchetti che sono disponibili solo lì.

  • Andate su https://onionshare.org/dist/, scegliete l’ultima versione di OnionShare e scaricate i file .flatpak e .flatpak.asc.

  • Verifica la firma PGP del file .flatpak. Vedere Verifica delle firme PGP per maggiori informazioni.

  • Installare il file .flatpak eseguendo flatpak install OnionShare-VERSION.flatpak. Sostituire VERSION con il numero di versione del file scaricato.

È possibile eseguire OnionShare con: flatpak run org.onionshare.OnionShare.

Installazione manuale di Snapcraft

Se si desidera installare OnionShare manualmente con Snapcraft utilizzando il pacchetto Snapcraft con firma PGP, è possibile farlo in questo modo:

  • Installare Snapcraft seguendo le istruzioni riportate in https://snapcraft.io/docs/installing-snapd.

  • Andate su https://onionshare.org/dist/, scegliete l’ultima versione di OnionShare e scaricate i file .snap e .snap.asc.

  • Verifica la firma PGP del file .snap. Vedere Verifica delle firme PGP per maggiori informazioni.

  • Installare il file .snap eseguendo snap install --dangerous onionshare_VERSION_amd64.snap. Sostituire VERSION con il numero di versione del file scaricato. Si noti che è necessario usare –pericoloso perché il pacchetto non è firmato dal negozio Snapcraft, tuttavia è stata verificata la firma PGP, quindi si sa che è legittimo.

È possibile eseguire OnionShare con: snap run onionshare.

Solo linea di comando

Puoi anche installare soltanto la versione da linea di comando di OnionShare su qualsiasi sistema operativo utilizzando il gestore dei pacchetti di Python pip. :ref:`cli`ha più informazioni.

FreeBSD

Sebbene non sia stato sviluppato ufficialmente per questa piattaforma, OnionShare può essere installato anche su FreeBSD. È disponibile tramite la raccolta di porte o come pacchetto precostruito. Se si sceglie di installare e utilizzare OnionShare su un sistema operativo FreeBSD, si tenga presente che non è NON ufficialmente supportato dal progetto OnionShare.

Sebbene non siano offerti e mantenuti ufficialmente dagli sviluppatori di OnionShare, i pacchetti e i port di FreeBSD recuperano e verificano i codici sorgente dal repository ufficiale di OnionShare (o i suoi pacchetti di rilascio ufficiali da PyPI). Se si desidera verificare le modifiche relative a questa piattaforma, si faccia riferimento alle seguenti risorse:

Installazione manuale del pkg

Per installare il pacchetto binario, usare pkg install pyXY-onionshare, con pyXY che specifica la versione di Python per cui il pacchetto è stato creato. Quindi, per installare OnionShare per Python 3.9, usare:

pkg install py39-onionshare

Esiste anche una versione a riga di comando di OnionShare disponibile come pacchetto precostituito. Sostituire py39-onionshare con py39-onionshare-cli se si vuole installare questa versione.

Per ulteriori informazioni e dettagli sui pacchetti precostituiti di FreeBSD, consultare la sezione ufficiale del manuale su pkg.

Installazione manuale della porta

Per installare la porta FreeBSD, cambiate directory nella raccolta di porte che avrete già controllato ed eseguite il seguente comando:

make -s -C www/onionshare all install clean

La collezione di porte offre anche una porta dedicata alla versione a linea di comando di OnionShare. Sostituire ``www/onionshare”‘ con ``www/onionshare-cli’” se si vuole installare questa versione.

Per ulteriori informazioni e dettagli sulla collezione di porte FreeBSD, consultare la sezione ufficiale del manuale sulle porte.

Verifica delle firme PGP

Puoi verificare che il pacchetto scaricato sia legittimo e non sia stato manomesso verificando la sua firma PGP. Per Windows e macOS, questo passaggio è facoltativo e fornisce una difesa maggiore: i file binari di OnionShare includono firme specifiche del sistema operativo e se lo vuoi puoi semplicemente fare affidamento solo su quelle.

Signing key

I pacchetti sono firmati dallo sviluppatore principale che è responsabile di quella particolare release. Ecco le informazioni sulla chiave GPG per ciascuno degli sviluppatori principali di OnionShare:

Per verificare le firme, è necessario che tu abbia installato GnuPG. Per macOS è probabilmente necessario GPGTools, e per Windows è probabilmente necessario Gpg4win.

Firme

È possibile trovare le firme (come file .asc), così come i pacchetti Windows, macOS, Flatpak, Snap e i sorgenti, all’indirizzo https://onionshare.org/dist/ nelle cartelle denominate per ogni versione di OnionShare. È possibile trovarle anche sulla pagina GitHub Releases.

Verifica in corso

Una volta importate le chiavi pubbliche degli sviluppatori del nucleo nel proprio portachiavi GnuPG, scaricato il binario e la firma .asc, è possibile verificare il binario in un terminale come questo:

Per Windows:

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

Per macOS:

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

Per 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)

e per il file sorgente:

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

Il risultato atteso somiglia a questo:

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

Se non si vede Buona firma da, potrebbe esserci un problema con l’integrità del file (maligno o altro) e non si dovrebbe installare il pacchetto.

L’avviso WARNING: mostrato sopra non è un problema del pacchetto, significa solo che non è stato definito un livello di “fiducia” della chiave PGP di Micah (lo sviluppatore principale).

Se vuoi saperne di più sulla verifica delle firme PGP, le guide per Qubes OS e del Progetto Tor possono essere utili.