Uso avanzado

Guardar pestañas

En forma predeterminada, todo en OnionShare es temporario. Si cierras una pestaña OnionShare, su dirección ya no existe, y no puede ser usada de nuevo. A veces, podrías querer que un servicio OnionShare sea persistente. Esto es útil si quieres alojar un sitio web que esté disponible desde la misma dirección OnionShare, aún si reinicias tu computadora.

Para hacer una pestaña persistente, marca la casilla «Guardar esta pestaña, y abrirla automáticamente cuando abra OnionShare» antes de iniciar el servidor. Cuando se guarda una pestaña, un ícono púrpura de un pin aparece a la izquierda de su estado de servidor.

Cuando sales de OnionShare y lo vuelves a abrir, tus pestañas guardadas se iniciarán abiertas. Tendrás que arrancar cada servicio manualmente, pero cuando lo hagas, se iniciarán con la misma dirección OnionShare, y con la misma contraseña.

Si guardas una pestaña, una copia de la clave secreta del servicio onion de la misma se almacenará en tu computadora con tus ajustes de OnionShare.

Deshabilitar contraseñas

Por defecto, todos los servicios OnionShare están protegidos con el nombre de usuario onionshare y una contraseña generada al azar. Si alguien intenta adivinarla 20 veces erróneamente, tu servicio onion es detenido en forma automática para prevenir un ataque por fuerza bruta en contra del mismo.

A veces, podrías querer que tu servicio OnionShare sea accesible al público, por ejemplo si quisieras un servicio OnionShare de recepción para que el público pueda enviarte archivos segura y anónimamente. En esta caso, es mejor deshabilitar del todo la contraseña. Si no lo haces, alguien puede forzar a tu servidor para que se detenga efectuando solo 20 suposiciones erróneas de tu contraseña, aún si conocen la correcta.

Para deshabilitar la contraseña para cualquier pestaña, solo marca la casilla «No usar una contraseña» antes de iniciar el servidor. Entonces será público y no tendrá contraseña.

Tiempos programados

OnionShare soporta la programación exacta de cuándo un servicio debería arrancar y detenerse. Antes de iniciar un servidor, haz clic en «Mostrar ajustes avanzados» en su pestaña, y luego marca las casillas próximas a «Iniciar el servicio onion en el tiempo programado», «Detener el servicio onion en el tiempo programado», o ambas, y establece las fechas y horas deseadas.

Si programaste un servicio para arrancar en el futuro, cuando hagas clic en el botón «Empezar a compartir», verás un temporizador contando regresivamente hasta el arranque. Si lo hiciste para detenerse en el futuro, luego que sea arrancado verás un temporizador contando regresivamente hasta el momento en que se detendrá automáticamente.

Programar un servicio OnionShare para iniciarse automáticamente puede ser usado como pulsador de hombre muerto, en donde tu servicio se hará público en un momento dado en el futuro si te pasa algo. Si no te pasa nada, puedes cancelarlo antes de su inicio programado.

Programar un servicio OnionShare para detenerse automáticamente puede ser útil para limitar la exposición, como cuando quieras compartir documentos secretos mientras te aseguras que no estarán disponibles en Internet por más de unos pocos días.

Interfaz de línea de comando

Además de su interfaz gráfico, OnionShare tiene una de línea de comando.

Puedes instalar la versión de línea de comando de OnionShare usando pip3:

pip3 install --user onionshare-cli

Ten en cuenta que también necesitarás el paquete tor instalado. En macOS, instálalo con: brew install tor

Luego, ejecútalo así:

onionshare-cli --help

Si instalaste OnionShare usando el paquete Snapcraft de Linux, también puedes ejecutar onionshare.cli para acceder a la versión de interfaz de línea de comando.

Uso

Puedes navegar la documentación de línea de comando ejecutando onionshare --help:

