doc.rustdesk.com/content/self-host/rustdesk-server-pro/console/_index.it.md

title	weight
Console Web	10

La console web è integrata in RustDesk Server Pro, servita dalla porta 21114.

Caratteristiche:

• Sfogliare i dispositivi
• Aggiungere/modificare utenti e gruppi di utenti
• Modificare i permessi di accesso ai dispositivi
• Sfogliare i log di connessione dei dispositivi e altri log
• Aggiornare le impostazioni
• Gestire le strategie di sincronizzazione delle impostazioni del client
• Gestire le rubriche condivise
• Generare build personalizzate del client

Accedere

La porta predefinita della console web è 21114. Inserisci http://<ip del server>:21114 nel browser per accedere alla pagina della console, come mostrato nella figura seguente. Il nome utente/password predefinito dell'amministratore è admin/test1234:

Se hai bisogno del supporto HTTPS, installa un server web come Nginx o usa IIS per Windows.

Dopo aver effettuato l'accesso, assicurati di cambiare la password, seleziona Impostazioni nel menu dell'account nell'angolo in alto a destra per accedere alla pagina di modifica della password, come mostrato nella figura seguente. Puoi anche creare un altro account amministratore e eliminare questo. È meglio abilitare la verifica dell'accesso via email.

Anche gli utenti non amministratori possono accedere per sfogliare i loro dispositivi e log, modificare le loro impostazioni utente.

Configurazioni Automatiche

Cliccando su Windows EXE sarai in grado di ottenere le configurazioni per il tuo RustDesk Server Pro, questo aiuterà a configurare i tuoi client.

Per i client Windows, puoi omettere la configurazione personalizzata del server e mettere le informazioni di configurazione nel nome del file rustdesk.exe invece. Come mostrato sopra, vai alla pagina di benvenuto della console e clicca su Windows EXE. Client ≥ 1.1.9 richiesto.

Puoi usare questo insieme alla configurazione del client e agli script di distribuzione per configurare i tuoi client.

Creare un nuovo utente diverso dall'utente predefinito admin

{{% notice note %}} Il piano Individual non ha questa caratteristica. {{% /notice %}}

1. Clicca su Utenti nel menu a sinistra.
2. Crea un altro account con amministratore abilitato.
3. Accedi con il nuovo account amministrativo.
4. Elimina l'admin nella pagina Utenti.

Creare un nuovo utente

1. Clicca su Utenti nel menu a sinistra.
2. Crea un nuovo utente.
3. Seleziona in quale gruppo dovrebbero essere (se devi aggiungere nuovi gruppi continua a leggere).

Aggiungere un nuovo Gruppo

1. Clicca su Gruppi nel menu a sinistra.
2. Crea un nuovo gruppo.
3. Una volta creato puoi permettere ai gruppi di accedere l'uno all'altro, clicca Modifica.
4. Seleziona i gruppi rilevanti a cui vuoi accesso (li aggiunge automaticamente nel gruppo corrispondente).

Configurare più server relay

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su Relay nel sottomenu.
3. Clicca + accanto a Server Relay.
4. Inserisci l'indirizzo DNS o l'indirizzo IP del server relay nella casella che ora appare e premi Invio.
5. Se hai più di un server relay puoi continuare a cliccare + e adattare le impostazioni geografiche se necessario (ricorda e copia la tua chiave agli altri server).

Impostare o cambiare la licenza

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su Licenza nel sottomenu.
3. Clicca Modifica e incolla il tuo codice licenza.
4. Clicca OK.

Visualizzare i Log

Sul lato sinistro clicca su Log.

Configurare le Email

