Getting started

Primeros pasos en Linux

5 min de lecturaView as markdown ↗

Esta guía te lleva de no tener nada instalado a estar conectado. Cubre la instalación en dos partes, el inicio de sesión, la conexión y dónde conseguir ayuda. Para cada pantalla y ajuste, lee el recorrido de Linux.

URnetwork usa dispositivos de salida gestionados por miembros. Los proveedores no reciben tu IP de origen en las rutas retransmitidas. Las apps nativas además cifran el tráfico hasta el proveedor por defecto. Lee Cómo funciona URnetwork para el modelo completo.

Qué necesitas

URnetwork para Linux es una app de escritorio GTK4 nativa emparejada con un demonio de sistema que posee el túnel. Apunta a Ubuntu 22.04 o más reciente y versiones equivalentes de la familia Debian, en amd64 y arm64, y necesita systemd y /dev/net/tun. Eso es una instalación normal de escritorio o servidor.

Instalar

La app se instala como dos piezas, porque un túnel necesita privilegios y una GUI no debe tenerlos jamás:

  • urnetworkd — un pequeño demonio root bajo systemd. Posee /dev/net/tun, las rutas y el DNS. No tiene ninguna dependencia de GUI, así que se instala sin problema en una máquina sin pantalla.
  • La app URnetwork — una app de escritorio GTK4/libadwaita distribuida como AppImage, ejecutándose como tu usuario normal. Nunca necesita root.

Ambas vienen de github.com/urnetwork/build/releases.

1. Instala el demonio

Usa el .deb en Debian, Ubuntu y derivadas:

sudo apt install ./urnetwork-daemon_<version>_<arch>.deb

o el tarball de instalación en distribuciones sin dpkg:

tar xf urnetwork-daemon-<version>-<arch>.install.tar.gz
sudo urnetwork-daemon/install.sh

El instalador ejecuta comprobaciones previas (systemd, glibc, /dev/net/tun) e imprime lo que va a hacer; install.sh --dry-run muestra el plan sin tocar nada. Crea un grupo de sistema llamado urnetwork, instala el demonio, su unidad de systemd, la entrada de escritorio, los iconos y un lanzador /usr/bin/urnetwork, y luego habilita y arranca el servicio. Arrancarlo al instalar es seguro: el demonio arranca inactivo. Nunca levanta un túnel hasta que un cliente de escritorio autenticado se lo pide.

2. Pon la app donde pueda actualizarse sola

El AppImage de la GUI deliberadamente no lo instala el paquete. Vive en tu directorio personal para poder reemplazarse a sí mismo sin root:

mkdir -p ~/.local/lib/urnetwork
cp URnetwork-<version>-<arch>.AppImage ~/.local/lib/urnetwork/URnetwork.AppImage
chmod +x ~/.local/lib/urnetwork/URnetwork.AppImage

/usr/bin/urnetwork lo encuentra ahí y lo ejecuta, así que la entrada de escritorio, el menú de aplicaciones y los enlaces urnetwork:// siguen funcionando a través de las actualizaciones de la app. Los AppImage necesitan libfuse2; el .deb declara esa dependencia por ti.

3. Añádete al grupo urnetwork

Solo root y los miembros del grupo urnetwork pueden dar órdenes al demonio, así que tu propio usuario tiene que unirse:

sudo usermod -aG urnetwork "$USER"

Cierra sesión y vuelve a entrar; la pertenencia al grupo se toma al iniciar sesión. Sáltate esto y la app te dirá que no puede alcanzar el servicio.

Las evaluaciones de seguridad de terceros, y sus límites, están recogidas en el modelo de amenazas.

Iniciar sesión

Lanza URnetwork desde tu menú de aplicaciones, o ejecuta urnetwork. La app abre con las opciones de inicio de sesión. Elige el modelo de identidad con el que estés cómodo:

  • Correo o teléfono. Introdúcelo y continúa. La app encuentra tu cuenta u ofrece crear una, verificando con un código de un solo uso.
  • Crear cuenta (Create account). Nombre de red, correo o teléfono, contraseña y un código de invitación opcional.
  • Iniciar sesión con código (Sign in with code). ¿Ya iniciaste sesión en otro dispositivo? Genera allí un código de autorización de un solo uso, en cualquier app de URnetwork o en ur.io, y pégalo.
  • Probar modo invitado (Try Guest Mode). Un clic crea una red real y permanente sin entregar nada. El botón es anterior al flujo de alta actual: la frase de recuperación de esa cuenta se descarta en lugar de mostrártela, así que no hay forma de volver a entrar desde otra máquina. Trátala como desechable para evaluar. Añade un correo, un teléfono o una cartera antes de depender de ella.
  • Iniciar sesión con Bittensor (Sign in with Bittensor). Tu navegador abre un puente de cartera, tu cartera firma un mensaje y la app sigue desde ahí.
  • Iniciar sesión con Solana (Sign in with Solana). El mismo flujo, vía Phantom o Solflare.

