2025-06-16 19:34:44 +09:00

20 KiB

title weight
FAQ 600

Come posso installare con il script di installazione semplice?

  1. Ottieni la tua licenza da https://rustdesk.com/pricing.html, controlla la pagina licenza per maggiori dettagli.
  2. Avvia un VPS, bare metal o VM Linux.
  3. Se vuoi usare DNS e SSL, crea un nome DNS come rustdesk.yourdomain.com.
  4. Questa pagina.
  5. Copia e incolla il comando nel tuo terminale Linux.
  6. Segui i prompt che ti guidano attraverso l'installazione.
  7. Una volta completata l'installazione vai su https://rustdesk.yourdomain.com o http://youripaddress:21114.
  8. Accedi con nome utente admin e password test1234.
  9. Inserisci il tuo codice licenza acquistato al passaggio 1.

Come posso convertire da RustDesk Server Open Source a RustDesk Server Pro?

  1. Ottieni la tua licenza da https://rustdesk.com/pricing.html, controlla la pagina licenza per maggiori dettagli.
  2. Apri la porta TCP 21114.
  3. Accedi al tuo RustDesk Server.
  4. Se non usi già DNS e vuoi usare SSL, crea un nome DNS come rustdesk.yourdomain.com.
  5. Questa pagina.
  6. Copia e incolla il comando nel tuo terminale Linux.
  7. Segui i prompt che ti guidano attraverso l'installazione.
  8. Una volta completata l'installazione vai su https://rustdesk.yourdomain.com o http://youripaddress:21114.
  9. Accedi con nome utente admin e password test1234.
  10. Inserisci il tuo codice licenza acquistato al passaggio 1.

C'è una nuova versione di RustDesk Server Pro, come posso aggiornare?

È meglio fare prima il backup dei file di dati (file sqlite3 ecc.), https://github.com/rustdesk/rustdesk-server-pro/discussions/184#discussioncomment-8013375.

  • Se hai installato con script (install.sh)

Esegui update.sh.

  • Docker Compose

sudo docker compose down
sudo docker compose pull 
sudo docker compose up -d
  • Docker

sudo docker ps
sudo docker stop <CONTAINER ID>
sudo docker rm <CONTAINER ID>
sudo docker rmi <IMAGE ID>
sudo docker run ..... # uguale a come l'hai installato prima

Ho installato con lo script, come posso avviare e fermare i servizi?

I servizi usano systemd quindi possono essere avviati e fermati usando sudo systemctl stop|start|restart rustdesk-hbbs|rustdesk-hbbr es. sudo systemctl restart rustdesk-hbbs.

Ho installato con lo script, come posso visualizzare i log di Linux?

I log sono memorizzati in /var/log/rustdesk-server, puoi visualizzarli usando tail /var/log/rustdesk-server/hbbs.log o tail /var/log/rustdesk-server/hbbs.error.

Ho installato con lo script, come posso controllare lo stato dei servizi RustDesk?

Per controllare lo stato sudo systemctl status rustdesk-hbbs|rustdesk-hbbr es. sudo systemctl status rustdesk-hbbs.

Come posso cambiare la password admin?

  1. Vai su https://rustdesk.yourdomain.com o http://youripaddress:21114.
  2. Accedi con nome utente admin e password test1234.
  3. Clicca su admin nell'angolo in alto a destra.
  4. Clicca su Impostazioni.
  5. Inserisci la tua nuova password nelle caselle fornite.

Come posso spostare la mia licenza su un nuovo server?

Vedi qui.

Le email non funzionano dal mio VPS

Molti provider VPS bloccano le porte 465 e 25.

Un modo semplice per controllare è usare telnet. Per testare nel terminale Linux digita telnet your.mailserver.com 25. Su Windows usa PowerShell con Test-NetConnection -ComputerName your.mailserver.com -Port 25.

Posso distribuire RustDesk usando PowerShell o simili?

Certo, puoi trovare script per aiutare la distribuzione qui.

Come posso segnalare un bug?

Segnala tramite GitHub.

Perché se sto auto-ospitando questo non è gratuito e open source?

  1. RustDesk è diventato un lavoro a tempo pieno per diverse persone, hanno vite, mogli, lavori e figli che richiedono attenzione e costano denaro!
  2. Vogliamo essere qui e continuare a fare grandi progressi negli anni a venire.
  3. La versione open source continuerà ad essere open source e incoraggiamo altri a fare sviluppi in linea con la licenza AGPL.

Non riesco a connettermi ai dispositivi in gruppi diversi, perché?

