Cómo instalar Neko - Navegador virtual compartido en Docker

Neko | Virtual Browser | Docker

Neko: Navegador virtual compartido con WebRTC en Docker

Accede a una browser completa desde tu navegador web. Comparte pantalla con amigos en tiempo real, watch parties colaborativos y acceso remoto sin instalar nada.

¿Qué es Neko?

Neko es un navegador virtual autohospedado que se ejecuta en Docker y utiliza WebRTC para transmitir el escritorio en tiempo real. Permite que múltiples usuarios accedan simultáneamente a una instancia de navegador completamente funcional, ver el mismo contenido, compartir el control y colaborar en tiempo real, todo a través de un navegador web.

El proyecto surgió de una necesidad real: el creador quería ver anime con sus amigos después de que rabb.it cerrara, pero su conexión no podía manejar streaming tradicional y Discord se caía constantemente. Así que decidió construir una alternativa open source completamente funcional usando WebRTC. Hoy, Neko es una herramienta versátil que permite no solo navegadores, sino cualquier aplicación Linux: VLC, XFCE, KDE, o un desktop completo.

Ventaja clave: A diferencia de rabb.it o servicios comerciales, Neko es completamente gratuito, de código abierto y se ejecuta en tu propio servidor. WebRTC proporciona baja latencia (menos de 300ms), soporte de audio sincronizado y control multipersona sin necesidad de instalar software en el cliente.

Características principales

Streaming con WebRTC

Transmisión de baja latencia (menos de 300ms) con audio sincronizado. Mejor que VNC o RDP.

Control multipersona

Múltiples usuarios pueden conectarse simultáneamente. El anfitrión controla permisos de acceso.

Sin instalación en cliente

Accede desde cualquier navegador moderno. No necesita VPN, TeamViewer, Chrome Remote Desktop.

Chat integrado

Chat en tiempo real entre participantes con reacciones emoji.

Watch parties

Alternativa open source a rabb.it para ver contenido juntos con amigos.

RTMP streaming

Transmite a Twitch, YouTube, o guarda en archivo usando RTMP.

Múltiples navegadores

Firefox, Chromium, Google Chrome, Ungoogled Chromium, Waterfox, VLC y más.

Desktop completo

Instala XFCE, KDE o cualquier desktop Linux para acceso completo.

Aceleración GPU

Soporte para VAAPI (Intel) y EGL (Nvidia) para mejor rendimiento.

Aislamiento y seguridad

Cada sesión es ephemeral y aislada. Sin historial, cookies o cache persistente.

API y webhooks

Control programático y automatización de salas y eventos.

Neko Rooms

Sistema de gestión de salas para manejar múltiples instancias Neko.

Instalación rápida

Opción 1: Docker Run (5 segundos)

docker run -d -p 8080:8080 m1k1o/neko:firefox

Abre http://localhost:8080 y tienes un Firefox completamente funcional corriendo en un contenedor.

Opción 2: Docker Run con configuración completa

docker run -d --rm \ -p 8080:8080 \ -p 56000-56100:56000-56100/udp \ -e NEKO_WEBRTC_EPR=56000-56100 \ -e NEKO_WEBRTC_NAT1TO1=127.0.0.1 \ -e NEKO_PASSWORD=tu-contraseña \ -e NEKO_AUDIO=true \ -e NEKO_SCREEN="1920x1080" \ -e NEKO_SCREEN_FPS=30 \ m1k1o/neko:firefox

Docker Compose (recomendado)

services: neko: image: ghcr.io/m1k1o/neko/firefox:latest container_name: neko-firefox restart: unless-stopped ports: - "8080:8080" - "56000-56100:56000-56100/udp" environment: # General - NEKO_PASSWORD=tu-contraseña-secreta - NEKO_ADMIN=admin:contraseña-admin - NEKO_ROOM=Neko # WebRTC - NEKO_WEBRTC_EPR=56000-56100 - NEKO_WEBRTC_NAT1TO1=tu-ip-publica # Pantalla - NEKO_SCREEN=1920x1080 - NEKO_SCREEN_FPS=30 # Audio - NEKO_AUDIO=true - NEKO_AUDIO_CODEC=opus # Características - NEKO_CLIPBOARD_ENABLED=true - NEKO_IMPRINT_ENABLED=false # Zona horaria - TZ=Europe/Madrid