Gmail in questo esempio

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su SMTP nel sottomenu.
3. Inserisci l'indirizzo SMTP smtp.gmail.com.
4. Inserisci la Porta 587 in Porta SMTP.
5. Inserisci l'account Gmail cioè myrustdeskserver@gmail.com in Account Mail.
6. Inserisci la tua password (potresti aver bisogno di una password dell'app).
7. Inserisci il tuo account Gmail cioè myrustdeskserver@gmail.com in Da.
8. Clicca Controlla per salvare.

Assegnazione di Utenti/Strategie/Gruppi di Dispositivi ai Dispositivi tramite Console Web

L’Utente è l’utente RustDesk connesso al dispositivo o assegnato al dispositivo cliccando su Modifica accanto al dispositivo, cliccando nella casella Utente e selezionando il proprio utente dal menu a discesa.
È anche possibile assegnare dispositivi in blocco a un utente cliccando su Altro → Assegna Dispositivi nella Lista Utenti.

Per aggiungere un dispositivo a un gruppo di dispositivi, è possibile cliccare su Modifica accanto al dispositivo nella Lista Dispositivi e cambiare il Gruppo, oppure andare nella lista dei Gruppi di Dispositivi, cliccare sul nome di un gruppo e regolare i dispositivi in quel gruppo.

Per assegnare una strategia a un dispositivo, passare il mouse sul lato destro della lista Strategia e cliccare su Modifica Dispositivi, Modifica Utenti o Modifica Gruppi di Dispositivi nel menu per aggiungere i dispositivi corrispondenti, i dispositivi degli utenti o i dispositivi del gruppo alla strategia selezionata.

---

Token API

È necessario prima andare su Impostazioni → Token → Crea e creare un token con le autorizzazioni richieste: Dispositivo, Registro Audit, Utente, Gruppo, Strategia, Rubrica.

Una volta creato, è possibile utilizzare questi token tramite linea di comando o Python CLI per eseguire azioni con le autorizzazioni corrispondenti.

Assegnazione tramite Token dalla Linea di Comando

È anche possibile eseguire assegnazioni utilizzando l’eseguibile RustDesk con il parametro --assign.
Questo permette di assegnare utenti, strategie, rubriche o gruppi di dispositivi a un dispositivo direttamente dalla linea di comando.

Esempio:

"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <generatedtoken> --user_name <username>

Parametri supportati

Parametro	Descrizione	RustDesk Server Pro	RustDesk Client
--user_name <username>	Assegna un utente al dispositivo
--strategy_name <strategyname>	Assegna una strategia al dispositivo
--address_book_name <addressbookname>	Assegna il dispositivo a una rubrica
--address_book_tag <addressbooktag>	Assegna con tag della rubrica
--address_book_alias <alias>	Assegna con alias della rubrica	1.5.8	1.4.1
--address_book_password <password>	Imposta la password per la voce	1.6.6	1.4.3
--address_book_note <note>	Imposta una nota per la voce	1.6.6	1.4.3
--device_group_name <devicegroupname>	Assegna il dispositivo a un gruppo
--note <note>	Aggiunge una nota al dispositivo	1.6.6	1.4.3
--device_username <device_username>	Imposta il nome utente del dispositivo	1.6.6	1.4.3
--device_name <device_name>	Imposta il nome del dispositivo	1.6.6	1.4.3

La linea di comando su Windows non produce output per default. Per ottenere output, eseguire:

"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String

vedi qui.

Strumenti di Gestione Python CLI

Gestione Utenti (users.py)

Mostra aiuto:
./users.py -h

Visualizza utenti:
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]

Filtri:

• --name: nome utente (ricerca fuzzy)
• --group_name: gruppo utenti (corrispondenza esatta)

Esempio:
./users.py --url https://example.com --token <token> view --group_name Default

Operazioni di base:

• Disabilitare utente:
  ./users.py --url <url> --token <token> disable --name testuser

• Abilitare utente:
  ./users.py --url <url> --token <token> enable --name testuser

• Eliminare utente:
  ./users.py --url <url> --token <token> delete --name testuser

Creazione e invito utenti:

• Creare nuovo utente:
  ./users.py --url <url> --token <token> new --name username --password 'password123' --group_name Default [--email user@example.com] [--note "nota"]

  Richiesto: --name, --password, --group_name
  Opzionale: --email, --note

• Invitare utente via email:
  ./users.py --url <url> --token <token> invite --email user@example.com --name username --group_name Default [--note "nota"]

  Richiesto: --email, --name, --group_name
  Opzionale: --note

Operazioni 2FA e sicurezza:

• Abilitare imposizione 2FA:
  ./users.py --url <url> --token <token> enable-2fa-enforce --name username --web-console-url <console_url>

  Richiesto: --web-console-url

• Disabilitare imposizione 2FA:
  ./users.py --url <url> --token <token> disable-2fa-enforce --name username [--web-console-url <console_url>]

  Opzionale: --web-console-url

• Reimpostare 2FA:
  ./users.py --url <url> --token <token> reset-2fa --name username

• Disabilitare verifica email:
  ./users.py --url <url> --token <token> disable-email-verification --name username

• Disconnessione forzata:
  ./users.py --url <url> --token <token> force-logout --name username

Note:

• Quando si opera su più utenti (corrispondenti ai filtri), verrà richiesta conferma
• Se non ci sono utenti corrispondenti, verrà mostrato "Found 0 users"

---

Gestione Gruppi Utenti (user_group.py)

Mostra aiuto:
./user_group.py -h

Visualizza gruppi utenti:
./user_group.py --url <url> --token <token> view [--name <group_name>]

Esempio:
./user_group.py --url https://example.com --token <token> view --name "Team Vendite"

