Il server ha bisogno di un nome di dominio (per esempio remote.example.com) e di un record DNS A/AAAA che punti al server. Puoi iniziare con un server piccolo da 1 vCPU e 1 GB di memoria.
Installazione con i pacchetti (Linux)
- Installa i pacchetti del server. Le impostazioni si trovano in
/etc/tastedev-remote/ e i dati in /var/lib/tastedev-remote/. - Compila
/etc/tastedev-remote/tasteremote-signal.env. I valori obbligatori sono:
- Installa coturn e imposta
static-auth-secret in /etc/turnserver.conf sullo stesso valore di TURN_SECRET.
sudo apt install coturn
- Configura il proxy inverso. Usa Caddy, oppure crea una configurazione nginx o Apache con la procedura guidata Configurazione server delle pagine di amministrazione (vedi sotto).
- Attiva i servizi.
sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer
- Scarica i programmi di installazione dell'host da mettere a disposizione degli utenti. Senza di essi,
/downloads/ restituisce 503 e la pagina di download mostra "Questo server non ha ancora programmi di installazione". Su un server senza accesso a internet, metti tu i programmi di installazione nella cartella downloads/.
sudo tasteremote-fetch-hosts
Su un server Windows, le impostazioni si trovano in %ProgramData%\tasteremote\config\ e i dati in %ProgramData%\tasteremote\data, e il server gira come servizio.
Procedura guidata di configurazione del server (nginx · Apache)
Accedi con il primo account amministratore e apri Amministrazione › Configurazione server. In cinque passaggi la procedura crea i file di configurazione e i comandi, che l'amministratore incolla ed esegue tramite SSH. La pagina in sé non esegue nulla sul server.
- Scegli il web server: nginx o httpd, e il sistema operativo (deb o rpm)
- Indirizzo e porte: il dominio (gli indirizzi IP non sono accettati)
- Configurazione del proxy: il file di configurazione e i comandi per il firewall
- Certificato HTTPS: ottiene un certificato con certbot e lo rinnova automaticamente.
- Verifica: valori come
RD_WEB_ORIGIN, RD_COOKIE_SECURE=1 e TRUST_PROXY=1, e comandi di verifica. Controlla che /healthz risponda e che una connessione a /ws passi a 101 (400 o 426 significa che il proxy ha scartato le intestazioni WebSocket).
Installazione con Docker Compose
Servono Docker Engine 25 o successivo e Compose v2.24 o successivo.
- Nella cartella
deploy/ del repository, copia .env.example in .env e limitane i permessi.
cp .env.example .env && chmod 600 .env
- Compila
DOMAIN, ACME_EMAIL, TURN_SECRET, RD_SETUP_TOKEN, TURN_EXTERNAL_IP e gli altri valori in .env. - Avvia i servizi.
docker compose up -d --build
Impostazioni principali
Posta (SMTP) e accesso social si impostano nelle pagine di amministrazione, non nel file delle impostazioni.
Il passaggio successivo è Prima configurazione.