No hay inicio de sesión con Google ni Apple en Linux. Si quieres una cuenta sin correo que puedas conservar, las apps de teléfono y Mac ofrecen un Crear Cuenta instantánea (Create Instant Account) de un toque que te muestra su frase de recuperación. Créala allí y tráela a esta máquina con un código de autorización.

Toda red empieza en el plan gratuito, una cuota de datos diaria que se renueva cada día. Pro (5 $/mes o 40 $/año) lo sustituye por una cuota mensual grande, comprada en la app desde Obtener UR Pro (Get UR Pro). Números vigentes: ur.io/products.

El permiso del túnel

No aparece ningún diálogo de consentimiento al conectar, porque concediste el privilegio al instalar. El demonio se ejecuta como root y posee el dispositivo del túnel; la app se ejecuta como tú y le pide las cosas al demonio por su socket de control. Ese socket está protegido por credenciales de par verificadas por el kernel: root, o un miembro del grupo urnetwork. Nada más en el sistema puede arrancar un túnel.

Para saber qué registra URnetwork sobre tus conexiones, lee el modelo de amenazas.

Conectar

  1. Haz clic en Conectar (Connect) en la app.
  2. El túnel se levanta. No hay solicitud de permiso, porque es el demonio, no la app, quien abre el dispositivo del túnel.
  3. El globo y la línea de estado cobran vida, y aparece un icono de bandeja si tu escritorio los admite.

Elegir una ubicación

El valor por defecto es mejor disponible (best available). La red elige continuamente por ti proveedores rápidos y fiables. Es la elección correcta para la mayoría de las sesiones.

Para elegir por dónde sale tu tráfico:

  1. Haz clic en la fila de ubicación para abrir el selector.
  2. Desplázate para ver países, o teclea para buscar. Las regiones, ciudades y dispositivos aparecen en los resultados de búsqueda, así que teclea el nombre de una ciudad para encontrarla.
  3. Elige una ubicación. La app se reconecta a través de proveedores de allí.

Cada entrada lleva un recuento en vivo de los proveedores en línea allí ahora mismo. Los proveedores son dispositivos de miembros, no centros de datos, así que los recuentos suben y bajan con la hora del día. La visión general explica la ruta que recorre tu tráfico. El recorrido explica los ajustes de conexión y sus intercambios.

Comprueba que funciona

Visita cualquier sitio de "cuál es mi IP". Deberías ver la dirección y la ciudad de un proveedor en lugar de las tuyas. A partir de ahí, el globo y la línea de estado de la app, y el icono de bandeja donde tu escritorio muestre uno, te dicen que el túnel está activo.

Si algo falla

Si la app informa de que el servicio está inaccesible, desactualizado o es una compilación distinta de la de la app, es un estado real con un arreglo real: ver Resolución de problemas en el recorrido. Las dos mitades van emparejadas por versión a propósito, así que una instalación actualizada a medias te lo dice en lugar de fallar de forma extraña. Para problemas del túnel, journalctl -u urnetworkd -f es lo primero que mirar. feedback.ur.io llega al equipo, y las preguntas frecuentes responden las dudas comunes.

Qué sigue

  • Haz el recorrido. Cada pantalla y ajuste: la división con el demonio, el comportamiento de rutas y DNS y sus límites, las hojas (DNS personalizado, reglas de división, contratos en vivo), el ajuste manual de la ubicación del dispositivo, el kill switch (interruptor de corte, desactivado por defecto) y la resolución de problemas.
  • Comparte tu conexión. Compartir conexión está en los controles de la pantalla principal de la app: Auto, Siempre (Always), Red (Network, solo los dispositivos de tu propia cuenta, nunca el público) o Nunca (Never), y empieza en Nunca. Un escritorio o servidor Linux con una buena subida es exactamente el tipo de nodo que la red quiere; la visión general cubre el filtrado de abusos que se ejecuta en tu máquina antes de que el tráfico salga de ella. Para una máquina sin pantalla, la CLI de proveedor independiente en github.com/urnetwork/build/releases hace el mismo trabajo: urnetwork auth con un código de cualquier app, y luego urnetwork provide. Los proveedores participan en el protocolo UR; ur.xyz documenta cómo funcionan las recompensas.
  • Prueba otra plataforma: Android, iOS, macOS, Windows y el navegador.