Operazioni sui gruppi:

• Creare gruppo utenti:
  ./user_group.py --url <url> --token <token> add --name "NomeGruppo" [--note "descrizione"] [--accessed-from '<json>'] [--access-to '<json>']

  Esempio con controllo accesso:
  ./user_group.py --url <url> --token <token> add --name "Ingegneria" --accessed-from '[{"type":0,"name":"Manager"}]' --access-to '[{"type":1,"name":"Server Dev"}]'

• Aggiornare gruppo utenti:
  ./user_group.py --url <url> --token <token> update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from '<json>'] [--access-to '<json>']

• Eliminare gruppo utenti:
  ./user_group.py --url <url> --token <token> delete --name "NomeGruppo"

  Supporta nomi separati da virgola: --name "Gruppo1,Gruppo2,Gruppo3"

Gestione utenti nei gruppi:

• Visualizzare utenti nel gruppo:
  ./user_group.py --url <url> --token <token> view-users [--name <group_name>] [--user-name <username>]

  Filtri:

  • --name: nome del gruppo (corrispondenza esatta, opzionale)
  • --user-name: nome utente (ricerca fuzzy, opzionale)

  Esempio:
  ./user_group.py --url <url> --token <token> view-users --name Default --user-name john

• Aggiungere utenti al gruppo:
  ./user_group.py --url <url> --token <token> add-users --name "NomeGruppo" --users "user1,user2,user3"

Parametri controllo accesso:

• --accessed-from: array JSON che definisce chi può accedere a questo gruppo utenti

  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Admins"}])
  • Type 2 = Utente (es. [{"type":2,"name":"john"}])

• --access-to: array JSON che definisce a cosa può accedere questo gruppo utenti

  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Supporto"}])
  • Type 1 = Gruppo dispositivi (es. [{"type":1,"name":"Server"}])

Nota: Utilizzare virgolette singole attorno agli array JSON per evitare problemi di parsing della shell.

Requisiti di permessi:

• I comandi view/add/update/delete/add-users richiedono Permesso Gruppo Utenti
• Il comando view-users richiede Permesso Utente

---

Gestione Gruppi Dispositivi (device_group.py)

Mostra aiuto:
./device_group.py -h

Visualizza gruppi dispositivi:
./device_group.py --url <url> --token <token> view [--name <group_name>]

Esempio:
./device_group.py --url https://example.com --token <token> view

Operazioni sui gruppi:

• Creare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> add --name "NomeGruppo" [--note "descrizione"] [--accessed-from '<json>']

  Esempio:
  ./device_group.py --url <url> --token <token> add --name "Produzione" --accessed-from '[{"type":0,"name":"Admins"}]'

• Aggiornare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from '<json>']

• Eliminare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> delete --name "NomeGruppo"

  Supporta nomi separati da virgola: --name "Gruppo1,Gruppo2,Gruppo3"

Gestione dispositivi nei gruppi:

• Visualizzare dispositivi nel gruppo:
  ./device_group.py --url <url> --token <token> view-devices [filtri]

  Filtri disponibili:

  • --name: nome del gruppo dispositivi (corrispondenza esatta)
  • --id: ID dispositivo (ricerca fuzzy)
  • --device-name: nome dispositivo (ricerca fuzzy)
  • --user-name: nome utente/proprietario (ricerca fuzzy)
  • --device-username: nome utente connesso al dispositivo (ricerca fuzzy)

  Esempi:

  # Visualizzare tutti i dispositivi in un gruppo
  ./device_group.py --url <url> --token <token> view-devices --name Produzione
  
  # Cercare per nome dispositivo
  ./device_group.py --url <url> --token <token> view-devices --device-name server
  
  # Combinare filtri
  ./device_group.py --url <url> --token <token> view-devices --name Produzione --user-name john
  

• Visualizzare gruppi dispositivi accessibili:
  ./device_group.py --url <url> --token <token> accessible

  Mostra tutti i gruppi dispositivi accessibili all'utente corrente.

• Aggiungere dispositivi al gruppo:
  ./device_group.py --url <url> --token <token> add-devices --name "NomeGruppo" --ids "deviceid1,deviceid2"

• Rimuovere dispositivi dal gruppo:
  ./device_group.py --url <url> --token <token> remove-devices --name "NomeGruppo" --ids "deviceid1,deviceid2"

Parametro controllo accesso:

• --accessed-from: array JSON che definisce chi può accedere a questo gruppo dispositivi
  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Ingegneri"}])
  • Type 2 = Utente (es. [{"type":2,"name":"admin"}])

Requisiti permessi:

