Installation

Windows ou macOS

Vous pouvez télécharger OnionShare pour Windows et macOS depuis le site web OnionShare.

Mobile

Vous pouvez télécharger OnionShare pour mobile depuis les liens suivants

Linux

Il existe plusieurs façons d’installer OnionShare pour Linux, mais la méthode recommandée est d’utiliser soit le paquet Flatpak soit le paquet Snap. Flatpak et Snapcraft garantissent que vous utiliserez toujours la version la plus récente et que vous exécuterez OnionShare à l’intérieur d’un bac à sable.

La prise en charge de Snapcraft est intégrée à Ubuntu et Fedora est fournie avec la prise en charge de Flatpak, mais c’est à vous de choisir. Les deux fonctionnent dans toutes les distributions Linux.

Installer OnionShare en utilisant Flatpak : https://flathub.org/apps/details/org.onionshare.OnionShare

Installer OnionShare en utilisant Snap : https://snapcraft.io/onionshare

Vous pouvez aussi télécharger et installer des paquets .flatpak ou .snap signé avec PGP depuis https://onionshare.org/dist/ si vous préférer.

Installation manuelle de Flatpak

Si vous souhaitez installer OnionShare manuellement avec Flatpak en utilisant le single-file bundle signé par PGP, vous pouvez le faire comme suit :

  • Installez Flatpak en suivant les instructions à l’adresse https://flatpak.org/setup/.

  • Ajoutez le dépôt Flathub en lançant flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Même si vous ne téléchargez pas OnionShare depuis Flathub, OnionShare dépend de certains paquets qui ne sont disponibles que sur Flathub.

  • Allez sur https://onionshare.org/dist/, choisissez la dernière version d’OnionShare, et téléchargez les fichiers .flatpak et .flatpak.asc.

  • Vérifie la signature PGP du fichier .flatpak. Voir Vérifier les signatures PGP pour plus d’informations.

  • Installez le fichier .flatpak en exécutant flatpak install OnionShare-VERSION.flatpak. Remplacez VERSION par le numéro de version du fichier que vous avez téléchargé.

Vous pouvez lancer OnionShare avec : flatpak run org.onionshare.OnionShare.

Manuel d’installation de Snapcraft

Si vous souhaitez installer OnionShare manuellement avec Snapcraft en utilisant le paquet Snapcraft signé PGP, vous pouvez le faire comme suit :

  • Installez Snapcraft en suivant les instructions à l’adresse https://snapcraft.io/docs/installing-snapd.

  • Allez sur https://onionshare.org/dist/, choisissez la dernière version d’OnionShare, et téléchargez les fichiers .snap et .snap.asc.

  • Vérifie la signature PGP du fichier .snap. Voir Vérifier les signatures PGP pour plus d’informations.

  • Installez le fichier .snap en exécutant snap install --dangerous onionshare_VERSION_amd64.snap. Remplacez VERSION par le numéro de version du fichier que vous avez téléchargé. Notez que vous devez utiliser –dangerous parce que le paquet n’est pas signé par le magasin Snapcraft, cependant vous avez vérifié sa signature PGP, donc vous savez qu’il est légitime.

Vous pouvez lancer OnionShare avec : snap run onionshare.

Uniquement en ligne de commande

Vous pouvez installer uniquement la version en ligne de commande d’OnionShare sur n’importe quel OS en utilisant le gestionnaire de paquets pip. Voir Interface en ligne de commande pour plus de précisions.

FreeBSD

Bien qu’il ne soit pas officiellement développé pour cette plateforme, OnionShare peut aussi être installé sur FreeBSD. Il est accessible par sa collection de ports ou sous forme de paquet précompilé. Si vous choisissez d’installer et d’utiliser OnionShare sur un système d’exploitation FreeBSD, sachez qu’il n’est PAS officiellement pris en charge par le projet OnionShare.

Bien qu’ils ne soient ni proposés ni officiellement maintenus par les développeurs d’OnionShare, les paquets et ports FreeBSD récupèrent et vérifient bien le code source depuis le dépôt officiel d’OnionShare (ou ses paquets de version officiels sur PyPI). Si vous souhaitez consulter les changements propres à cette plateforme, reportez-vous aux ressources suivantes :

Installation manuelle avec pkg

Pour installer le paquet binaire, utilisez pkg install pyXY-onionshare, où pyXY indique la version de Python pour laquelle le paquet a été construit. Ainsi, pour installer OnionShare pour Python 3.9, utilisez

pkg install py39-onionshare

Une version en ligne de commande uniquement d’OnionShare est aussi disponible sous forme de paquet précompilé. Remplacez py39-onionshare par py39-onionshare-cli si vous voulez installer cette version.

Pour plus d’informations et de détails sur les paquets précompilés FreeBSD, reportez-vous à la section du manuel officiel consacrée à pkg.

Installation manuelle du port

Pour installer le port FreeBSD, placez-vous dans le répertoire de la collection des ports que vous devez avoir récupérée au préalable, puis exécutez

make -s -C www/onionshare all install clean

La collection des ports propose aussi un port dédié à la version en ligne de commande uniquement d’OnionShare. Remplacez www/onionshare par www/onionshare-cli si vous voulez installer cette version.

Pour plus d’informations et de détails sur la collection des ports FreeBSD, reportez-vous à la section du manuel officiel consacrée aux ports.

Vérifier les signatures PGP

Vous pouvez vérifier que les paquets que vous téléchargés n’ont pas été falsifiés en vérifiant la signature PGP. Pour Windows et macOS, cette étape est optionnelle et procure une défense en profondeur : les exécutables OnionShare incluent des signatures spécifiques aux systèmes, et vous pouvez vous reposer uniquement sur celles-là si vous le souhaitez.

Clé de signature

Les paquets sont signés par le développeur principal responsable de la version concernée. Voici les informations de clé GPG de chacun des développeurs principaux d’OnionShare :

Vous devez avoir installé GnuPG pour vérifier les signatures. Pour macOS, vous voudrez probablement utilisé GPGTools, et pour Windows Gpg4win.

Signatures

Vous trouverez les signatures (fichiers .asc), ainsi que les paquets Windows, macOS, Flatpak, Snap et sources, sur https://onionshare.org/dist/ dans les dossiers nommés d’après chaque version d’OnionShare. Vous les trouverez aussi sur la page des versions GitHub.

Vérifier

Une fois les clés publiques des développeurs principaux importées dans votre trousseau GnuPG, et le binaire ainsi que la signature .asc téléchargés, vous pouvez vérifier le binaire dans un terminal comme ceci :

Pour Windows

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

Pour macOS

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

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

et pour le fichier source

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

La sortie attendue ressemble à

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

Si vous ne voyez pas Good signature from, il y a peut-être un problème d’intégrité du fichier (malveillant ou autre) et vous ne devez pas installer le paquet.

Le WARNING: affiché ci-dessus n’est pas un problème avec le paquet, il signifie seulement que vous n’avez pas défini de niveau de « confiance » pour la clé PGP de Micah (le développeur principal).

Si vous voulez en apprendre plus sur la vérification des signatures PGP, le guide de Qubes OS et du Projet Tor peuvent être utiles.