Neko – Ein Virtueller Browser im Docker Container

Neko ist ein Virtueller Browser. Er ermöglicht dir eine Browser Session aus einem Docker Container heraus zu streamen. Damit kann man collaborativ eine Sitzung teilen um z.B. eine Präsentation online zu halten, ein online System live zu schulen oder gemeinsam online zu recherchieren.

0. Grundvoraussetzung

• Docker & Docker Compose v2 (Debian / Ubuntu)
• Traefik V3 Installation, Konfiguration und CrowdSec-Security

1. Ordner anlegen

Als erstes legst du dir einen Ordner an.

mkdir -p /opt/containers/neko

2. Docker Compose Datei anlegen

Danach erstellen wir eine docker-compose.yml Datei.

services:
  neko:
    image: "ghcr.io/m1k1o/neko/firefox:latest"
    restart: "unless-stopped"
    shm_size: "2gb"
    ports:
      - "52000-52100:52000-52100/udp"
    volumes:
      - ./firefox:/home/neko/.mozilla/firefox # speicherort der Firefox-Einstellungen
    networks:
      - proxy
    environment:
      NEKO_DESKTOP_SCREEN: '1920x1080@30' # Auflösung der Webseite 
      NEKO_MEMBER_MULTIUSER_USER_PASSWORD: neko
      NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: admin
      NEKO_WEBRTC_EPR: 52000-52100
      NEKO_WEBRTC_ICELITE: 1
      NEKO_WEBRTC_NAT1TO1: 8.8.8.8 2001:4860:4860::8888 2001:4860:4860::8844 # IP Adresse des Hosts

    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.neko-firefox.entrypoints=websecure"
      - "traefik.http.routers.neko-firefox.rule=Host(`neko.euredomain.de`)"
      - "traefik.http.routers.neko-firefox.tls=true"
      - "traefik.http.routers.neko-firefox.tls.certresolver=http_resolver"
      - "traefik.http.routers.neko-firefox.service=neko-firefox"
      - "traefik.http.services.neko-firefox.loadbalancer.server.port=8080"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.neko-firefox.middlewares=default@file"

networks:
  proxy:
    external: true

Ändere foldendes ab:

NEKO_WEBRTC_NAT1TO1: Hier trägst du die eigene Host IP Adresse ein. Mit einem Leerzeichen getrennt kannst du danach auch deine öffentliche IPv6 Adresse eingetragen.
Beispiel: 8.8.8.8 2001:4860:4860::8888 2001:4860:4860::8844
Hostadresse: neko.euredomain.de

2.1 Erläuterungen

NEKO_DESKTOP_SCREEN: '1920x1080@30' Dies ist die Auflösung in welcher der virtuelle Browser die Webseite rendert. Man kann den Browser auch mit einem Smartphone aufrufen, die Auflösung der aufgerufenen Webseite bleibt bei diesem Wert.

Der Login im Neko System ist simpel. Beim einloggen wird der Benutzername vom Anwender frei gewählt. Das Passwort alleine entscheidet über den Login und die Berechtigungen.
NEKO_MEMBER_MULTIUSER_USER_PASSWORD: neko Mit dem Passwort neko erhält man Benutzer Rechte
NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: admin Mit dem Passwort admin erhält man Admin Berechtigungen.

3. Neko starten

Nun startest du den Container einmal und beendest ihn anschließend um die Berechtigungen für das firefox Verzeichnis zu setzen.

docker compose up

docker compose down

Nun wurde das Verzeichnis firerfox erstellt und die Berechtigungen können gesetzt werden.

chmod 777 firefox -R

Danach startest du den Container erneut.

docker compose up -d

4. Den virtuellen Browser aufrufen

Nach dem Aufruf von neko.euredomain.de kannst du dich einloggen.
Der Benutzername ist frei wählbar, das Passwort als Admin ist in diesem Fall adminadmin

[1] – Hier aktivierst du die Maus und Tastatur. Es kann bei mehreren Teilnehmern nur einer gleichzeitig die Steuerung übernehemen.
[2] – Hier stellst du die Ansicht auf Fullscreen. Mit Escape beendet man den Fullscreen.
[3] – Hier kannst du dich per Chat mit anderen Teilnehmern austauschen
[4] – Hier kannst du den Stream abdocken und neben dem Browser weiterschauen (Bekannt von z.B. Youtube)

5. Weitere Möglichkeiten

Das Neko Projekt beherrscht nicht nur das Streamen eines Browsers. Auch VLC, Remmina und sogar KDE lassen sich damit streamen. Weitere Informationen dazu findest du hier auf der Projektseite.
Dabei braucht in den meisten fällen nur der Container Tag geändert werden.
Ein Beispiel: "ghcr.io/m1k1o/neko/firefox:latest" ändern in "ghcr.io/m1k1o/neko/google-chrome:latest" startet dann den Chrome Browser.

6. Quellen

• Neko Github
• Nekos Webseite
• Neko erwähnt auf heise.de