• I comandi view/add/update/delete/add-devices/remove-devices richiedono Permesso Gruppo Dispositivi
• Il comando view-devices richiede Permesso Dispositivo

---

Gestione Dispositivi (devices.py)

Mostra aiuto:

./devices.py -h

Visualizza dispositivi:

./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]

Filtri:

--id : ID dispositivo
--device_name : nome dispositivo
--user_name : utente assegnato
--group_name : gruppo utenti
--device_group_name : gruppo dispositivi
--offline_days : giorni offline

Esempio:

./devices.py --url https://example.com --token <token> view --user_name mike

Operazioni:

view può essere sostituito con enable, disable, delete, o assign.

Esempio (assegnare dispositivo):

./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike

---

Gestione Rubrica (ab.py)

Mostra aiuto:

./ab.py -h

Visualizza rubriche condivise:

./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]

Ottieni GUID rubrica personale:

./ab.py --url <url> --token <token> get-personal-ab

Aggiungi rubrica condivisa:

./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]

Aggiorna o elimina rubrica condivisa:

./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>

Visualizza peer in una rubrica:

./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]

Aggiungi, aggiorna o elimina un peer:

./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>

Gestione tag:

./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>

Gestione regole di accesso:

./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>

Esempio (aggiungi regola sola lettura per l’utente "mike"):

./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro

---

Gestione delle Strategie (strategies.py)

Mostra aiuto:
./strategies.py -h

Elenca tutte le strategie:
./strategies.py --url <url> --token <token> list

Visualizza una strategia specifica:

# Per nome
./strategies.py --url <url> --token <token> view --name "Default"

# Per GUID
./strategies.py --url <url> --token <token> view --guid "01983006-fcca-7c12-9a91-b1df483c6073"

Abilita o disabilita una strategia:

./strategies.py --url <url> --token <token> enable --name "NomeStrategia"
./strategies.py --url <url> --token <token> disable --name "NomeStrategia"

Assegna strategia a dispositivi, utenti o gruppi dispositivi:

# Assegna a dispositivi (per ID dispositivo)
./strategies.py --url <url> --token <token> assign --name "Default" --peers "1849118658,1337348840"

# Assegna a utenti (per nome utente)
./strategies.py --url <url> --token <token> assign --name "Default" --users "admin,user1"

# Assegna a gruppi dispositivi (per nome gruppo)
./strategies.py --url <url> --token <token> assign --name "Default" --device-groups "device_group1,Production"

# Assegnazione mista
./strategies.py --url <url> --token <token> assign \
  --name "Default" \
  --peers "1849118658" \
  --users "admin" \
  --device-groups "device_group1"

Rimuovi assegnazione strategia:

# Rimuovi da dispositivi
./strategies.py --url <url> --token <token> unassign --peers "1849118658,1337348840"

# Rimuovi da utenti
./strategies.py --url <url> --token <token> unassign --users "admin"

# Rimuovi da gruppi dispositivi
./strategies.py --url <url> --token <token> unassign --device-groups "device_group1"

Note:

• Lo script supporta sia nomi che GUID per utenti e gruppi dispositivi
• Gli ID dispositivi vengono automaticamente convertiti in GUID
• Tutte le operazioni assign/unassign possono gestire più target contemporaneamente

Requisiti di permessi:

• I comandi list/view/enable/disable/assign/unassign richiedono Permesso Strategia
• --peers richiede Permesso Dispositivo:r (per ricerca da ID a GUID)
• --users richiede Permesso Utente:r (per ricerca da nome utente a GUID)
• --device-groups richiede Permesso Gruppo Dispositivi:r (per ricerca da nome gruppo a GUID)

---

Audit (audits.py)

Mostra aiuto:

./audits.py -h

Visualizza audit di connessione:

./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit file:

./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit allarmi:

./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit console:

./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Filtri:

--remote : ID peer (per audit di connessione o file)
--conn-type : 0=Desktop Remoto, 1=Trasferimento File, 2=Trasferimento Porte, 3=Visualizza Telecamera, 4=Terminale
--device : ID dispositivo (per audit allarmi)
--operator : nome operatore (per audit console)
--created-at : filtro orario locale, es. "2025-09-16 14:15:57"
--days-ago : filtra record più recenti di n giorni
--page-size / --current : paginazione

Esempio:

./audits.py --url https://example.com --token <token> view-conn --remote 123456789 --days-ago 7

Cercare un dispositivo

1. Vai su Dispositivi.
2. Nel Campo di Ricerca Nome Dispositivo digita il nome e clicca Query o premi Invio.
3. Per usare un carattere jolly aggiungi % all'inizio, alla fine o a entrambi del termine di ricerca.