Der Server braucht einen Domainnamen (zum Beispiel remote.example.com) und einen DNS-A/AAAA-Eintrag, der darauf zeigt. Sie können mit einem kleinen Server mit 1 vCPU und 1 GB Arbeitsspeicher beginnen.
Mit Paketen installieren (Linux)
- Installieren Sie die Serverpakete. Einstellungen liegen in
/etc/tastedev-remote/, Daten in /var/lib/tastedev-remote/. - Füllen Sie
/etc/tastedev-remote/tasteremote-signal.env aus. Erforderlich sind:
- Installieren Sie coturn und setzen Sie
static-auth-secret in /etc/turnserver.conf auf denselben Wert wie TURN_SECRET.
sudo apt install coturn
- Richten Sie den Reverse-Proxy ein. Verwenden Sie Caddy, oder erstellen Sie eine nginx- oder Apache-Konfiguration mit dem Assistenten Servereinrichtung in den Verwaltungsseiten (siehe unten).
- Schalten Sie die Dienste ein.
sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer
- Laden Sie die Host-Installationsdateien herunter, die Benutzer erhalten sollen. Ohne sie liefert
/downloads/ 503, und die Downloadseite zeigt "Dieser Server hat noch keine Installationsdateien". Auf einem Server ohne Internetzugang legen Sie die Installationsdateien selbst in den Ordner downloads/.
sudo tasteremote-fetch-hosts
Auf einem Windows-Server liegen die Einstellungen in %ProgramData%\tasteremote\config\ und die Daten in %ProgramData%\tasteremote\data, und er läuft als Dienst.
Assistent Servereinrichtung (nginx · Apache)
Melden Sie sich mit dem ersten Administratorkonto an und öffnen Sie Verwaltung › Servereinrichtung. In fünf Schritten erstellt er die Konfigurationsdateien und Befehle, die der Administrator per SSH einfügt und ausführt. Die Seite selbst führt nichts auf dem Server aus.
- Webserver wählen: nginx oder httpd und das Betriebssystem (deb oder rpm)
- Adresse · Port: Die Domain (IP-Adressen werden nicht akzeptiert)
- Proxy-Konfiguration: Die Konfigurationsdatei und Firewall-Befehle
- HTTPS-Zertifikat: Holt ein Zertifikat mit certbot und erneuert es automatisch.
- Prüfen: Werte wie
RD_WEB_ORIGIN, RD_COOKIE_SECURE=1 und TRUST_PROXY=1 sowie Prüfbefehle. Er prüft, ob /healthz antwortet und ob eine /ws-Verbindung auf 101 wechselt (400 oder 426 bedeutet, dass der Proxy die WebSocket-Header verworfen hat).
Mit Docker Compose installieren
Sie brauchen Docker Engine 25 oder neuer und Compose v2.24 oder neuer.
- Kopieren Sie im Ordner
deploy/ des Repositorys .env.example nach .env und schränken Sie die Berechtigungen ein.
cp .env.example .env && chmod 600 .env
- Füllen Sie in
.env DOMAIN, ACME_EMAIL, TURN_SECRET, RD_SETUP_TOKEN, TURN_EXTERNAL_IP usw. aus. - Starten Sie es.
docker compose up -d --build
Wichtige Einstellungen
E-Mail (SMTP) und soziale Anmeldung werden in den Verwaltungsseiten eingestellt, nicht in der Einstellungsdatei.
Der nächste Schritt ist die Ersteinrichtung.
