RemoScreen — Guida al deployment del relay

Funzione del relay

I dispositivi tentano prima una connessione diretta. Se non è disponibile, il relay inoltra immagini, audio e comandi delle sessioni autorizzate. Aggiungi il tuo relay in Servizi di connessione sia sul Mac sia sull’iPad per usarlo come percorso alternativo. Tutte le istruzioni di download, configurazione e avvio riguardano il relay.

Download e preparazione

Scegli Linux x86_64 o ARM64 in base al server. Il pacchetto deve contenere remoscreen-service, remoscreen-setup, i modelli, questa guida, gli identificativi di versione e sorgente e SHA256SUMS. Confronta la somma di controllo con quella della pagina di pubblicazione, estrai in una nuova cartella e conserva la versione precedente.

Prepara un server Linux, un dominio che lo raggiunga e un certificato HTTPS valido per quel dominio. Usa un account dedicato con privilegi minimi e una cartella per i dati persistenti. Rendi eseguibili i programmi; limita l’accesso alla cartella di stato all’account del servizio e imposta i file delle chiavi generate su 0600.

Gli esempi usano connect.example.com, HTTPS 8443 e TCP 9443 per il relay. Verifica dominio, porte, firewall e gruppi di sicurezza cloud. Se una porta è occupata, pianifica un proxy inverso o un altro indirizzo di ascolto senza sostituire servizi esistenti.

Inizializzare il relay alternativo

Esegui lo strumento con l’account del servizio. Sostituisci il dominio di esempio e usa una cartella dati separata di proprietà dell’account:

./remoscreen-setup -directory /var/lib/remoscreen/relay \
  -role relay -name RemoScreen \
  -control-url https://connect.example.com:8443/v2/control \
  -relay-host connect.example.com -relay-tcp-port 9443

Vengono create l’identità del servizio, la chiave di accesso del client e la configurazione. Le inizializzazioni successive devono mantenere il ruolo relay e l’indirizzo originale; le identità esistenti non vengono sovrascritte. Non cancellare i dati e non rigenerare le chiavi per aggiornare il programma.

Avviare il relay alternativo

Usa la stessa cartella dati e sostituisci i percorsi dei certificati con file PEM reali leggibili dall’account del servizio:

./remoscreen-service -service-role=relay \
  -control-listen=:8443 \
  -control-tls-certificate=/etc/remoscreen/fullchain.pem \
  -control-tls-key=/etc/remoscreen/privkey.pem \
  -service-info-config=/var/lib/remoscreen/relay/service-info.json \
  -relay-control-config=/var/lib/remoscreen/relay/relay-control.json \
  -relay-access-keys=/var/lib/remoscreen/relay/relay-access-keys.json \
  -control-revocation-store=/var/lib/remoscreen/relay/revocations.json \
  -control-primary-lock=/var/lib/remoscreen/relay/primary.lock \
  -account-deletion-journal=/var/lib/remoscreen/relay/deletion-journal.json \
  -usage-ledger-store=/var/lib/remoscreen/relay/usage.jsonl \
  -public-host=connect.example.com -tcp-relay-listen=:9443 \
  -tcp-require-local-control-allocation=true \
  -relay-node-id=self-hosted -relay-region=self-hosted \
  -require-commercial-subscription=false

Verifica prima l’avvio in primo piano, poi usa il gestore dei servizi Linux. L’unità deve usare l’account dedicato, percorsi assoluti, gli stessi argomenti, la cartella privata e il riavvio in caso di errore. Dopo il rinnovo del certificato, riavvia questo servizio per caricare il nuovo certificato.

Aggiungere il relay su Mac e iPad

Leggi sul server il file privato client-connection.json per ottenere indirizzo e chiave di accesso del client. Condividili tramite un canale fidato. Su ogni dispositivo apri Servizi di connessione → Aggiungi server, inserisci i valori, verifica l’identità del servizio e salva.

I file importabili devono essere generati da Esporta configurazione nell’app. client-connection.json è il risultato della configurazione per gli amministratori, non un file da importare nell’app. Non condividere service-info.json, relay-control.json, chiavi private TLS o l’intera cartella dati del server.

La connessione diretta rimane prioritaria. Questo percorso alternativo viene usato solo se il relay è consentito e la connessione diretta non è disponibile.

Verificare il deployment

Da un’altra rete controlla il certificato HTTPS e l’identità firmata in /v2/service-info, quindi esegui il controllo del server nell’app. Con dispositivi già autorizzati e una rete di prova senza connessione diretta, verifica che venga effettivamente usato questo relay. Controlla nei log eventuali errori di certificato o chiave.

Un processo attivo o un controllo di integrità riuscito non bastano. Verifica lo schermo remoto, tastiera, mouse, trasferimento file e riconnessione. Assicurati che la versione dichiarata dal server corrisponda a quella distribuita.

Aggiornare, ripristinare e disinstallare

Prima di aggiornare, salva configurazione, tutti i dati persistenti e i programmi precedenti, e annota la versione. Ferma il servizio interessato, passa alla nuova versione mantenendo cartella dati e identità e ripeti i controlli. In caso di errore, ferma la nuova versione e ripristina quella precedente con il backup corrispondente. Segui le istruzioni di migrazione se cambia il formato dei dati.

Per disinstallare, disabilita e rimuovi prima l’unità del servizio interessato. L’amministratore deve decidere esplicitamente se eliminare programmi e dati. Conserva per impostazione predefinita dati e backup; non eliminare quelli di altri servizi o app.