$ onionshare-cli --help
OnionShare 2.3 | https://onionshare.org/

                    @@@@@@@@@
                @@@@@@@@@@@@@@@@@@@
            @@@@@@@@@@@@@@@@@@@@@@@@@
          @@@@@@@@@@@@@@@@@@@@@@@@@@@@@
            @@@@@@@@@@@@@@@@@@@@@@@@@@@@@           ___        _
              @@@@@@         @@@@@@@@@@@@@         / _ \      (_)
        @@@@    @               @@@@@@@@@@@       | | | |_ __  _  ___  _ __
      @@@@@@@@                   @@@@@@@@@@       | | | | '_ \| |/ _ \| '_ \
    @@@@@@@@@@@@                  @@@@@@@@@@      \ \_/ / | | | | (_) | | | |
  @@@@@@@@@@@@@@@@                 @@@@@@@@@       \___/|_| |_|_|\___/|_| |_|
      @@@@@@@@@                 @@@@@@@@@@@@@@@@    _____ _
      @@@@@@@@@@                  @@@@@@@@@@@@     /  ___| |
      @@@@@@@@@@                   @@@@@@@@       \ `--.| |__   __ _ _ __ ___
      @@@@@@@@@@@               @    @@@@          `--. \ '_ \ / _` | '__/ _ \
        @@@@@@@@@@@@@         @@@@@@               /\__/ / | | | (_| | | |  __/
        @@@@@@@@@@@@@@@@@@@@@@@@@@@@@             \____/|_| |_|\__,_|_|  \___|
          @@@@@@@@@@@@@@@@@@@@@@@@@@@@@
            @@@@@@@@@@@@@@@@@@@@@@@@@
                @@@@@@@@@@@@@@@@@@@
                    @@@@@@@@@

usage: onionshare-cli [-h] [--receive] [--website] [--chat] [--local-only] [--connect-timeout SECONDS] [--config FILENAME] [--persistent FILENAME]
                      [--public] [--auto-start-timer SECONDS] [--auto-stop-timer SECONDS] [--legacy] [--client-auth] [--autostop-sharing]
                      [--data-dir data_dir] [--disable_csp] [-v]
                      [filename [filename ...]]

positional arguments:
  filename                  List of files or folders to share

optional arguments:
  -h, --help                show this help message and exit
  --receive                 Receive files
  --website                 Publish website
  --chat                    Start chat server
  --local-only              Don't use Tor (only for development)
  --connect-timeout SECONDS
                            Give up connecting to Tor after a given amount of seconds (default: 120)
  --config FILENAME         Filename of custom global settings
  --persistent FILENAME     Filename of persistent session
  --public                  Don't use a password
  --auto-start-timer SECONDS
                            Start onion service at scheduled time (N seconds from now)
  --auto-stop-timer SECONDS
                            Stop onion service at schedule time (N seconds from now)
  --legacy                  Use legacy address (v2 onion service, not recommended)
  --client-auth             Use client authorization (requires --legacy)
  --autostop-sharing        Share files: Stop sharing after files have been sent
  --data-dir data_dir       Receive files: Save files received to this directory
  --disable_csp             Publish website: Disable Content Security Policy header (allows your website to use third-party resources)
  -v, --verbose             Log OnionShare errors to stdout, and web errors to disk

Direcciones antiguas

OnionShare usa servicios onion Tor v3 por defecto. Estas son direcciones onion modernas que tienen 56 caracteres, por ejemplo:

uf3wmtpbstcupvrrsetrtct7qcmnqvdcsxqzxthxbx2y7tidatxye7id.onion

OnionShare aún tiene soporte para direcciones onion v2, el viejo tipo de direcciones onion que tienen 16 caracteres, por ejemplo:

lc7j6u55vhrh45eq.onion

OnionShare llama a las direcciones onion v2 «direcciones antiguas», las cuales no están recomendadas, ya que las direcciones onion v3 son más seguras.

Para usar direcciones antiguas, antes de iniciar un servidor haz clic en «Mostrar ajustes avanzados» en su pestaña, y marca la casilla «Usar una dirección antigua (servicio onion v2, no recomendado)». En el modo antiguo, puedes habilitar opcionalmente la autenticación de cliente Tor. Una vez que inicias un servidor en modo antiguo no puedes cambiarlo en esa pestaña. En vez, debes arrancar un servicio separado en otra pestaña.

El Tor Project planea descontinuar completamente los servicios onion v2 el 15 de octubre de 2021, y los servicios onion antiguos serán removidos de OnionShare antes de esa fecha.