22 KiB
| title | weight |
|---|---|
| Consolă web | 10 |
Consola web este integrată în RustDesk Server Pro și rulează pe portul 21114.
Funcționalități:
- Răsfoire dispozitive
- Adăugare/modificare utilizatori și grupuri de utilizatori
- Modificare permisiuni de acces ale dispozitivelor
- Răsfoire jurnale de conexiuni și alte jurnale
- Actualizare setări
- Management sincronizare setări client
- Gestionare agende partajate
- Generare build client personalizat
Autentificare
Portul implicit al consolei web este 21114. Introdu http://<adresa-serverului>:21114 în browser pentru a accesa consola, așa cum se arată în figura de mai jos. Numele de utilizator/parola implicită pentru administrator este admin/test1234:
Dacă ai nevoie de suport HTTPS, instalează un server web precum Nginx sau folosește IIS pe Windows.
După autentificare schimbă parola: din meniul contului (colțul din dreapta sus) selectează Settings pentru a intra pe pagina de modificare a parolei, așa cum se arată mai jos. Poți crea și un alt cont de administrator și șterge pe cel implicit. Este recomandat să activezi verificarea prin email la autentificare.
Utilizatorii non-administrator pot, de asemenea, să se autentifice pentru a-și vizualiza dispozitivele și jurnalele și pentru a-și modifica setările de utilizator.
Configurări automate
Făcând click pe Windows EXE poți obține configurațiile pentru propriul RustDesk Server Pro — utile pentru configurarea clienților.
Pentru clienții Windows poți omite configurația serverului personalizat și pune informațiile de configurare direct în numele fișierului rustdesk.exe. Așa cum se arată mai sus, mergi la pagina de bun venit a consolei și apasă Windows EXE. Client ≥ 1.1.9 necesar.
Poți folosi aceasta în combinație cu config client și scripturi de deployment pentru a configura clienții.
Crearea unui utilizator nou în afară de utilizatorul implicit admin
{{% notice note %}}
Planul Individual nu are această funcționalitate.
{{% /notice %}}
- Click pe
Usersîn meniul din stânga. - Creează un cont nou și activează
administrator. - Autentifică-te cu noul cont administrativ.
- Șterge utilizatorul
admindin paginaUsers.
Crearea unui utilizator nou
- Click pe
Usersîn meniul din stânga. - Creează un utilizator nou.
- Selectează grupul din care să facă parte (dacă trebuie să adaugi grupuri noi, vezi secțiunea următoare).
Adăugarea unui grup nou
- Click pe
Groupsîn meniul din stânga. - Creează un grup nou.
- După creare poți permite accesul între grupuri: click
Edit. - Selectează grupurile relevante cărora vrei să le permiți acces (se adaugă automat în grupul corespunzător).
Configurarea mai multor servere relay
- Mergi la
Settingsîn meniul din stânga. - Click pe
Relaydin submenu. - Apasă
+lângăRelay Servers. - Introdu adresa DNS sau IP a serverului Relay și apasă Enter.
- Dacă ai mai multe servere Relay continuă să apeși
+și ajustează setările Geo dacă este necesar (amintește-ți să copiezi cheia către celelalte servere).
Setare sau schimbare licență
- Mergi la
Settingsîn meniul din stânga. - Click pe
Licensedin submenu. - Apasă
Editși lipește codul licenței. - Apasă
OK.
Vizualizare jurnale
În meniul din stânga click pe Logs.
Configurare emailuri
Exemplu folosind Gmail:
- Mergi la
Settingsîn meniul din stânga. - Click pe
SMTPdin submenu. - Introdu serverul SMTP
smtp.gmail.com. - În
SMTP Portintrodu 587. - În
Mail Accountpune contul Gmail, ex.myrustdeskserver@gmail.com. - Introdu parola (s-ar putea să ai nevoie de o parolă de aplicație).
- În
Frompune același cont Gmailmyrustdeskserver@gmail.com. - Click
Checkpentru a salva.
Atribuirea utilizatorilor/strategiilor/grupurilor de dispozitive prin Consola Web
Utilizatorul este contul RustDesk conectat pe dispozitiv sau atribuit dispozitivului prin click pe Edit lângă dispozitiv; click în câmpul User și alege din listă. Poți atribui în masă dispozitive unui utilizator din User List → More → Assign Devices.
Pentru a adăuga un dispozitiv într-un grup de dispozitive, click pe Edit lângă dispozitiv în Device List și modifică Group, sau mergi la lista Device Groups, click pe numele grupului și ajustează dispozitivele din acel grup.
Pentru a atribui o strategie unui dispozitiv, plasează cursorul în partea dreaptă a listei Strategy și click pe Edit Devices, Edit Users sau Edit Device Groups pentru a adăuga device-urile, dispozitivele utilizatorilor sau grupurile de dispozitive corespunzătoare strategiei selectate.
Token API
Mai întâi trebuie să mergi la Settings → Tokens → Create și să creezi un token cu permisiunile necesare: Device, Audit Log, User, Group, Strategy, Address Book.
Odată creat, poți folosi aceste token-uri din linia de comandă sau din CLI Python pentru a efectua acțiuni cu permisiunile respective.
Atribuire via token din linia de comandă
Poți folosi executabilul RustDesk cu parametrul --assign pentru a face atribuiri din linia de comandă:
Exemplu:
"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <generatedtoken> --user_name <username>
Parametri suportati
| Parameter | Descriere | RustDesk Server Pro | RustDesk Client |
|---|---|---|---|
--user_name <username> |
Atribuie un utilizator dispozitivului | ||
--strategy_name <strategyname> |
Atribuie o strategie dispozitivului | ||
--address_book_name <addressbookname> |
Atribuie dispozitivul la o agendă | ||
--address_book_tag <addressbooktag> |
Atribuire folosind tag-ul agendei | ||
--address_book_alias <alias> |
Atribuire folosind aliasul | 1.5.8 | 1.4.1 |
--address_book_password <password> |
Setează parola pentru înregistrare | 1.6.6 | 1.4.3 |
--address_book_note <note> |
Setează nota pentru înregistrare | 1.6.6 | 1.4.3 |
--device_group_name <devicegroupname> |
Atribuie dispozitiv la grup | ||
--note <note> |
Adaugă o notă dispozitivului | 1.6.6 | 1.4.3 |
--device_username <device_username> |
Setează username pentru dispozitiv | 1.6.6 | 1.4.3 |
--device_name <device_name> |
Setează numele dispozitivului | 1.6.6 | 1.4.3 |
Linia de comandă pe Windows nu afișează output implicit. Pentru a obține output rulează comanda astfel: "C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more sau "C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String (vezi discuție referință în repo).
Unelte CLI Python
Management utilizatori (users.py)
Afișează help:
./users.py -h
Vezi utilizatori:
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]
Filtre:
--name: username (căutare aproximativă)--group_name: grup utilizatori (potrivire exactă)
Exemplu:
./users.py --url https://example.com --token <token> view --group_name Default
Operații de bază:
-
Dezactivează utilizator:
./users.py --url <url> --token <token> disable --name testuser -
Activează utilizator:
./users.py --url <url> --token <token> enable --name testuser -
Șterge utilizator:
./users.py --url <url> --token <token> delete --name testuser
Creare și invitare utilizatori:
-
Creează utilizator nou:
./users.py --url <url> --token <token> new --name username --password 'password123' --group_name Default [--email user@example.com] [--note "notă"]Necesar:
--name,--password,--group_name
Opțional:--email,--note -
Invită utilizator prin email:
./users.py --url <url> --token <token> invite --email user@example.com --name username --group_name Default [--note "notă"]Necesar:
--email,--name,--group_name
Opțional:--note
Operații 2FA și securitate:
-
Activează impunere 2FA:
./users.py --url <url> --token <token> enable-2fa-enforce --name username --web-console-url <console_url>Necesar:
--web-console-url -
Dezactivează impunere 2FA:
./users.py --url <url> --token <token> disable-2fa-enforce --name username [--web-console-url <console_url>]Opțional:
--web-console-url -
Resetează 2FA:
./users.py --url <url> --token <token> reset-2fa --name username -
Dezactivează verificare email:
./users.py --url <url> --token <token> disable-email-verification --name username -
Deconectare forțată:
./users.py --url <url> --token <token> force-logout --name username
Notă:
- La operații pe mai mulți utilizatori (potriviți prin filtre), se va solicita confirmare
- Dacă nu există utilizatori potriviți, se va afișa "Found 0 users"
Management grupuri utilizatori (user_group.py)
Afișează help:
./user_group.py -h
Vezi grupuri utilizatori:
./user_group.py --url <url> --token <token> view [--name <group_name>]
Exemplu:
./user_group.py --url https://example.com --token <token> view --name "Echipa Vânzări"
Operații pe grupuri:
-
Creează grup utilizatori:
./user_group.py --url <url> --token <token> add --name "NumeGrup" [--note "descriere"] [--accessed-from '<json>'] [--access-to '<json>']Exemplu cu control acces:
./user_group.py --url <url> --token <token> add --name "Inginerie" --accessed-from '[{"type":0,"name":"Manageri"}]' --access-to '[{"type":1,"name":"Servere Dev"}]' -
Actualizează grup utilizatori:
./user_group.py --url <url> --token <token> update --name "NumeGrup" [--new-name "Nume Nou"] [--note "notă nouă"] [--accessed-from '<json>'] [--access-to '<json>'] -
Șterge grup utilizatori:
./user_group.py --url <url> --token <token> delete --name "NumeGrup"Suportă nume separate prin virgulă:
--name "Grup1,Grup2,Grup3"
Management utilizatori în grupuri:
-
Vezi utilizatori în grup:
./user_group.py --url <url> --token <token> view-users [--name <group_name>] [--user-name <username>]Filtre:
--name: nume grup (potrivire exactă, opțional)--user-name: username (căutare aproximativă, opțional)
Exemplu:
./user_group.py --url <url> --token <token> view-users --name Default --user-name john -
Adaugă utilizatori în grup:
./user_group.py --url <url> --token <token> add-users --name "NumeGrup" --users "user1,user2,user3"
Parametri control acces:
-
--accessed-from: array JSON ce definește cine poate accesa acest grup de utilizatori- Type 0 = Grup utilizatori (ex.
[{"type":0,"name":"Admins"}]) - Type 2 = Utilizator (ex.
[{"type":2,"name":"john"}])
- Type 0 = Grup utilizatori (ex.
-
--access-to: array JSON ce definește la ce poate accesa acest grup de utilizatori- Type 0 = Grup utilizatori (ex.
[{"type":0,"name":"Suport"}]) - Type 1 = Grup dispozitive (ex.
[{"type":1,"name":"Servere"}])
- Type 0 = Grup utilizatori (ex.
Notă: Folosiți ghilimele simple în jurul array-urilor JSON pentru a evita probleme de parsare shell.
Cerințe de permisiuni:
- Comenzile
view/add/update/delete/add-usersnecesită Permisiune Grup Utilizatori - Comanda
view-usersnecesită Permisiune Utilizator
Management grupuri dispozitive (device_group.py)
Afișează help:
./device_group.py -h
Vezi grupuri dispozitive:
./device_group.py --url <url> --token <token> view [--name <group_name>]
Exemplu:
./device_group.py --url https://example.com --token <token> view
Operații pe grupuri:
-
Creează grup dispozitive:
./device_group.py --url <url> --token <token> add --name "NumeGrup" [--note "descriere"] [--accessed-from '<json>']Exemplu:
./device_group.py --url <url> --token <token> add --name "Producție" --accessed-from '[{"type":0,"name":"Admins"}]' -
Actualizează grup dispozitive:
./device_group.py --url <url> --token <token> update --name "NumeGrup" [--new-name "Nume Nou"] [--note "notă nouă"] [--accessed-from '<json>'] -
Șterge grup dispozitive:
./device_group.py --url <url> --token <token> delete --name "NumeGrup"Suportă nume separate prin virgulă:
--name "Grup1,Grup2,Grup3"
Management dispozitive în grupuri:
-
Vezi dispozitive în grup:
./device_group.py --url <url> --token <token> view-devices [filtre]Filtre disponibile:
--name: nume grup dispozitive (potrivire exactă)--id: ID dispozitiv (căutare aproximativă)--device-name: nume dispozitiv (căutare aproximativă)--user-name: username/proprietar (căutare aproximativă)--device-username: username conectat pe dispozitiv (căutare aproximativă)
Exemple:
# Vezi toate dispozitivele dintr-un grup ./device_group.py --url <url> --token <token> view-devices --name Producție # Caută după nume dispozitiv ./device_group.py --url <url> --token <token> view-devices --device-name server # Combină filtre ./device_group.py --url <url> --token <token> view-devices --name Producție --user-name john -
Vezi grupuri dispozitive accesibile:
./device_group.py --url <url> --token <token> accessibleAfișează toate grupurile de dispozitive accesibile utilizatorului curent.
-
Adaugă dispozitive în grup:
./device_group.py --url <url> --token <token> add-devices --name "NumeGrup" --ids "deviceid1,deviceid2" -
Elimină dispozitive din grup:
./device_group.py --url <url> --token <token> remove-devices --name "NumeGrup" --ids "deviceid1,deviceid2"
Parametru control acces:
--accessed-from: array JSON ce definește cine poate accesa acest grup de dispozitive- Type 0 = Grup utilizatori (ex.
[{"type":0,"name":"Ingineri"}]) - Type 2 = Utilizator (ex.
[{"type":2,"name":"admin"}])
- Type 0 = Grup utilizatori (ex.
Cerințe permisiuni:
- Comenzile
view/add/update/delete/add-devices/remove-devicesnecesită Permisiune Grup Dispozitive - Comanda
view-devicesnecesită Permisiune Dispozitiv
Management dispozitive (devices.py)
Afișează help:
./devices.py -h
Vezi dispozitive:
./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>]
Filtre:
--id: ID dispozitiv
--device_name: nume dispozitiv
--user_name: utilizator atribuit
--group_name: grup utilizatori
--device_group_name: grup dispozitive
--offline_days: zile de când este offline
Exemplu:
./devices.py --url https://example.com --token <token> view --user_name mike
Operații:
view poate fi înlocuit cu enable, disable, delete, sau assign.
Exemplu (atribuie device):
./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike
Management agendă (ab.py)
Afișează help:
./ab.py -h
Vezi agende partajate:
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
Obține GUID-ul agendei personale:
./ab.py --url <url> --token <token> get-personal-ab
Adaugă o agendă partajată:
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
Actualizează sau șterge o agendă partajată:
./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>
Vezi peer-ii dintr-o agendă:
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
Adaugă/actualizează/șterge 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>
Management tag-uri:
./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>
Management reguli de acces:
./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>
Exemplu (adaugă regulă read-only pentru utilizatorul "mike"):
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
Gestionarea Strategiilor (strategies.py)
Afișați ajutor:
./strategies.py -h
Listați toate strategiile:
./strategies.py --url <url> --token <token> list
Vezi o strategie specifică:
# După nume
./strategies.py --url <url> --token <token> view --name "Default"
# După GUID
./strategies.py --url <url> --token <token> view --guid "01983006-fcca-7c12-9a91-b1df483c6073"
Activați sau dezactivați o strategie:
./strategies.py --url <url> --token <token> enable --name "NumeStrategie"
./strategies.py --url <url> --token <token> disable --name "NumeStrategie"
Atribuiți strategia dispozitivelor, utilizatorilor sau grupurilor de dispozitive:
# Atribuiți dispozitivelor (după ID dispozitiv)
./strategies.py --url <url> --token <token> assign --name "Default" --peers "1849118658,1337348840"
# Atribuiți utilizatorilor (după nume utilizator)
./strategies.py --url <url> --token <token> assign --name "Default" --users "admin,user1"
# Atribuiți grupurilor de dispozitive (după nume grup)
./strategies.py --url <url> --token <token> assign --name "Default" --device-groups "device_group1,Production"
# Atribuire mixtă
./strategies.py --url <url> --token <token> assign \
--name "Default" \
--peers "1849118658" \
--users "admin" \
--device-groups "device_group1"
Anulați atribuirea strategiei:
# Anulați de la dispozitive
./strategies.py --url <url> --token <token> unassign --peers "1849118658,1337348840"
# Anulați de la utilizatori
./strategies.py --url <url> --token <token> unassign --users "admin"
# Anulați de la grupuri de dispozitive
./strategies.py --url <url> --token <token> unassign --device-groups "device_group1"
Note:
- Scriptul acceptă atât nume cât și GUID-uri pentru utilizatori și grupuri de dispozitive
- ID-urile dispozitivelor sunt convertite automat în GUID-uri
- Toate operațiunile assign/unassign pot lucra cu mai multe ținte simultan
Cerințe de permisiuni:
- Comenzile
list/view/enable/disable/assign/unassignnecesită Permisiune Strategie --peersnecesită Permisiune Dispozitiv:r (pentru căutarea ID la GUID)--usersnecesită Permisiune Utilizator:r (pentru căutarea nume utilizator la GUID)--device-groupsnecesită Permisiune Grup Dispozitive:r (pentru căutarea nume grup la GUID)
Audits (audits.py)
Afișează help:
./audits.py -h
Vezi audituri conexiuni:
./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>]
Vezi audituri fișiere:
./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>]
Vezi audituri alarme:
./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>]
Vezi audituri consolă:
./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>]
Filtre:
--remote: Peer ID (pentru conexiuni sau audituri fișiere)
--conn-type: 0=Remote Desktop, 1=File Transfer, 2=Port Transfer, 3=View Camera, 4=Terminal
--device: ID dispozitiv (pentru audit alarme)
--operator: username operator (pentru audit consolă)
--created-at: Filtru după timp local, ex. "2025-09-16 14:15:57"
--days-ago: Filtru pentru înregistrări mai noi decât numărul de zile
--page-size / --current: Paginare
Exemplu:
./audits.py --url https://example.com --token <token> view-conn --remote 123456789 --days-ago 7
Căutarea unui dispozitiv
- Mergi la Devices.
- În câmpul Device Name tastează numele și apasă
Querysau Enter. - Pentru wildcard adaugă
%la început, sfârșit sau ambele părți ale termenului de căutare.