Questo è facilmente risolto, devi permettere l'accesso cross-group.

  1. Aggiungi nuovi gruppi.
  2. Clicca Modifica.
  3. Seleziona i gruppi rilevanti a cui vuoi accesso (li aggiunge automaticamente nel gruppo corrispondente).

Come posso ottenere configurazioni automaticamente?

Le configurazioni sono generate automaticamente.

  1. Scarica i client più recenti da GitHub.
  2. Nella pagina principale della console web clicca su Windows EXE.
  3. Compila host e API (se diverso dalla tua configurazione).
  4. Clicca Invia.
  5. Scansiona il codice QR su Android e rinomina l'exe con quello che è stato generato.

Offrite hosting per RustDesk Server Pro?

Contatta il nostro team vendite.

C'è un posto dove posso vedere guide video di configurazione?

Sì! Abbiamo un Canale YouTube.

Perché i miei log / nomi dispositivo sono vuoti?

Assicurati che l'API sia impostata correttamente sul dispositivo controllato, https://github.com/rustdesk/rustdesk-server-pro/issues/21#issuecomment-1637935750.

Come posso disinstallare RustDesk Server Pro?

Esegui i seguenti comandi:

sudo systemctl stop rustdesk-hbbs.service
sudo systemctl disable rustdesk-hbbs.service
sudo systemctl stop rustdesk-hbbr.service
sudo systemctl disable rustdesk-hbbr.service
sudo systemctl daemon-reload
sudo rm /etc/systemd/system/rustdesk-hbbs.service
sudo rm etc/systemd/system/rustdesk-hbbr.service
sudo rm /usr/bin/hbbs
sudo rm /usr/bin/hbbr
sudo rm -rf /var/lib/rustdesk-server/
sudo rm -rf /var/log/rustdesk-server/

Come posso rimuovere dispositivi dalla lista dispositivi nella console web?

Disabilita e poi elimina sarà disponibile.

Come posso aggiornare RustDesk con PowerShell?