Variantes de navegadores disponibles

Neko ofrece múltiples variantes con diferentes navegadores y configuraciones:

Navegadores Firefox-based (recomendado para principiantes)

# Firefox vanilla ghcr.io/m1k1o/neko/firefox:latest # Ungoogled Chromium (sin Google) ghcr.io/m1k1o/neko/ungoogled-chromium:latest # Waterfox (Firefox enfocado en privacidad) ghcr.io/m1k1o/neko/waterfox:latest

Navegadores Chromium-based

# Google Chrome ghcr.io/m1k1o/neko/chromium:latest docker run -d -p 8080:8080 --shm-size=2gb m1k1o/neko:chromium # Brave ghcr.io/m1k1o/neko/brave:latest docker run -d -p 8080:8080 --shm-size=2gb m1k1o/neko:brave

Desktop completo

# XFCE Desktop ghcr.io/m1k1o/neko/xfce:latest # KDE Plasma ghcr.io/m1k1o/neko/kde:latest

Importante para Chromium: Los navegadores basados en Chromium necesitan --shm-size=2gb (o más) para no fallar. Firefox no necesita esto.

Aceleración GPU (opcional)

Intel VAAPI

docker run -d -p 8080:8080 \ --device /dev/dri:/dev/dri \ ghcr.io/m1k1o/neko/firefox-intel-base:latest

Nvidia EGL

docker run -d -p 8080:8080 \ --gpus all \ ghcr.io/m1k1o/neko/firefox-nvidia-base:latest

Configuración avanzada

Para acceso remoto (sobre Internet)

Si accedes desde fuera de tu red local, necesitas configurar STUN/TURN:

NEKO_WEBRTC_STUN=stun:stun.l.google.com:19302 NEKO_WEBRTC_TURN=turn:tuservidor.com:3478 NEKO_WEBRTC_TURN_USERNAME=usuario NEKO_WEBRTC_TURN_PASSWORD=contraseña

RTMP Broadcasting

Transmite a Twitch, YouTube o guarda en archivo:

NEKO_BROADCAST_ENABLED=true NEKO_BROADCAST_VIDEO_BITRATE=2500 NEKO_BROADCAST_AUDIO_BITRATE=128

Límites y restricciones

NEKO_LOCKED=false # Bloquea salas cuando hay X usuarios NEKO_LOCKS=control # control,login,logout NEKO_CURSOR_SHOW_LATENCY=true NEKO_CURSOR_POSITION_LATENCY=true

Casos de uso

• Watch parties: Ver películas, series o streams con amigos en tiempo real sin Discord
• Soporte técnico remoto: Acceso remoto sin instalar TeamViewer o software propietario
• Presentaciones interactivas: Demostrar aplicaciones web o software con participación en vivo
• Testing de aplicaciones: Probar apps web desde múltiples navegadores simultáneamente
• Compartir VPN/proxy: Navegar desde ubicación específica sin exponer credenciales
• Jump host seguro: Acceso a recursos internos sin software cliente
• Streaming 24/7: Broadcast continuo a Twitch incluso sin usuarios conectados
• Desktop virtual aislado: Navegar sitios inseguros en entorno sandbox
• VR Chat integration: Ver navegador compartido dentro de VR Chat
• Educación remota: Instructor y estudiantes colaborando en navegador compartido

Gestión y mantenimiento

Ver logs

docker compose logs -f neko

Reiniciar

docker compose restart neko

Detener

docker compose down

Cambiar navegador

Edita la imagen en docker-compose.yml y reinicia:

image: ghcr.io/m1k1o/neko/chromium:latest docker compose up -d

Acceder al shell

docker compose exec neko bash

Neko Rooms: Gestión de múltiples salas

Para ejecutar múltiples salas con gestión centralizada, usa Neko Rooms:

curl https://raw.githubusercontent.com/m1k1o/neko-rooms/master/install | sudo bash

Neko Rooms proporciona:

• Panel de administración para gestionar salas
• Autenticación y control de acceso
• Estadísticas de uso
• HTTPS automático con Traefik y Let's Encrypt
• Creación dinámica de salas

---

Referencias oficiales

• Repositorio oficial de Neko - GitHub
• Documentación oficial de Neko
• Imágenes Docker - Docker Hub
• GitHub Container Registry
• Neko Rooms - Gestión de salas

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter