Instalación

Windows o macOS

Puedes descargar OnionShare para Windows o macOS desde la página web de OnionShare.

Móvil

Puede descargar OnionShare para dispositivos móviles desde los siguientes enlaces

Linux

Hay varias maneras de instalar OnionShare para Linux, pero la recomendada es usar el paquete Flatpak o bien Snapcraft. Flatpak y Snap aseguran que siempre usará la versión más nueva, y ejecutará OnionShare dentro en un sandbox.

Snap está incorporado en Ubuntu, y Flatpak en Fedora, pero es tu elección cuál usar. Ambos funcionan en todas las distribuciones Linux.

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

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

También puedes descargar e instalar paquetes .flatpak o .snap firmados con PGP desde https://onionshare.org/dist/ si así lo prefieres.

Instalación manual con Flatpak

Si deseas instalar OnionShare manualmente con Flatpak usando el paquete de un solo archivo firmado por PGP, puedes hacerlo así como este:

  • Instala Flatpak siguiendo las instrucciones en https://flatpak.org/setup/.

  • Agrega el repositorio de Flathub ejecutando flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Aunque no descargará OnionShare desde Flathub, OnionShare depende de algunos paquetes que solo están disponibles allí.

  • Ve a https://onionshare.org/dist/, elige la última versión de OnionShare y descarga los archivos .flatpak y .flatpak.asc.

  • Verifica la firma PGP del archivo .flatpak. Consulta Verificar firmas PGP para obtener más información.

  • Instala el archivo .flatpak ejecutando flatpak install OnionShare-VERSION.flatpak. Reemplaza VERSION con el número de la versión del archivo que descargaste.

Puedes ejecutar OnionShare con: flatpak run org.onionshare.OnionShare.

Instalación manual de Snapcraft

Si quieres instalar OnionShare manualmente con Snapcraft usando el paquete Snapcraft firmado con PGP, puedes hacerlo así:

  • Instala Snapcraft siguiendo las instrucciones de https://snapcraft.io/docs/installing-snapd.

  • Vete a https://onionshare.org/dist/, elije la última versión de OnionShare y descarga los archivos .snap y .snap.asc.

  • Verifica la firma PGP del archivo .snap. Consulta Verificar firmas PGP para obtener más información.

  • Instala el archivo .snap ejecutando snap install --dangerousionsonshare_VERSION_amd64.snap. Reemplaza VERSION con el número de versión del archivo que descargaste. Ten en cuenta que debes usar –dangerous porque el paquete no está firmado por la tienda de Snapcraft, sin embargo, verificó tu firma PGP, por lo que sabe que es legítimo.

Puedes ejecutar OnionShare con: snap run onionshare.

Sólo línea de comandos

Puedes instalar sólo la versión de línea de comandos de OnionShare en cualquier sistema operativo utilizando el gestor de paquetes de Python pip. Interfaz de línea de comando tiene más información.

FreeBSD

Aunque no se ha desarrollado oficialmente para esta plataforma, OnionShare también puede instalarse en FreeBSD. Está disponible a través de su colección de puertos o como paquete preconstruido. Si opta por instalar y utilizar OnionShare en un sistema operativo FreeBSD, tenga en cuenta que NO está soportado oficialmente por el proyecto OnionShare.

Aunque no son ofrecidos ni mantenidos oficialmente por los desarrolladores de OnionShare, los paquetes y adaptaciones de FreeBSD obtienen y verifican los códigos fuente del repositorio oficial de OnionShare (o sus paquetes de lanzamiento oficiales de PyPI). Si desea consultar los cambios relacionados con esta plataforma, consulte los siguientes recursos:

Instalación manual del pkg

Para instalar el paquete binario, use pkg install pyXY-onionshare, con pyXY especificando la versión de Python para la que se compiló el paquete. Por lo tanto, para instalar OnionShare para Python 3.9, use:

pkg install py39-onionshare

También hay una versión sólo línea de comandos de OnionShare disponible como paquete pre-compilado. Reemplace py39-onionshare con py39-onionshare-cli si desea instalar esa versión.

Para obtener información adicional y detalles sobre los paquetes prediseñados de FreeBSD, consulte su ` Sección oficial del manual sobre el paquete <https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro>`_ .

Instalación manual del puerto

Para instalar el puerto de FreeBSD, cambie de directorio a la colección de puertos que habrá comprobado antes y ejecute lo siguiente:

make -s -C www/onionshare all install clean

La colección de puertos también ofrece un puerto dedicado para la versión Sólo línea de comandos de OnionShare. Sustituye www/onionshare por www/onionshare-cli si quieres instalar esa versión.

Para más información y detalles sobre la colección de puertos de FreeBSD, consulte su sección oficial del manual de puertos.

Verificar firmas PGP

Puedes verificar que el paquete que descargaste sea legítimo y no haya sido manipulado al verificar su firma PGP. Para Windows y macOS, este paso es opcional, y provee defensa en profundidad: los ejecutables OnionShare incluyen firmas específicas del sistema operativo, y puedes confiar solo en ellas si así lo prefieres.

Clave de firma

Packages are signed by the core developer who is responsible for the particular release. Here is the GPG key information for each of the core developers of OnionShare:

Para verificar firmas, debes tener GnuPG instalado. Para macOS probablemente quieras GPGTools, y para Windows, Gpg4win.

Firmas

Puede encontrar las firmas (como archivos .asc), así como Windows, macOS, Flatpak, Snap y paquetes fuente, en https://onionshare.org/dist/ en las carpetas nombradas para cada versión de OnionShare. También puedes encontrarlos en la página `Publicaciones en GitHub <https://github.com/onionshare/onionshare/releases>”_.

Verificando

Una vez que haya importado las claves públicas de los desarrolladores del núcleo en su llavero GnuPG, descargado el binario y la firma .asc, puede verificar el binario en un terminal como este:

Para Windows:

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

Para macOS:

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

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

y para el archivo fuente:

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

La salida esperada se parece a esta:

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 no ve Good signature from, puede haber un problema con la integridad del fichero (malicioso o no), y no debería instalar el paquete.

La ADVERTENCIA: mostrada, no es un problema con el paquete, sólo significa que no has definido un nivel de «confianza» de la clave PGP de Micah (el desarrollador del núcleo).

Si quieres aprender más acerca de la verificación de firmas PGP, las guías para Qubes OS y el Tor Project podrían ser útiles.