--- title: Console Web weight: 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://:21114` nel browser per accedere alla pagina della console, come mostrato nella figura seguente. Il nome utente/password predefinito dell'amministratore è `admin`/`test1234`: ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-login.png) 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. ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2) 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](https://rustdesk.com/docs/en/self-host/client-configuration/) e agli [script di distribuzione](https://rustdesk.com/docs/en/self-host/client-deployment/) 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 --user_name Parametri supportati | Parametro | Descrizione | RustDesk Server Pro | RustDesk Client | | --------------------------------------- | ----------------------------------------- | ----------------- | --------------- | | `--user_name ` | Assegna un utente al dispositivo | | | | `--strategy_name ` | Assegna una strategia al dispositivo | | | | `--address_book_name ` | Assegna il dispositivo a una rubrica | | | | `--address_book_tag ` | Assegna con tag della rubrica | | | | `--address_book_alias ` | Assegna con alias della rubrica | 1.5.8 | 1.4.1 | | `--address_book_password ` | Imposta la password per la voce | 1.6.6 | 1.4.3 | | `--address_book_note ` | Imposta una nota per la voce | 1.6.6 | 1.4.3 | | `--device_group_name ` | Assegna il dispositivo a un gruppo | | | | `--note ` | Aggiunge una nota al dispositivo | 1.6.6 | 1.4.3 | | `--device_username ` | Imposta il nome utente del dispositivo | 1.6.6 | 1.4.3 | | `--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" ... | more "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String vedi [qui](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). ### Strumenti di Gestione Python CLI #### Gestione Utenti (`users.py`) **Mostra aiuto:** `./users.py -h` **Visualizza utenti:** `./users.py --url --token view [--name ] [--group_name ]` **Filtri:** - `--name`: nome utente (ricerca fuzzy) - `--group_name`: gruppo utenti (corrispondenza esatta) **Esempio:** `./users.py --url https://example.com --token view --group_name Default` **Operazioni di base:** - **Disabilitare utente:** `./users.py --url --token disable --name testuser` - **Abilitare utente:** `./users.py --url --token enable --name testuser` - **Eliminare utente:** `./users.py --url --token delete --name testuser` **Creazione e invito utenti:** - **Creare nuovo utente:** `./users.py --url --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 --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 --token enable-2fa-enforce --name username --web-console-url ` Richiesto: `--web-console-url` - **Disabilitare imposizione 2FA:** `./users.py --url --token disable-2fa-enforce --name username [--web-console-url ]` Opzionale: `--web-console-url` - **Reimpostare 2FA:** `./users.py --url --token reset-2fa --name username` - **Disabilitare verifica email:** `./users.py --url --token disable-email-verification --name username` - **Disconnessione forzata:** `./users.py --url --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 --token view [--name ]` **Esempio:** `./user_group.py --url https://example.com --token view --name "Team Vendite"` **Operazioni sui gruppi:** - **Creare gruppo utenti:** `./user_group.py --url --token add --name "NomeGruppo" [--note "descrizione"] [--accessed-from ''] [--access-to '']` Esempio con controllo accesso: `./user_group.py --url --token add --name "Ingegneria" --accessed-from '[{"type":0,"name":"Manager"}]' --access-to '[{"type":1,"name":"Server Dev"}]'` - **Aggiornare gruppo utenti:** `./user_group.py --url --token update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from ''] [--access-to '']` - **Eliminare gruppo utenti:** `./user_group.py --url --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 --token view-users [--name ] [--user-name ]` Filtri: - `--name`: nome del gruppo (corrispondenza esatta, opzionale) - `--user-name`: nome utente (ricerca fuzzy, opzionale) Esempio: `./user_group.py --url --token view-users --name Default --user-name john` - **Aggiungere utenti al gruppo:** `./user_group.py --url --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 --token view [--name ]` **Esempio:** `./device_group.py --url https://example.com --token view` **Operazioni sui gruppi:** - **Creare gruppo dispositivi:** `./device_group.py --url --token add --name "NomeGruppo" [--note "descrizione"] [--accessed-from '']` Esempio: `./device_group.py --url --token add --name "Produzione" --accessed-from '[{"type":0,"name":"Admins"}]'` - **Aggiornare gruppo dispositivi:** `./device_group.py --url --token update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from '']` - **Eliminare gruppo dispositivi:** `./device_group.py --url --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 --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: ```bash # Visualizzare tutti i dispositivi in un gruppo ./device_group.py --url --token view-devices --name Produzione # Cercare per nome dispositivo ./device_group.py --url --token view-devices --device-name server # Combinare filtri ./device_group.py --url --token view-devices --name Produzione --user-name john ``` - **Visualizzare gruppi dispositivi accessibili:** `./device_group.py --url --token accessible` Mostra tutti i gruppi dispositivi accessibili all'utente corrente. - **Aggiungere dispositivi al gruppo:** `./device_group.py --url --token add-devices --name "NomeGruppo" --ids "deviceid1,deviceid2"` - **Rimuovere dispositivi dal gruppo:** `./device_group.py --url --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 --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_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 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 assign --device_name PC01 --assign_to user_name=mike --- #### Gestione Rubrica (`ab.py`) **Mostra aiuto:** ./ab.py -h **Visualizza rubriche condivise:** ./ab.py --url --token view-ab [--ab-name ] **Ottieni GUID rubrica personale:** ./ab.py --url --token get-personal-ab **Aggiungi rubrica condivisa:** ./ab.py --url --token add-ab --ab-name [--note ] [--password ] **Aggiorna o elimina rubrica condivisa:** ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] ./ab.py --url --token delete-ab --ab-guid **Visualizza peer in una rubrica:** ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] **Aggiungi, aggiorna o elimina un peer:** ./ab.py --url --token add-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token update-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token delete-peer --ab-guid --peer-id **Gestione tag:** ./ab.py --url --token view-tag --ab-guid ./ab.py --url --token add-tag --ab-guid --tag-name [--tag-color 0xFF00FF00] ./ab.py --url --token update-tag --ab-guid --tag-name --tag-color 0xFFFF0000 ./ab.py --url --token delete-tag --ab-guid --tag-name **Gestione regole di accesso:** ./ab.py --url --token view-rule --ab-guid ./ab.py --url --token add-rule --ab-guid [--rule-type user|group|everyone] [--rule-user ] [--rule-group ] --rule-permission ro|rw|full ./ab.py --url --token update-rule --rule-guid --rule-permission rw ./ab.py --url --token delete-rule --rule-guid **Esempio (aggiungi regola sola lettura per l’utente "mike"):** ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro --- #### Gestione delle Strategie (`strategies.py`) **Mostra aiuto:** `./strategies.py -h` **Elenca tutte le strategie:** `./strategies.py --url --token list` **Visualizza una strategia specifica:** ```bash # Per nome ./strategies.py --url --token view --name "Default" # Per GUID ./strategies.py --url --token view --guid "01983006-fcca-7c12-9a91-b1df483c6073" ``` **Abilita o disabilita una strategia:** ```bash ./strategies.py --url --token enable --name "NomeStrategia" ./strategies.py --url --token disable --name "NomeStrategia" ``` **Assegna strategia a dispositivi, utenti o gruppi dispositivi:** ```bash # Assegna a dispositivi (per ID dispositivo) ./strategies.py --url --token assign --name "Default" --peers "1849118658,1337348840" # Assegna a utenti (per nome utente) ./strategies.py --url --token assign --name "Default" --users "admin,user1" # Assegna a gruppi dispositivi (per nome gruppo) ./strategies.py --url --token assign --name "Default" --device-groups "device_group1,Production" # Assegnazione mista ./strategies.py --url --token assign \ --name "Default" \ --peers "1849118658" \ --users "admin" \ --device-groups "device_group1" ``` **Rimuovi assegnazione strategia:** ```bash # Rimuovi da dispositivi ./strategies.py --url --token unassign --peers "1849118658,1337348840" # Rimuovi da utenti ./strategies.py --url --token unassign --users "admin" # Rimuovi da gruppi dispositivi ./strategies.py --url --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 --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizza audit file:** ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizza audit allarmi:** ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizza audit console:** ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **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 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.