$ErrorActionPreference= 'silentlycontinue'
$rdver = ((Get-ItemProperty  "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RustDesk\").Version)
if ($rdver -eq "1.2.6")
{
    Write-Output "RustDesk $rdver is the newest version."
    Exit
}
if (!(Test-Path C:\Temp))
{
    New-Item -ItemType Directory -Force -Path C:\Temp > null
}
cd C:\Temp
Invoke-WebRequest "https://github.com/rustdesk/rustdesk/releases/download/1.2.6/rustdesk-1.2.6-x86_64.exe" -Outfile "rustdesk.exe"
Start-Process .\rustdesk.exe --silent-install -wait

Errore Key mismatch

Configura il tuo client con la chiave corretta.

Errore Failed to connect to relay server

Assicurati che hbbr sia in esecuzione. Più informazioni su hbbr, puoi trovarle qui.

Resetta MFA per account Admin

https://github.com/rustdesk/rustdesk/discussions/6576

Impostare HTTPS per console web manualmente

1. Acquistare un nome di dominio e risolverlo all'indirizzo IP del tuo server.

  • Acquista un nome di dominio da un registrar come GoDaddy, Namecheap o Namesilo.
  • Risolvi il nome di dominio all'indirizzo IP del tuo server con uno dei seguenti:
    • Il pannello di controllo del tuo registrar di domini (consigliato)
    • Provider DNS

Ad esempio, se acquisti un nome di dominio example.com da Namesilo e l'indirizzo IP del tuo server è 123.123.123.123, vuoi usare il sottodominio rustdesk.example.com come indirizzo della console web HTTPS. Devi aprire link, fare clic sul pulsante con tooltip Manage dns for the domain, aggiungere un record A con il nome host rustdesk e l'indirizzo IP del tuo server.

  • Ci vuole del tempo perché il DNS abbia effetto, https://www.whatsmydns.net e verifica se il nome di dominio è stato risolto all'indirizzo IP del tuo server. Il passaggio 6 dipende dal risultato corretto della risoluzione. Nei passaggi seguenti, sostituisci <YOUR_DOMAIN> con il tuo sottodominio, ad es. rustdesk.example.com.

2. Installare Nginx

  • Debian/Ubuntu: sudo apt-get install nginx
  • Fedora/CentOS: sudo dnf install nginx o sudo yum install nginx
  • Arch: sudo pacman -S install nginx
  • openSUSE: sudo zypper install nginx
  • Gentoo: sudo emerge -av nginx
  • Appine: sudo apk add --no-cache nginx

Esegui nginx -h per verificare se è stato installato correttamente.

3. Installare Certbot

  • Metodo 1: Se snap è installato, esegui sudo snap install certbot --classic.
  • Metodo 2: Usando python3-certbot-nginx invece, ad es. sudo apt-get install python3-certbot-nginx per Ubuntu.
  • Metodo 3: Se i due metodi precedenti sono falliti, prova a installare certbot-nginx, ad es. sudo yum install certbot-nginx per CentOS 7.

Esegui certbot -h per verificare se è stato installato correttamente.

4. Configurare Nginx

Ci sono due modi:

  • Se esistono le directory /etc/nginx/sites-available e /etc/nginx/sites-enabled, sostituisci <YOUR_DOMAIN> del seguente comando con il tuo nome di dominio ed eseguilo.
cat > /etc/nginx/sites-available/rustdesk.conf << EOF
server {
    server_name <YOUR_DOMAIN>;
    location / {
        proxy_set_header        X-Real-IP       \$remote_addr;
        proxy_set_header        X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:21114/;
    }
}
EOF

Quindi esegui sudo ln -s /etc/nginx/sites-available/rustdesk.conf /etc/nginx/sites-enabled/rustdesk.conf.

Esegui cat /etc/nginx/sites-available/rustdesk.conf per assicurarti che il suo contenuto sia corretto.

  • Se le directory /etc/nginx/sites-available e /etc/nginx/sites-enabled non esistono e la directory /etc/nginx/conf.d esiste, sostituisci <YOUR_DOMAIN> del seguente comando con il tuo nome di dominio ed eseguilo.
cat > /etc/nginx/conf.d/rustdesk.conf << EOF
server {
    server_name <YOUR_DOMAIN>;
    location / {
        proxy_set_header        X-Real-IP       \$remote_addr;
        proxy_set_header        X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:21114/;
    }
}
EOF

Esegui cat /etc/nginx/conf.d/rustdesk.conf per assicurarti che il suo contenuto sia corretto.

5. Abilitare le regole del firewall per il dominio

Esegui i seguenti comandi:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw --force enable
sudo ufw --force reload

6. Generare certificato SSL

Sostituisci $YOUR_DOMAIN con il tuo nome di dominio, quindi esegui sudo certbot --nginx --cert-name $YOUR_DOMAIN --key-type ecdsa --renew-by-default --no-eff-email --agree-tos --server https://acme-v02.api.letsencrypt.org/directory -d $YOUR_DOMAIN.

Se richiede Enter email address (used for urgent renewal and security notices), inserisci il tuo indirizzo email.

Infine, il contenuto di rustdesk.conf dovrebbe essere così:

server {
    server_name <YOUR_DOMAIN>;
    location / {
        proxy_set_header        X-Real-IP       $remote_addr;
        proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:21114/;
    }

    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/<YOUR_DOMAIN>/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/<YOUR_DOMAIN>/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}

server {
    if ($host = <YOUR_DOMAIN>) {
        return 301 https://$host$request_uri;
    } # managed by Certbot

    server_name <YOUR_DOMAIN>;
    listen 80;
    return 404; # managed by Certbot
}

Ecco alcuni errori comuni:

  • La console stampa Successfully deployed certificate for <YOUR_DOMAIN> to /etc/nginx/.../default invece di Successfully deployed certificate for <YOUR_DOMAIN> to /etc/nginx/.../rustdesk.conf.

Il motivo potrebbe essere che Certbot non trova il file rustdesk.conf, puoi provare una delle seguenti soluzioni:

  • Controlla il risultato del passaggio 5, esegui sudo service nginx restart.
  • Copia le configurazioni del server server{...} che contengono <YOUR_DOMAIN> in rustdesk.conf, e cambia location{...} nel contenuto seguente.
location / {
    proxy_set_header        X-Real-IP       $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass http://127.0.0.1:21114/;
}
  • too many certificates (5) already issued for this exact set of domains in the last 168 hours

Soluzione: Aggiungi un altro nome di dominio al DNS e cambia <YOUR_DOMAIN> con esso, ad es. rustdesk2.example.com. Quindi ripeti i passaggi 1, 4, 6.

  • Error getting validation data

Soluzione: potrebbe essere causato dal firewall, consulta https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#firewall

Avviso: Esegui sudo service nginx restart se modifichi rustdesk.conf manualmente.

7. Accedere alla pagina web

  • Apri https://<YOUR_DOMAIN> nel browser, accedi usando il nome utente predefinito "admin" e la password "test1234", quindi cambia la password con la tua.

8. Aggiungere supporto WebSocket Secure (WSS) per il server ID e il server relay per abilitare la comunicazione sicura su tutte le piattaforme.

Aggiungi la seguente configurazione alla prima sezione server del file /etc/nginx/.../rustdesk.conf, quindi riavvia il servizio Nginx. Il client web può essere accessibile tramite https://<YOUR_DOMAIN>/web. I client personalizzati possono utilizzare WebSocket impostando allow-websocket=Y nelle opzioni avanzate. Se viene utilizzato il client personalizzato con WebSocket abilitato, non utilizzerà TCP/UDP e potrà connettersi solo tramite relay (tranne che per le connessioni IP dirette). Se viene utilizzato solo questo client con WebSocket abilitato, il server può chiudere le porte da 21114 a 21119 e mantenere aperta solo la porta 443.

    location /ws/id {
        proxy_pass http://127.0.0.1:21118;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
    }

    location /ws/relay {
        proxy_pass http://127.0.0.1:21119;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
    }

La configurazione completa è

server {
    server_name <YOUR_DOMAIN>;
    location / {
        proxy_set_header        X-Real-IP       $remote_addr;
        proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:21114/;
    }

    location /ws/id {
        proxy_pass http://127.0.0.1:21118;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
    }

    location /ws/relay {
        proxy_pass http://127.0.0.1:21119;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 120s;
    }

    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/<YOUR_DOMAIN>/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/<YOUR_DOMAIN>/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}

server {
    if ($host = <YOUR_DOMAIN>) {
        return 301 https://$host$request_uri;
    } # managed by Certbot

    server_name <YOUR_DOMAIN>;
    listen 80;
    return 404; # managed by Certbot
}

{{% notice note %}} Se hai distribuito precedentemente per i client web e vuoi usarlo su tutte le piattaforme, devi aggiungere proxy_read_timeout. {{% /notice %}}

9. Bypassare CORS se usi il client web pubblico di RustDesk https://rustdesk.com/web

Devi aggiungere quanto segue nella sezione location / del /etc/nginx/.../rustdesk.conf per bypassare la limitazione CORS dei browser. Salta questo passaggio se stai usando il tuo client web.

        if ($http_origin ~* (https?://(www\.)?rustdesk\.com)) {
            add_header 'Access-Control-Allow-Origin' "$http_origin" always;
            add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, PATCH, OPTIONS' always;
            add_header 'Access-Control-Allow-Headers' 'Origin, Content-Type, Accept, Authorization' always;
            add_header 'Access-Control-Allow-Credentials' 'true' always;
        }

        if ($request_method = 'OPTIONS') {
            add_header 'Access-Control-Allow-Origin' "$http_origin" always;
            add_header 'Access-Control-Allow-Methods' 'GET, POST, PUT, DELETE, PATCH, OPTIONS' always;
            add_header 'Access-Control-Allow-Headers' 'Origin, Content-Type, Accept, Authorization' always;
            add_header 'Access-Control-Allow-Credentials' 'true' always;
            add_header 'Content-Length' 0;
            add_header 'Content-Type' 'text/plain charset=UTF-8';
            return 204;
        }

SELinux

Se Waiting for RustDesk Relay service to become active... appare durante l'installazione, potrebbe essere causato da SELinux:

sudo semanage fcontext -a -t NetworkManager_dispatcher_exec_t 'hbbs'
sudo semanage fcontext -a -t NetworkManager_dispatcher_exec_t 'hbbr'
sudo restorecon -v '/usr/bin/hbbs'
sudo restorecon -v '/usr/bin/hbbr'

Firewall

Firewall cloud

Se esegui su AWS/Azure/Google/DigitalOcean cloud, apri le porte UDP (21116) e TCP (21114-21119) in entrata sul dashboard del provider cloud.

Firewall server on-premise

sudo firewall-cmd --permanent --add-port=21115/tcp
sudo firewall-cmd --permanent --add-port=21116/tcp
sudo firewall-cmd --permanent --add-port=21117/tcp
sudo firewall-cmd --permanent --add-port=21118/tcp
sudo firewall-cmd --permanent --add-port=21119/tcp
sudo firewall-cmd --permanent --add-port=21116/udp
sudo firewall-cmd --reload

Dopo aver cambiato la password admin nella console web non riesco ad accedere. C'è un modo semplice per resettare la password?

  1. Assicurati di avere rustdesk-utils installato. Se non ce l'hai puoi ottenerlo qui.
  2. Il comando è rustdesk-utils set_password username password. Se funziona dirà Done.

Aggiungere certificato CA radice nel container Docker (per fallimento TLS con SMTP, OIDC ecc.)

https://github.com/rustdesk/rustdesk-server-pro/issues/99#issuecomment-2235014703