diff --git a/content/self-host/rustdesk-server-pro/console/_index.de.md b/content/self-host/rustdesk-server-pro/console/_index.de.md index 55cbc18..8a0cc9a 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.de.md +++ b/content/self-host/rustdesk-server-pro/console/_index.de.md @@ -83,18 +83,185 @@ Gmail in diesem Beispiel 7. Geben Sie in `Von` Ihr Gmail-Konto ein, z. B. `myrustdeskserver@gmail.com`. 8. Klicken Sie zum Speichern auf `Check`. -## Gerätebenutzer, -gruppen und -strategien den Geräten zuweisen -Der Benutzer ist der RustDesk-Benutzer, der auf dem Gerät eingeloggt ist oder dem Gerät zugewiesen wurde, indem Sie auf `Bearbeiten` neben dem Gerät klicken. Klicken Sie auf das Feld `Benutzer` und wählen Sie Ihren Benutzer aus der Dropdown-Liste aus. Damit wird die Gruppe auf der Grundlage der Gruppe, der der Benutzer zugewiesen wurde, automatisch zugewiesen. +## Gerätebenutzer/Strategien/Gerätegruppen Geräten über die Webkonsole zuweisen -Dies kann auch über die API in der Befehlszeile bei der Bereitstellung oder später erfolgen, indem Sie die ausführbare Datei RustDesk aufrufen, gefolgt von `--assign --token --user_name `. Dazu gehen Sie zu `Einstellungen → Token → Erstellen` und erstellen ein Token mit Geräteberechtigungen. Ein Beispiel hierfür wäre unter Windows: `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +Der Benutzer ist der RustDesk-Benutzer, der auf dem Gerät angemeldet ist oder dem Gerät durch Klicken auf **Bearbeiten (Edit)** neben dem Gerät zugewiesen wurde. +Klicke in das **Benutzer (User)**-Feld und wähle deinen Benutzer aus dem Dropdown-Menü. +Du kannst auch mehrere Geräte einem Benutzer zuweisen, indem du in der **Benutzerliste (User List)** auf **Mehr → Geräte zuweisen (Assign Devices)** klickst. -Sie können die Strategie z. B. auch mit `--assign --token --strategy_name ` zuweisen. +Um ein Gerät einer Gerätegruppe hinzuzufügen, klicke in der **Geräteliste (Device List)** auf **Bearbeiten (Edit)** neben dem Gerät und ändere die **Gruppe (Group)**, oder gehe zur Liste **Gerätegruppen (Device Groups)**, klicke auf den Namen einer Gruppe und passe die darin enthaltenen Geräte an. -Sie können auch das Adressbuch auf diese Weise zuweisen, z. B. `--assign --token --address_book_name ` oder `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` erfordert RustDesk Server Pro >=1.5.8 und Client >=1.4.1. +Um eine Strategie einem Gerät zuzuweisen, bewege die Maus auf die rechte Seite der **Strategieliste (Strategy List)** und klicke im Menü auf **Geräte bearbeiten (Edit Devices)**, **Benutzer bearbeiten (Edit Users)** oder **Gerätegruppen bearbeiten (Edit Device Groups)**, um die entsprechenden Geräte, Benutzergeräte oder Gerätegruppengeräte zur ausgewählten Strategie hinzuzufügen. -Sie können auch den Geräte-Gruppennamen auf diese Weise zuweisen, z. B. `--assign --token --device_group_name `. +--- + +## API-Token + +Zuerst musst du zu **Settings → Tokens → Create** gehen und ein Token mit den erforderlichen Berechtigungen erstellen: +**Device, Audit Log, User, Group, Strategy, Address Book**. + +Nach der Erstellung kannst du diese Tokens über die **Befehlszeile (Command Line)** oder das **Python CLI** verwenden, um Aktionen mit den entsprechenden Berechtigungen auszuführen. + +### Zuweisung über Token in der Befehlszeile + +Du kannst auch die RustDesk-Programmdatei mit dem Parameter `--assign` verwenden, um Zuweisungen vorzunehmen. +Damit kannst du Benutzer, Strategien, Adressbücher oder Gerätegruppen direkt über die Befehlszeile einem Gerät zuweisen. + +**Beispiel:** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +--- + +Unterstützte Parameter + +| Parameter | Beschreibung | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | -------------------------------------------------- | ------------------- | --------------- | +| `--user_name ` | Weist dem Gerät einen Benutzer zu | | | +| `--strategy_name ` | Weist dem Gerät eine Strategie zu | | | +| `--address_book_name ` | Weist das Gerät einem Adressbuch zu | | | +| `--address_book_tag ` | Weist über Adressbuch-Tag zu | | | +| `--address_book_alias ` | Weist über Adressbuch-Alias zu | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Setzt das Passwort für den Adressbucheintrag | 1.6.6 | 1.4.3 | +| `--address_book_note ` | Fügt eine Notiz für den Adressbucheintrag hinzu | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Weist das Gerät einer Gerätegruppe zu | | | +| `--note ` | Fügt dem Gerät eine Notiz hinzu | 1.6.6 | 1.4.3 | +| `--device_username ` | Legt den Gerätenutzernamen fest | 1.6.6 | 1.4.3 | +| `--device_name ` | Legt den Gerätenamen fest | 1.6.6 | 1.4.3 | + +In der Windows-Befehlszeile wird standardmäßig keine Ausgabe angezeigt. +Um eine Ausgabe zu erhalten, führe den Befehl wie folgt aus: +`"C:\Program Files\RustDesk\rustdesk.exe" ... | more` +oder +`"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String` +(siehe [hier](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)). + +--- + +### Python CLI Verwaltungstools + +#### Benutzerverwaltung (`users.py`) + +**Hilfe anzeigen:** + ./users.py -h + +**Benutzer anzeigen:** + ./users.py --url --token view [--name ] [--group_name ] + +**Filter:** +`--name`: Benutzername +`--group_name`: Benutzergruppe + +**Beispiel:** + ./users.py --url https://example.com --token view --group_name admins + +**Operationen:** +`view` kann durch `enable`, `disable` oder `delete` ersetzt werden. + +**Beispiel (Benutzer deaktivieren):** + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Geräteverwaltung (`devices.py`) + +**Hilfe anzeigen:** + ./devices.py -h + +**Geräte anzeigen:** + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filter:** +`--id`: Geräte-ID +`--device_name`: Gerätename +`--user_name`: Zugewiesener Benutzer +`--group_name`: Benutzergruppe +`--device_group_name`: Gerätegruppe +`--offline_days`: Offline-Tage + +**Beispiel:** + ./devices.py --url https://example.com --token view --user_name mike + +**Operationen:** +`view` kann durch `enable`, `disable`, `delete` oder `assign` ersetzt werden. + +**Beispiel (Gerät zuweisen):** + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Adressbuchverwaltung (`ab.py`) + +**Hilfe anzeigen:** + ./ab.py -h + +**Freigegebene Adressbücher anzeigen:** + ./ab.py --url --token view-ab [--ab-name ] + +**Persönliche Adressbuch-GUID abrufen:** + ./ab.py --url --token get-personal-ab + +**Ein freigegebenes Adressbuch hinzufügen:** + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Ein freigegebenes Adressbuch aktualisieren oder löschen:** + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Peers in einem Adressbuch anzeigen:** + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Peer hinzufügen, aktualisieren oder löschen:** + ./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 + +**Tag-Verwaltung:** + ./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 + +**Zugriffsregelverwaltung:** + ./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 + +**Beispiel (Lesezugriff für Benutzer „mike“ hinzufügen):** + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Prüfprotokolle (`audits.py`) + +**Hilfe anzeigen:** + ./audits.py -h + +**Verbindungsprotokolle anzeigen:** + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Dateiübertragungsprotokolle anzeigen:** + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Alarmprotokolle anzeigen:** + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Konsolenprotokolle anzeigen:** + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filter:** +`--remote`: Peer-ID (für Verbindungs- oder Dateiübertragungsprotokolle) +`--conn-type`: 0=Remote Desktop, 1=Dateiübertragung, 2=Portweiterleitung, 3=Kamera anzeigen, 4=Terminal +`--device`: Geräte-ID (für Alarmprotokolle) +`--operator`: Benutzername des Operators (für Konsolenprotokolle) +`--created-at`: Zeitfilter, z. B. "2025-09-16 14:15:57" +`--days-ago`: Filtert Datensätze, die neuer als die angegebene Anzahl von Tagen sind +`--page-size` / `--current`: Seitengröße / Aktuelle Seite + +**Beispiel:** + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 -Die Befehlszeile unter Windows hat standardmäßig keine Ausgabe. Um die Ausgabe zu erhalten, führen Sie bitte `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` oder `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String` aus, siehe [hier](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). ## Suche nach einem Gerät 1. Gehen Sie zu Geräte. diff --git a/content/self-host/rustdesk-server-pro/console/_index.en.md b/content/self-host/rustdesk-server-pro/console/_index.en.md index 6e36038..c635fa2 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.en.md +++ b/content/self-host/rustdesk-server-pro/console/_index.en.md @@ -88,19 +88,177 @@ Gmail in this example 7. Enter your Gmail account i.e. `myrustdeskserver@gmail.com` in `From`. 8. Click `Check` to save. -## Assign Device Users/Groups/Strategies/DeviceGroup to Devices -The User is the RustDesk User logged in on the device or assigned to the device by clicking `Edit` next to the device, click in the `User` box and drop-down to select your user, this will auto assign the group based on the group the user as been assigned to. +## Assign Device Users/Strategies/Device Groups to Devices via Web Console -This can also be done via the API at command line on deployment or later by calling the RustDesk executable followed by `--assign --token --user_name `. You need to go to `Settings → Tokens → Create` and create a token with Device permissions first to do this. An example of this on windows would be `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +The User is the RustDesk User logged in on the device or assigned to the device by clicking **Edit** next to the device, click in the **User** box and drop-down to select your user. +You can also batch assign devices to a user by clicking **More → Assign Devices** in the **User List**. -You can also assign strategy in this way, e.g. `--assign --token --strategy_name `. +To add a device to a device group, you can click **Edit** next to the device in the **Device List** and change the **Group**, or go to the **Device Groups** list, click on a device group name, and adjust the devices within that group. -You can also assign address book in this way, e.g. `--assign --token --address_book_name ` or `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` requires RustDesk server Pro >=1.5.8 and client >=1.4.1. +To assign a strategy to a device, hover over the right side of the **Strategy** list and click **Edit Devices**, **Edit Users**, or **Edit Device Groups** in the menu to add the corresponding devices, user devices, or device group devices to the selected strategy. -You can also assign device group name in this way, e.g. `--assign --token --device_group_name `. +--- + +## API Token + +You must first go to **Settings → Tokens → Create** and create a token with the required permissions: **Device, Audit Log, User, Group, Strategy, Address Book**. + +Once created, you can use these tokens via **command line** or **Python CLI** to perform actions with the corresponding permissions. + +### Assign via Token from Command Line + +You can also perform assignments using the RustDesk executable with the `--assign` parameter. +This allows assigning users, strategies, address books, or device groups to a device directly from the command line. + +**Example:** + +```bash +"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name +``` + +Supported Parameters + +| Parameter | Description | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | --------------------------------------- | ------------------- | --------------- | ------------------- | +| `--user_name ` | Assign a user to the device | | | +| `--strategy_name ` | Assign a strategy to the device | | | +| `--address_book_name ` | Assign device to an address book | | | +| `--address_book_tag ` | Assign with address book tag | | | +| `--address_book_alias ` | Assign with address book alias | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Set password for the address book entry | 1.6.6 | 1.4.3 | +| `--address_book_note ` | Set note for the address book entry | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Assign device to a device group | | | +| `--note ` | Add note to the device | 1.6.6 | 1.4.3 | +| `--device_username ` | Set the device username | 1.6.6 | 1.4.3 | +| `--device_name ` | Set the device name | 1.6.6 | 1.4.3 | The command line on Windows does not have output by default. To get output, please run like this, `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` or `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, see [here](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +### Python CLI Management Tools + +#### Users Management (`users.py`) + +**Show help:** +`./users.py -h` + +**View users:** +`./users.py --url --token view [--name ] [--group_name ]` + +**Filters:** +`--name`: username +`--group_name`: user group + +**Example:** +`./users.py --url https://example.com --token view --group_name admins` + +**Operations:** +view can be replaced with `enable`, `disable`, or `delete`. + +**Example (disable user):** +`./users.py --url https://example.com --token disable --name testuser` + +--- + +#### Devices Management (`devices.py`) + +**Show help:** +`./devices.py -h` + +**View devices:** +`./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ]` + +**Filters:** +`--id`: device ID +`--device_name`: device name +`--user_name`: assigned user +`--group_name`: user group +`--device_group_name`: device group +`--offline_days`: days offline + +**Example:** +`./devices.py --url https://example.com --token view --user_name mike` + +**Operations:** +view can be replaced with `enable`, `disable`, `delete`, or `assign`. + +**Example (assign device):** +`./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike` + +--- + +#### Address Book Management (`ab.py`) + +**Show help:** +`./ab.py -h` + +**View shared address books:** +`./ab.py --url --token view-ab [--ab-name ]` + +**Get personal address book GUID:** +`./ab.py --url --token get-personal-ab` + +**Add a shared address book:** +`./ab.py --url --token add-ab --ab-name [--note ] [--password ]` + +**Update or delete a shared address book:** +`./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ]` +`./ab.py --url --token delete-ab --ab-guid ` + +**View peers in an address book:** +`./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ]` + +**Add, update, or delete a 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 ` + +**Tags management:** +`./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 ` + +**Access rules management:** +`./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 ` + +**Example (add read-only rule for user "mike"):** +`./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro` + +--- + +#### Audits (`audits.py`) + +**Show help:** +`./audits.py -h` + +**View connection audits:** +`./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ]` + +**View file audits:** +`./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ]` + +**View alarm audits:** +`./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ]` + +**View console audits:** +`./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ]` + +**Filters:** +`--remote`: Peer ID (for connection or file audits) +`--conn-type`: 0=Remote Desktop, 1=File Transfer, 2=Port Transfer, 3=View Camera, 4=Terminal +`--device`: Device ID (for alarm audits) +`--operator`: Operator username (for console audits) +`--created-at`: Local time filter, e.g., "2025-09-16 14:15:57" +`--days-ago`: Filter records newer than given days ago +`--page-size` / `--current`: Pagination + +**Example:** +`./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7` + + ## Searching for a device 1. Go to Devices. 2. In the Device Name Search Field type in the name and click `Query` or hit Enter. diff --git a/content/self-host/rustdesk-server-pro/console/_index.es.md b/content/self-host/rustdesk-server-pro/console/_index.es.md index d696e9e..e95ad83 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.es.md +++ b/content/self-host/rustdesk-server-pro/console/_index.es.md @@ -88,18 +88,207 @@ Gmail en este ejemplo 7. Ingrese su cuenta de Gmail, es decir, `myrustdeskserver@gmail.com` en `De`. 8. Haga clic en `Verificar` para guardar. -## Asignar Usuarios/Grupos/Estrategias/GrupoDispositivo de Dispositivo a Dispositivos -El Usuario es el Usuario de RustDesk con sesión iniciada en el dispositivo o asignado al dispositivo haciendo clic en `Editar` junto al dispositivo, haga clic en el cuadro `Usuario` y despliegue para seleccionar su usuario, esto asignará automáticamente el grupo basado en el grupo al que ha sido asignado el usuario. +## Asignar Usuarios/Estrategias/Grupos de Dispositivos a Dispositivos a través de la Consola Web -Esto también se puede hacer a través de la API en la línea de comandos durante la implementación o posteriormente llamando al ejecutable de RustDesk seguido de `--assign --token --user_name `. Necesita ir a `Configuración → Tokens → Crear` y crear un token con permisos de Dispositivo primero para hacer esto. Un ejemplo de esto en Windows sería `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +El Usuario es el usuario de RustDesk que ha iniciado sesión en el dispositivo o que se asigna al dispositivo haciendo clic en **Editar** junto al dispositivo, haciendo clic en el cuadro **Usuario** y seleccionando su usuario en el menú desplegable. +También puede asignar dispositivos en lote a un usuario haciendo clic en **Más → Asignar Dispositivos** en la **Lista de Usuarios**. -También puede asignar estrategia de esta manera, por ejemplo, `--assign --token --strategy_name `. +Para agregar un dispositivo a un grupo de dispositivos, puede hacer clic en **Editar** junto al dispositivo en la **Lista de Dispositivos** y cambiar el **Grupo**, o ir a la lista de **Grupos de Dispositivos**, hacer clic en el nombre de un grupo de dispositivos y ajustar los dispositivos dentro de ese grupo. -También puede asignar libreta de direcciones de esta manera, por ejemplo, `--assign --token --address_book_name ` o `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` requiere RustDesk Server Pro ≥1.5.8 y cliente ≥1.4.1. +Para asignar una estrategia a un dispositivo, pase el cursor sobre el lado derecho de la lista **Estrategia** y haga clic en **Editar Dispositivos**, **Editar Usuarios** o **Editar Grupos de Dispositivos** en el menú para agregar los dispositivos correspondientes, los dispositivos de usuario o los dispositivos del grupo de dispositivos a la estrategia seleccionada. -También puede asignar nombre de grupo de dispositivo de esta manera, por ejemplo, `--assign --token --device_group_name `. +--- -La línea de comandos en Windows no tiene salida por defecto. Para obtener salida, ejecute así, `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` o `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, vea [aquí](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +## Token de API + +Primero debe ir a **Configuración → Tokens → Crear** y crear un token con los permisos requeridos: **Dispositivo, Registro de Auditoría, Usuario, Grupo, Estrategia, Libreta de Direcciones**. + +Una vez creado, puede usar estos tokens a través de **línea de comandos** o **Python CLI** para realizar acciones con los permisos correspondientes. + +### Asignar mediante Token desde la Línea de Comandos + +También puede realizar asignaciones usando el ejecutable de RustDesk con el parámetro `--assign`. +Esto permite asignar usuarios, estrategias, libretas de direcciones o grupos de dispositivos a un dispositivo directamente desde la línea de comandos. + +**Ejemplo:** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +Parámetros Soportados + +| Parámetro | Descripción | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | --------------------------------------- | ----------------- | --------------- | +| `--user_name ` | Asignar un usuario al dispositivo | | | +| `--strategy_name ` | Asignar una estrategia al dispositivo | | | +| `--address_book_name ` | Asignar dispositivo a una libreta | | | +| `--address_book_tag ` | Asignar con etiqueta de libreta | | | +| `--address_book_alias ` | Asignar con alias de libreta | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Establecer contraseña para la entrada | 1.6.6 | 1.4.3 | +| `--address_book_note ` | Establecer nota para la entrada | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Asignar dispositivo a un grupo | | | +| `--note ` | Agregar nota al dispositivo | 1.6.6 | 1.4.3 | +| `--device_username ` | Establecer el nombre de usuario del dispositivo | 1.6.6 | 1.4.3 | +| `--device_name ` | Establecer el nombre del dispositivo | 1.6.6 | 1.4.3 | + +La línea de comandos en Windows no muestra salida por defecto. Para obtener salida, ejecute así: + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +ver [aquí](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). + +### Herramientas de Gestión Python CLI + +#### Gestión de Usuarios (`users.py`) + +**Mostrar ayuda:** + + ./users.py -h + +**Ver usuarios:** + + ./users.py --url --token view [--name ] [--group_name ] + +**Filtros:** + + --name: nombre de usuario + --group_name: grupo de usuarios + +**Ejemplo:** + + ./users.py --url https://example.com --token view --group_name admins + +**Operaciones:** + +`view` puede reemplazarse por `enable`, `disable`, o `delete`. + +**Ejemplo (deshabilitar usuario):** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Gestión de Dispositivos (`devices.py`) + +**Mostrar ayuda:** + + ./devices.py -h + +**Ver dispositivos:** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filtros:** + + --id: ID del dispositivo + --device_name: nombre del dispositivo + --user_name: usuario asignado + --group_name: grupo de usuarios + --device_group_name: grupo de dispositivos + --offline_days: días sin conexión + +**Ejemplo:** + + ./devices.py --url https://example.com --token view --user_name mike + +**Operaciones:** + +`view` puede reemplazarse por `enable`, `disable`, `delete`, o `assign`. + +**Ejemplo (asignar dispositivo):** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Gestión de Libretas de Direcciones (`ab.py`) + +**Mostrar ayuda:** + + ./ab.py -h + +**Ver libretas de direcciones compartidas:** + + ./ab.py --url --token view-ab [--ab-name ] + +**Obtener GUID de libreta personal:** + + ./ab.py --url --token get-personal-ab + +**Agregar una libreta compartida:** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Actualizar o eliminar una libreta compartida:** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Ver peers en una libreta:** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Agregar, actualizar o eliminar 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 + +**Gestión de etiquetas:** + + ./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 + +**Gestión de reglas de acceso:** + + ./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 + +**Ejemplo (agregar regla de solo lectura para el usuario "mike"):** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Auditorías (`audits.py`) + +**Mostrar ayuda:** + + ./audits.py -h + +**Ver auditorías de conexión:** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Ver auditorías de archivos:** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Ver auditorías de alarmas:** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Ver auditorías de consola:** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filtros:** + + --remote: ID del peer (para auditorías de conexión o archivos) + --conn-type: 0=Escritorio Remoto, 1=Transferencia de Archivos, 2=Transferencia de Puertos, 3=Ver Cámara, 4=Terminal + --device: ID del dispositivo (para auditorías de alarmas) + --operator: nombre de usuario del operador (para auditorías de consola) + --created-at: filtro de hora local, por ejemplo, "2025-09-16 14:15:57" + --days-ago: filtrar registros más recientes que los días indicados + --page-size / --current: paginación + +**Ejemplo:** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Buscar un dispositivo 1. Vaya a Dispositivos. diff --git a/content/self-host/rustdesk-server-pro/console/_index.fr.md b/content/self-host/rustdesk-server-pro/console/_index.fr.md index 30f87c2..f9a6edf 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.fr.md +++ b/content/self-host/rustdesk-server-pro/console/_index.fr.md @@ -88,18 +88,207 @@ Gmail dans cet exemple 7. Entrez votre compte Gmail c'est-à-dire `myrustdeskserver@gmail.com` dans `De`. 8. Cliquez `Vérifier` pour sauvegarder. -## Assigner des Utilisateurs/Groupes/Stratégies/GroupeAppareil aux Appareils -L'Utilisateur est l'Utilisateur RustDesk connecté sur l'appareil ou assigné à l'appareil en cliquant `Modifier` à côté de l'appareil, cliquez dans la boîte `Utilisateur` et déroulez pour sélectionner votre utilisateur, cela assignera automatiquement le groupe basé sur le groupe auquel l'utilisateur a été assigné. +## Attribution des utilisateurs/stratégies/groupes de périphériques aux périphériques via la Console Web -Ceci peut également être fait via l'API en ligne de commande lors du déploiement ou plus tard en appelant l'exécutable RustDesk suivi de `--assign --token --user_name `. Vous devez aller dans `Paramètres → Tokens → Créer` et créer un token avec les permissions Appareil d'abord pour faire ceci. Un exemple de ceci sur windows serait `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +L’Utilisateur est l’utilisateur RustDesk connecté sur le périphérique ou attribué au périphérique en cliquant sur **Modifier** à côté du périphérique, en cliquant dans la case **Utilisateur** et en sélectionnant votre utilisateur dans le menu déroulant. +Vous pouvez également attribuer des périphériques en masse à un utilisateur en cliquant sur **Plus → Attribuer des périphériques** dans la **Liste des utilisateurs**. -Vous pouvez également assigner une stratégie de cette façon, par exemple `--assign --token --strategy_name `. +Pour ajouter un périphérique à un groupe de périphériques, vous pouvez cliquer sur **Modifier** à côté du périphérique dans la **Liste des périphériques** et changer le **Groupe**, ou aller dans la liste des **Groupes de périphériques**, cliquer sur le nom d’un groupe de périphériques et ajuster les périphériques dans ce groupe. -Vous pouvez également assigner un carnet d'adresses de cette façon, par exemple `--assign --token --address_book_name ` ou `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` nécessite RustDesk server Pro ≥1.5.8 et client ≥1.4.1. +Pour attribuer une stratégie à un périphérique, survolez le côté droit de la liste **Stratégie** et cliquez sur **Modifier les périphériques**, **Modifier les utilisateurs** ou **Modifier les groupes de périphériques** dans le menu pour ajouter les périphériques correspondants, les périphériques des utilisateurs ou les périphériques du groupe de périphériques à la stratégie sélectionnée. -Vous pouvez également assigner un nom de groupe d'appareils de cette façon, par exemple `--assign --token --device_group_name `. +--- -La ligne de commande sur Windows n'a pas de sortie par défaut. Pour obtenir une sortie, veuillez exécuter comme ceci, `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` ou `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, voir [ici](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +## Jeton API + +Vous devez d’abord aller dans **Paramètres → Jetons → Créer** et créer un jeton avec les permissions requises : **Périphérique, Journal d’Audit, Utilisateur, Groupe, Stratégie, Carnet d’Adresses**. + +Une fois créé, vous pouvez utiliser ces jetons via **ligne de commande** ou **Python CLI** pour effectuer des actions avec les permissions correspondantes. + +### Attribution via Jeton depuis la Ligne de Commande + +Vous pouvez également effectuer des attributions en utilisant l’exécutable RustDesk avec le paramètre `--assign`. +Cela permet d’assigner des utilisateurs, des stratégies, des carnets d’adresses ou des groupes de périphériques à un périphérique directement depuis la ligne de commande. + +**Exemple :** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +Paramètres pris en charge + +| Paramètre | Description | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | Assigner un utilisateur au périphérique | | | +| `--strategy_name ` | Assigner une stratégie au périphérique | | | +| `--address_book_name ` | Assigner le périphérique à un carnet | | | +| `--address_book_tag ` | Assigner avec un tag du carnet | | | +| `--address_book_alias ` | Assigner avec un alias de carnet | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Définir le mot de passe de l’entrée | 1.6.6 | 1.4.3 | +| `--address_book_note ` | Définir une note pour l’entrée | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Assigner le périphérique à un groupe | | | +| `--note ` | Ajouter une note au périphérique | 1.6.6 | 1.4.3 | +| `--device_username ` | Définir le nom d’utilisateur du périphérique | 1.6.6 | 1.4.3 | +| `--device_name ` | Définir le nom du périphérique | 1.6.6 | 1.4.3 | + +La ligne de commande sous Windows ne produit pas de sortie par défaut. Pour obtenir une sortie, exécutez : + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +voir [ici](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). + +### Outils de Gestion Python CLI + +#### Gestion des Utilisateurs (`users.py`) + +**Afficher l’aide :** + + ./users.py -h + +**Voir les utilisateurs :** + + ./users.py --url --token view [--name ] [--group_name ] + +**Filtres :** + + --name : nom d’utilisateur + --group_name : groupe d’utilisateurs + +**Exemple :** + + ./users.py --url https://example.com --token view --group_name admins + +**Opérations :** + +`view` peut être remplacé par `enable`, `disable`, ou `delete`. + +**Exemple (désactiver un utilisateur) :** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Gestion des Périphériques (`devices.py`) + +**Afficher l’aide :** + + ./devices.py -h + +**Voir les périphériques :** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filtres :** + + --id : ID du périphérique + --device_name : nom du périphérique + --user_name : utilisateur assigné + --group_name : groupe d’utilisateurs + --device_group_name : groupe de périphériques + --offline_days : jours hors ligne + +**Exemple :** + + ./devices.py --url https://example.com --token view --user_name mike + +**Opérations :** + +`view` peut être remplacé par `enable`, `disable`, `delete`, ou `assign`. + +**Exemple (assigner un périphérique) :** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Gestion du Carnet d’Adresses (`ab.py`) + +**Afficher l’aide :** + + ./ab.py -h + +**Voir les carnets partagés :** + + ./ab.py --url --token view-ab [--ab-name ] + +**Obtenir le GUID du carnet personnel :** + + ./ab.py --url --token get-personal-ab + +**Ajouter un carnet partagé :** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Mettre à jour ou supprimer un carnet partagé :** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Voir les pairs dans un carnet :** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Ajouter, mettre à jour ou supprimer un pair :** + + ./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 + +**Gestion des étiquettes :** + + ./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 + +**Gestion des règles d’accès :** + + ./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 + +**Exemple (ajouter une règle en lecture seule pour l’utilisateur "mike") :** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Audits (`audits.py`) + +**Afficher l’aide :** + + ./audits.py -h + +**Voir les audits de connexion :** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Voir les audits de fichiers :** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Voir les audits d’alarme :** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Voir les audits de console :** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filtres :** + + --remote : ID du peer (pour audits de connexion ou fichiers) + --conn-type : 0=Bureau à distance, 1=Transfert de fichiers, 2=Transfert de ports, 3=Vision caméra, 4=Terminal + --device : ID du périphérique (pour audits d’alarme) + --operator : nom de l’opérateur (pour audits de console) + --created-at : filtre de temps local, ex. "2025-09-16 14:15:57" + --days-ago : filtrer les enregistrements plus récents que le nombre de jours indiqué + --page-size / --current : pagination + +**Exemple :** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Rechercher un appareil 1. Allez dans Appareils. diff --git a/content/self-host/rustdesk-server-pro/console/_index.it.md b/content/self-host/rustdesk-server-pro/console/_index.it.md index d6e0e4f..3624827 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.it.md +++ b/content/self-host/rustdesk-server-pro/console/_index.it.md @@ -88,18 +88,207 @@ Gmail in questo esempio 7. Inserisci il tuo account Gmail cioè `myrustdeskserver@gmail.com` in `Da`. 8. Clicca `Controlla` per salvare. -## Assegnare Utenti/Gruppi/Strategie/GruppoDispositivo Dispositivo ai Dispositivi -L'Utente è l'Utente RustDesk connesso al dispositivo o assegnato al dispositivo cliccando `Modifica` accanto al dispositivo, clicca nella casella `Utente` e seleziona dal menu a tendina per selezionare il tuo utente, questo assegnerà automaticamente il gruppo basato sul gruppo a cui è stato assegnato l'utente. +## Assegnazione di Utenti/Strategie/Gruppi di Dispositivi ai Dispositivi tramite Console Web -Questo può anche essere fatto tramite API a riga di comando durante la distribuzione o successivamente chiamando l'eseguibile RustDesk seguito da `--assign --token --user_name `. Devi andare su `Impostazioni → Token → Crea` e creare un token con permessi Dispositivo prima di farlo. Un esempio di questo su Windows sarebbe `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +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**. -Puoi anche assegnare strategia in questo modo, ad esempio `--assign --token --strategy_name `. +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. -Puoi anche assegnare rubrica in questo modo, ad esempio `--assign --token --address_book_name ` o `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` richiede RustDesk Server Pro ≥1.5.8 e client ≥1.4.1. +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. -Puoi anche assegnare nome gruppo dispositivo in questo modo, ad esempio `--assign --token --device_group_name `. +--- -La riga di comando su Windows non ha output per impostazione predefinita. Per ottenere output, esegui così, `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` o `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, vedi [qui](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +## 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 + --group_name : gruppo utenti + +**Esempio:** + + ./users.py --url https://example.com --token view --group_name admins + +**Operazioni:** + +`view` può essere sostituito con `enable`, `disable`, o `delete`. + +**Esempio (disabilitare utente):** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### 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 + +--- + +#### 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. diff --git a/content/self-host/rustdesk-server-pro/console/_index.ja.md b/content/self-host/rustdesk-server-pro/console/_index.ja.md index 1343318..c4cca3b 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.ja.md +++ b/content/self-host/rustdesk-server-pro/console/_index.ja.md @@ -88,18 +88,207 @@ Windowsクライアントの場合、カスタムサーバー設定を省略し 7. `送信者`にGmailアカウント（例：`myrustdeskserver@gmail.com`）を入力します。 8. `確認`をクリックして保存します。 -## デバイスユーザー/グループ/戦略/デバイスグループをデバイスに割り当て -ユーザーは、デバイスにログインしているRustDeskユーザー、またはデバイスの横の`編集`をクリックしてデバイスに割り当てられたユーザーです。`ユーザー`ボックスをクリックしてドロップダウンからユーザーを選択すると、ユーザーが割り当てられたグループに基づいてグループが自動的に割り当てられます。 +## Webコンソールを使用したデバイスへのユーザー/戦略/デバイスグループの割り当て -これは、デプロイ時または後でRustDesk実行可能ファイルに続いて`--assign --token <生成されたトークン> --user_name <ユーザー名>`を呼び出すことで、コマンドラインでAPIを介して行うこともできます。これを行うには、まず`設定 → トークン → 作成`に移動してデバイス権限を持つトークンを作成する必要があります。Windowsでの例は`"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <生成されたトークン> --user_name <新しいユーザー>`です。 +ユーザーは、デバイスにログインしているRustDeskユーザー、またはデバイスの横にある**編集**をクリックし、**ユーザー**ボックスをクリックしてドロップダウンからユーザーを選択することでデバイスに割り当てられます。 +また、**ユーザーリスト**で**その他 → デバイスを割り当て**をクリックすることで、複数のデバイスをユーザーに一括割り当てすることもできます。 -この方法で戦略を割り当てることもできます。例：`--assign --token <生成されたトークン> --strategy_name <戦略名>`。 +デバイスをデバイスグループに追加するには、**デバイスリスト**でデバイスの横にある**編集**をクリックして**グループ**を変更するか、**デバイスグループ**リストに移動してグループ名をクリックし、そのグループ内のデバイスを調整します。 -この方法でアドレス帳を割り当てることもできます。例：`--assign --token <生成されたトークン> --address_book_name <アドレス帳名>`または`--assign --token <生成されたトークン> --address_book_name <アドレス帳名> --address_book_tag <アドレス帳タグ> --address_book_alias <エイリアス>`。`--address_book_alias`にはRustDesk Server Pro ≥1.5.8とクライアント ≥1.4.1が必要です。 +デバイスに戦略を割り当てるには、**戦略**リストの右側にカーソルを合わせ、メニューから**デバイスを編集**、**ユーザーを編集**、または**デバイスグループを編集**をクリックして、選択した戦略に対応するデバイス、ユーザーデバイス、またはデバイスグループのデバイスを追加します。 -この方法でデバイスグループ名を割り当てることもできます。例：`--assign --token <生成されたトークン> --device_group_name <デバイスグループ名>`。 +--- -Windowsのコマンドラインはデフォルトで出力がありません。出力を得るには、`"C:\Program Files\RustDesk\rustdesk.exe" ... | more`または`"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`のように実行してください。[こちら](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)を参照してください。 +## APIトークン + +まず、**設定 → トークン → 作成**に移動し、必要な権限（**デバイス、監査ログ、ユーザー、グループ、戦略、アドレス帳**）を持つトークンを作成する必要があります。 + +作成後、これらのトークンを**コマンドライン**または**Python CLI**を通じて使用し、対応する権限で操作を実行できます。 + +### コマンドラインからトークンを使用して割り当て + +`--assign`パラメータを使用してRustDesk実行ファイルで割り当てを行うこともできます。 +これにより、ユーザー、戦略、アドレス帳、またはデバイスグループをコマンドラインから直接デバイスに割り当てることができます。 + +**例：** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +サポートされているパラメータ + +| パラメータ | 説明 | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | デバイスにユーザーを割り当て | | | +| `--strategy_name ` | デバイスに戦略を割り当て | | | +| `--address_book_name ` | デバイスをアドレス帳に割り当て | | | +| `--address_book_tag ` | アドレス帳タグで割り当て | | | +| `--address_book_alias ` | アドレス帳のエイリアスで割り当て | 1.5.8 | 1.4.1 | +| `--address_book_password ` | アドレス帳エントリのパスワードを設定 | 1.6.6 | 1.4.3 | +| `--address_book_note ` | アドレス帳エントリにメモを設定 | 1.6.6 | 1.4.3 | +| `--device_group_name ` | デバイスをデバイスグループに割り当て | | | +| `--note ` | デバイスにメモを追加 | 1.6.6 | 1.4.3 | +| `--device_username ` | デバイスのユーザー名を設定 | 1.6.6 | 1.4.3 | +| `--device_name ` | デバイス名を設定 | 1.6.6 | 1.4.3 | + +Windowsのコマンドラインはデフォルトでは出力を表示しません。出力を取得するには次のように実行してください： + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +詳細は[こちら](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。 + +### Python CLI管理ツール + +#### ユーザー管理 (`users.py`) + +**ヘルプ表示：** + + ./users.py -h + +**ユーザー表示：** + + ./users.py --url --token view [--name ] [--group_name ] + +**フィルター：** + + --name : ユーザー名 + --group_name : ユーザーグループ + +**例：** + + ./users.py --url https://example.com --token view --group_name admins + +**操作：** + +`view`は`enable`、`disable`、`delete`に置き換え可能です。 + +**例（ユーザーを無効化）：** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### デバイス管理 (`devices.py`) + +**ヘルプ表示：** + + ./devices.py -h + +**デバイス表示：** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**フィルター：** + + --id : デバイスID + --device_name : デバイス名 + --user_name : 割り当てユーザー + --group_name : ユーザーグループ + --device_group_name : デバイスグループ + --offline_days : オフライン日数 + +**例：** + + ./devices.py --url https://example.com --token view --user_name mike + +**操作：** + +`view`は`enable`、`disable`、`delete`、`assign`に置き換え可能です。 + +**例（デバイスを割り当てる）：** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### アドレス帳管理 (`ab.py`) + +**ヘルプ表示：** + + ./ab.py -h + +**共有アドレス帳表示：** + + ./ab.py --url --token view-ab [--ab-name ] + +**個人アドレス帳GUID取得：** + + ./ab.py --url --token get-personal-ab + +**共有アドレス帳追加：** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**共有アドレス帳の更新または削除：** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**アドレス帳内のピア表示：** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**ピアの追加、更新、削除：** + + ./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 + +**タグ管理：** + + ./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 + +**アクセスルール管理：** + + ./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 + +**例（ユーザー "mike" に読み取り専用ルールを追加）：** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### 監査 (`audits.py`) + +**ヘルプ表示：** + + ./audits.py -h + +**接続監査の表示：** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**ファイル監査の表示：** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**アラーム監査の表示：** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**コンソール監査の表示：** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**フィルター：** + + --remote : ピアID（接続またはファイル監査用） + --conn-type : 0=リモートデスクトップ, 1=ファイル転送, 2=ポート転送, 3=カメラビュー, 4=ターミナル + --device : デバイスID（アラーム監査用） + --operator : オペレーター名（コンソール監査用） + --created-at : ローカル時間フィルター、例 "2025-09-16 14:15:57" + --days-ago : 指定日数以内の新しいレコードをフィルター + --page-size / --current : ページネーション + +**例：** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## デバイスの検索 1. デバイスに移動します。 diff --git a/content/self-host/rustdesk-server-pro/console/_index.pl.md b/content/self-host/rustdesk-server-pro/console/_index.pl.md index 154fb10..94d436d 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.pl.md +++ b/content/self-host/rustdesk-server-pro/console/_index.pl.md @@ -89,18 +89,408 @@ W tym przykładzie użyto Gmaila 7. Wprowadź adres swojego konta Gmail, np. `mojserwerrustdeska@gmail.com`, w polu `Od`. 8. Kliknij `Sprawdź`, aby zapisać. -## Przypisywanie użytkowników/grup/strategii/grup urządzeń do urządzeń -Użytkownik to użytkownik RustDeska zalogowany na urządzeniu lub przypisany do niego poprzez kliknięcie `Edytuj` obok urządzenia, kliknięcie pola `Użytkownik` i wybranie użytkownika z listy rozwijanej. Spowoduje to automatyczne przypisanie grupy na podstawie grupy, do której użytkownik został przypisany. +## Przypisywanie użytkowników/strategii/grup urządzeń do urządzeń przez konsolę webową -Można to również zrobić za pomocą interfejsu API w wierszu poleceń podczas wdrażania lub później, wywołując plik wykonywalny RustDesk, a następnie poleceniem `--assign --token --user_name `. Aby to zrobić, należy przejść do `Ustawienia → Tokeny → Utwórz` i najpierw utworzyć token z uprawnieniami urządzenia. Przykładem w systemie Windows jest `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +Użytkownik to użytkownik RustDesk zalogowany na urządzeniu lub przypisany do urządzenia poprzez kliknięcie **Edytuj** obok urządzenia, kliknięcie w pole **Użytkownik** i wybranie swojego użytkownika z rozwijanego menu. +Możesz także przypisać wiele urządzeń do użytkownika, klikając **Więcej → Przypisz urządzenia** w **Liście użytkowników**. -Możesz również przypisać strategię w ten sposób, np. `--assign --token --strategy_name `. +Aby dodać urządzenie do grupy urządzeń, kliknij **Edytuj** obok urządzenia w **Liście urządzeń** i zmień **Grupę**, lub przejdź do listy **Grup urządzeń**, kliknij nazwę grupy i dostosuj urządzenia w tej grupie. -Możesz również przypisać książkę adresową w ten sposób, np. `--assign --token --address_book_name ` lub `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` wymaga serwera RustDeska Pro w wersji 1.5.8 lub nowszej i klienta w wersji 1.4.1. +Aby przypisać strategię do urządzenia, najedź kursorem na prawą stronę listy **Strategii** i kliknij w menu **Edytuj urządzenia**, **Edytuj użytkowników** lub **Edytuj grupy urządzeń**, aby dodać odpowiednie urządzenia, urządzenia użytkownika lub urządzenia grupy do wybranej strategii. -Możesz również przypisać nazwę grupy urządzeń w ten sposób, np. `--assign --token --device_group_name `. +--- -Wiersz poleceń w systemie Windows domyślnie nie wyświetla wyników. Aby uzyskać wynik, uruchom polecenie w następujący sposób: `"C:\Program Files\RustDesk\rustdesk.exe" ... | więcej` lub `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, patrz [tutaj](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +## Token API + +Najpierw przejdź do **Ustawienia → Tokeny → Utwórz** i utwórz token z wymaganymi uprawnieniami: **Urządzenie, Dziennik audytu, Użytkownik, Grupa, Strategia, Książka adresowa**. + +Po utworzeniu tokeny te można używać przez **wiersz poleceń** lub **CLI w Pythonie**, aby wykonywać akcje z odpowiadającymi uprawnieniami. + +### Przypisywanie za pomocą tokenu z wiersza poleceń + +Można również wykonywać przypisania, używając pliku wykonywalnego RustDesk z parametrem `--assign`. +Pozwala to na przypisywanie użytkowników, strategii, książek adresowych lub grup urządzeń do urządzenia bezpośrednio z wiersza poleceń. + +**Przykład:** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +Obsługiwane parametry + +| Parametr | Opis | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | Przypisz użytkownika do urządzenia | | | +| `--strategy_name ` | Przypisz strategię do urządzenia | | | +| `--address_book_name ` | Przypisz urządzenie do książki adresowej | | | +| `--address_book_tag ` | Przypisz z tagiem książki adresowej | | | +| `--address_book_alias ` | Przypisz z aliasem książki adresowej | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Ustaw hasło dla wpisu w książce adresowej| 1.6.6 | 1.4.3 | +| `--address_book_note ` | Ustaw notatkę dla wpisu w książce adresowej | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Przypisz urządzenie do grupy | | | +| `--note ` | Dodaj notatkę do urządzenia | 1.6.6 | 1.4.3 | +| `--device_username ` | Ustaw nazwę użytkownika urządzenia | 1.6.6 | 1.4.3 | +| `--device_name ` | Ustaw nazwę urządzenia | 1.6.6 | 1.4.3 | + +Wiersz poleceń w systemie Windows nie wyświetla domyślnie żadnego outputu. Aby go otrzymać, użyj: + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +zobacz [tutaj](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). + +### Narzędzia zarządzania Python CLI + +#### Zarządzanie użytkownikami (`users.py`) + +**Pokaż pomoc:** + + ./users.py -h + +**Wyświetl użytkowników:** + + ./users.py --url --token view [--name ] [--group_name ] + +**Filtry:** + + --name : nazwa użytkownika + --group_name : grupa użytkowników + +**Przykład:** + + ./users.py --url https://example.com --token view --group_name admins + +**Operacje:** + +`view` można zastąpić `enable`, `disable` lub `delete`. + +**Przykład (wyłącz użytkownika):** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Zarządzanie urządzeniami (`devices.py`) + +**Pokaż pomoc:** + + ./devices.py -h + +**Wyświetl urządzenia:** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filtry:** + + --id : ID urządzenia + --device_name : nazwa urządzenia + --user_name : przypisany użytkownik + --group_name : grupa użytkowników + --device_group_name : grupa urządzeń + --offline_days : dni offline + +**Przykład:** + + ./devices.py --url https://example.com --token view --user_name mike + +**Operacje:** + +`view` można zastąpić `enable`, `disable`, `delete` lub `assign`. + +**Przykład (przypisz urządzenie):** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Zarządzanie książką adresową (`ab.py`) + +**Pokaż pomoc:** + + ./ab.py -h + +**Wyświetl udostępnione książki adresowe:** + + ./ab.py --url --token view-ab [--ab-name ] + +**Pobierz GUID osobistej książki adresowej:** + + ./ab.py --url --token get-personal-ab + +**Dodaj udostępnioną książkę adresową:** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Aktualizuj lub usuń udostępnioną książkę adresową:** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Wyświetl peerów w książce adresowej:** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Dodaj, zaktualizuj lub usuń 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 + +**Zarządzanie tagami:** + + ./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 + +**Zarządzanie regułami dostępu:** + + ./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 + +**Przykład (dodaj regułę tylko do odczytu dla użytkownika "mike"):** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Audyty (`audits.py`) + +**Pokaż pomoc:** + + ./audits.py -h + +**Wyświetl audyt połączeń:** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt plików:** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt alarmów:** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt konsoli:** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filtry:** + + --remote : ID peer (dla audytu połączeń lub plików) + --conn-type : 0=Pulpit zdalny, 1=Transfer plików, 2=Transfer portów, 3=Podgląd kamery, 4=Terminal + --device : ID urządzenia (dla audytu alarmów) + --operator : nazwa operatora (dla audytu konsoli) + --created-at : filtr czasu lokalnego, np. "2025-09-16 14:15:57" + --days-ago : filtruje rekordy nowsze niż podana liczba dni + --page-size / --current : paginacja + +**Przykład:** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 +## Przypisywanie użytkowników/strategii/grup urządzeń do urządzeń przez konsolę webową + +Użytkownik to użytkownik RustDesk zalogowany na urządzeniu lub przypisany do urządzenia poprzez kliknięcie **Edytuj** obok urządzenia, kliknięcie w pole **Użytkownik** i wybranie swojego użytkownika z rozwijanego menu. +Możesz także przypisać wiele urządzeń do użytkownika, klikając **Więcej → Przypisz urządzenia** w **Liście użytkowników**. + +Aby dodać urządzenie do grupy urządzeń, kliknij **Edytuj** obok urządzenia w **Liście urządzeń** i zmień **Grupę**, lub przejdź do listy **Grup urządzeń**, kliknij nazwę grupy i dostosuj urządzenia w tej grupie. + +Aby przypisać strategię do urządzenia, najedź kursorem na prawą stronę listy **Strategii** i kliknij w menu **Edytuj urządzenia**, **Edytuj użytkowników** lub **Edytuj grupy urządzeń**, aby dodać odpowiednie urządzenia, urządzenia użytkownika lub urządzenia grupy do wybranej strategii. + +--- + +## Token API + +Najpierw przejdź do **Ustawienia → Tokeny → Utwórz** i utwórz token z wymaganymi uprawnieniami: **Urządzenie, Dziennik audytu, Użytkownik, Grupa, Strategia, Książka adresowa**. + +Po utworzeniu tokeny te można używać przez **wiersz poleceń** lub **CLI w Pythonie**, aby wykonywać akcje z odpowiadającymi uprawnieniami. + +### Przypisywanie za pomocą tokenu z wiersza poleceń + +Można również wykonywać przypisania, używając pliku wykonywalnego RustDesk z parametrem `--assign`. +Pozwala to na przypisywanie użytkowników, strategii, książek adresowych lub grup urządzeń do urządzenia bezpośrednio z wiersza poleceń. + +**Przykład:** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +Obsługiwane parametry + +| Parametr | Opis | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | Przypisz użytkownika do urządzenia | | | +| `--strategy_name ` | Przypisz strategię do urządzenia | | | +| `--address_book_name ` | Przypisz urządzenie do książki adresowej | | | +| `--address_book_tag ` | Przypisz z tagiem książki adresowej | | | +| `--address_book_alias ` | Przypisz z aliasem książki adresowej | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Ustaw hasło dla wpisu w książce adresowej| 1.6.6 | 1.4.3 | +| `--address_book_note ` | Ustaw notatkę dla wpisu w książce adresowej | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Przypisz urządzenie do grupy | | | +| `--note ` | Dodaj notatkę do urządzenia | 1.6.6 | 1.4.3 | +| `--device_username ` | Ustaw nazwę użytkownika urządzenia | 1.6.6 | 1.4.3 | +| `--device_name ` | Ustaw nazwę urządzenia | 1.6.6 | 1.4.3 | + +Wiersz poleceń w systemie Windows nie wyświetla domyślnie żadnego outputu. Aby go otrzymać, użyj: + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +zobacz [tutaj](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). + +### Narzędzia zarządzania Python CLI + +#### Zarządzanie użytkownikami (`users.py`) + +**Pokaż pomoc:** + + ./users.py -h + +**Wyświetl użytkowników:** + + ./users.py --url --token view [--name ] [--group_name ] + +**Filtry:** + + --name : nazwa użytkownika + --group_name : grupa użytkowników + +**Przykład:** + + ./users.py --url https://example.com --token view --group_name admins + +**Operacje:** + +`view` można zastąpić `enable`, `disable` lub `delete`. + +**Przykład (wyłącz użytkownika):** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Zarządzanie urządzeniami (`devices.py`) + +**Pokaż pomoc:** + + ./devices.py -h + +**Wyświetl urządzenia:** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filtry:** + + --id : ID urządzenia + --device_name : nazwa urządzenia + --user_name : przypisany użytkownik + --group_name : grupa użytkowników + --device_group_name : grupa urządzeń + --offline_days : dni offline + +**Przykład:** + + ./devices.py --url https://example.com --token view --user_name mike + +**Operacje:** + +`view` można zastąpić `enable`, `disable`, `delete` lub `assign`. + +**Przykład (przypisz urządzenie):** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Zarządzanie książką adresową (`ab.py`) + +**Pokaż pomoc:** + + ./ab.py -h + +**Wyświetl udostępnione książki adresowe:** + + ./ab.py --url --token view-ab [--ab-name ] + +**Pobierz GUID osobistej książki adresowej:** + + ./ab.py --url --token get-personal-ab + +**Dodaj udostępnioną książkę adresową:** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Aktualizuj lub usuń udostępnioną książkę adresową:** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Wyświetl peerów w książce adresowej:** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Dodaj, zaktualizuj lub usuń 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 + +**Zarządzanie tagami:** + + ./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 + +**Zarządzanie regułami dostępu:** + + ./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 + +**Przykład (dodaj regułę tylko do odczytu dla użytkownika "mike"):** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Audyty (`audits.py`) + +**Pokaż pomoc:** + + ./audits.py -h + +**Wyświetl audyt połączeń:** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt plików:** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt alarmów:** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Wyświetl audyt konsoli:** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filtry:** + + --remote : ID peer (dla audytu połączeń lub plików) + --conn-type : 0=Pulpit zdalny, 1=Transfer plików, 2=Transfer portów, 3=Podgląd kamery, 4=Terminal + --device : ID urządzenia (dla audytu alarmów) + --operator : nazwa operatora (dla audytu konsoli) + --created-at : filtr czasu lokalnego, np. "2025-09-16 14:15:57" + --days-ago : filtruje rekordy nowsze niż podana liczba dni + --page-size / --current : paginacja + +**Przykład:** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Wyszukiwanie urządzenia 1. Przejdź do sekcji Urządzenia. diff --git a/content/self-host/rustdesk-server-pro/console/_index.pt.md b/content/self-host/rustdesk-server-pro/console/_index.pt.md index ca359fc..4e8f0f0 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.pt.md +++ b/content/self-host/rustdesk-server-pro/console/_index.pt.md @@ -88,18 +88,207 @@ Gmail neste exemplo 7. Digite sua conta Gmail, ou seja, `myrustdeskserver@gmail.com` em `De`. 8. Clique em `Verificar` para salvar. -## Atribuir Usuários/Grupos/Estratégias/GrupoDispositivo de Dispositivo a Dispositivos -O Usuário é o Usuário RustDesk logado no dispositivo ou atribuído ao dispositivo clicando em `Editar` ao lado do dispositivo, clique na caixa `Usuário` e use o dropdown para selecionar seu usuário, isso atribuirá automaticamente o grupo baseado no grupo ao qual o usuário foi atribuído. +## Atribuindo Usuários/Estratégias/Grupos de Dispositivos a Dispositivos via Console Web -Isso também pode ser feito via API na linha de comando durante a implantação ou posteriormente chamando o executável RustDesk seguido de `--assign --token --user_name `. Você precisa ir para `Configurações → Tokens → Criar` e criar um token com permissões de Dispositivo primeiro para fazer isso. Um exemplo disso no Windows seria `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name `. +O Usuário é o usuário RustDesk conectado ao dispositivo ou atribuído ao dispositivo clicando em **Editar** ao lado do dispositivo, clicando na caixa **Usuário** e selecionando seu usuário no menu suspenso. +Você também pode atribuir dispositivos em lote a um usuário clicando em **Mais → Atribuir Dispositivos** na **Lista de Usuários**. -Você também pode atribuir estratégia dessa forma, por exemplo, `--assign --token --strategy_name `. +Para adicionar um dispositivo a um grupo de dispositivos, clique em **Editar** ao lado do dispositivo na **Lista de Dispositivos** e altere o **Grupo**, ou vá para a lista de **Grupos de Dispositivos**, clique no nome de um grupo e ajuste os dispositivos dentro desse grupo. -Você também pode atribuir caderno de endereços dessa forma, por exemplo, `--assign --token --address_book_name ` ou `--assign --token --address_book_name --address_book_tag --address_book_alias `. `--address_book_alias` requer RustDesk Server Pro ≥1.5.8 e cliente ≥1.4.1. +Para atribuir uma estratégia a um dispositivo, passe o mouse sobre o lado direito da lista de **Estratégia** e clique em **Editar Dispositivos**, **Editar Usuários** ou **Editar Grupos de Dispositivos** no menu para adicionar os dispositivos correspondentes, dispositivos do usuário ou dispositivos do grupo selecionado à estratégia. -Você também pode atribuir nome de grupo de dispositivo dessa forma, por exemplo, `--assign --token --device_group_name `. +--- -A linha de comando no Windows não tem saída por padrão. Para obter saída, execute assim, `"C:\Program Files\RustDesk\rustdesk.exe" ... | more` ou `"C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String`, veja [aqui](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). +## Token de API + +Primeiro, você deve ir em **Configurações → Tokens → Criar** e criar um token com as permissões necessárias: **Dispositivo, Registro de Auditoria, Usuário, Grupo, Estratégia, Livro de Endereços**. + +Depois de criado, você pode usar esses tokens via **linha de comando** ou **CLI Python** para executar ações com as permissões correspondentes. + +### Atribuição via Token pelo Linha de Comando + +Você também pode realizar atribuições usando o executável RustDesk com o parâmetro `--assign`. +Isso permite atribuir usuários, estratégias, livros de endereços ou grupos de dispositivos a um dispositivo diretamente da linha de comando. + +**Exemplo:** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +Parâmetros suportados + +| Parâmetro | Descrição | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | Atribui um usuário ao dispositivo | | | +| `--strategy_name ` | Atribui uma estratégia ao dispositivo | | | +| `--address_book_name ` | Atribui o dispositivo a um livro de endereços | | | +| `--address_book_tag ` | Atribui com tag do livro de endereços | | | +| `--address_book_alias ` | Atribui com alias do livro de endereços | 1.5.8 | 1.4.1 | +| `--address_book_password ` | Define a senha da entrada do livro | 1.6.6 | 1.4.3 | +| `--address_book_note ` | Define nota para a entrada do livro | 1.6.6 | 1.4.3 | +| `--device_group_name ` | Atribui o dispositivo a um grupo | | | +| `--note ` | Adiciona nota ao dispositivo | 1.6.6 | 1.4.3 | +| `--device_username ` | Define o nome de usuário do dispositivo | 1.6.6 | 1.4.3 | +| `--device_name ` | Define o nome do dispositivo | 1.6.6 | 1.4.3 | + +A linha de comando no Windows não produz saída por padrão. Para obter saída, execute: + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +veja [aqui](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). + +### Ferramentas de Gerenciamento Python CLI + +#### Gerenciamento de Usuários (`users.py`) + +**Mostrar ajuda:** + + ./users.py -h + +**Visualizar usuários:** + + ./users.py --url --token view [--name ] [--group_name ] + +**Filtros:** + + --name : nome do usuário + --group_name : grupo de usuários + +**Exemplo:** + + ./users.py --url https://example.com --token view --group_name admins + +**Operações:** + +`view` pode ser substituído por `enable`, `disable` ou `delete`. + +**Exemplo (desativar usuário):** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### Gerenciamento de Dispositivos (`devices.py`) + +**Mostrar ajuda:** + + ./devices.py -h + +**Visualizar dispositivos:** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**Filtros:** + + --id : ID do dispositivo + --device_name : nome do dispositivo + --user_name : usuário atribuído + --group_name : grupo de usuários + --device_group_name : grupo de dispositivos + --offline_days : dias offline + +**Exemplo:** + + ./devices.py --url https://example.com --token view --user_name mike + +**Operações:** + +`view` pode ser substituído por `enable`, `disable`, `delete` ou `assign`. + +**Exemplo (atribuir dispositivo):** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### Gerenciamento de Livro de Endereços (`ab.py`) + +**Mostrar ajuda:** + + ./ab.py -h + +**Visualizar livros de endereços compartilhados:** + + ./ab.py --url --token view-ab [--ab-name ] + +**Obter GUID do livro de endereços pessoal:** + + ./ab.py --url --token get-personal-ab + +**Adicionar livro de endereços compartilhado:** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**Atualizar ou deletar livro de endereços compartilhado:** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**Visualizar peers em um livro de endereços:** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**Adicionar, atualizar ou deletar um 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 + +**Gerenciamento de tags:** + + ./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 + +**Gerenciamento de regras de acesso:** + + ./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 + +**Exemplo (adicionar regra somente leitura para usuário "mike"):** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### Auditorias (`audits.py`) + +**Mostrar ajuda:** + + ./audits.py -h + +**Visualizar auditoria de conexões:** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Visualizar auditoria de arquivos:** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Visualizar auditoria de alarmes:** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Visualizar auditoria de console:** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**Filtros:** + + --remote : ID do peer (para auditoria de conexão ou arquivos) + --conn-type : 0=Desktop Remoto, 1=Transferência de Arquivos, 2=Transferência de Portas, 3=Visualizar Câmera, 4=Terminal + --device : ID do dispositivo (para auditoria de alarmes) + --operator : nome do operador (para auditoria de console) + --created-at : filtro de horário local, ex: "2025-09-16 14:15:57" + --days-ago : filtra registros mais recentes do que n dias atrás + --page-size / --current : paginação + +**Exemplo:** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Procurando por um dispositivo 1. Vá para Dispositivos. diff --git a/content/self-host/rustdesk-server-pro/console/_index.zh-cn.md b/content/self-host/rustdesk-server-pro/console/_index.zh-cn.md index af01975..9f95abf 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.zh-cn.md +++ b/content/self-host/rustdesk-server-pro/console/_index.zh-cn.md @@ -88,18 +88,211 @@ weight: 10 7. 在 `发件人` 中输入您的 Gmail 账户，例如 `myrustdeskserver@gmail.com`。 8. 点击 `检查` 保存。 -## 将设备用户/组/策略/设备组分配给设备 -用户是登录在设备上的 RustDesk 用户，或通过点击设备旁边的 `编辑` 分配给设备的用户，点击 `用户` 框并从下拉菜单中选择您的用户，这将根据用户被分配到的组自动分配组。 +## 通过 Web Console 分配设备用户 / 策略 / 设备组 -这也可以通过 API 在部署时或之后在命令行中完成，调用 RustDesk 可执行文件后跟 `--assign --token <生成的令牌> --user_name <用户名>`。您需要先进入 `设置 → 令牌 → 创建` 并创建具有设备权限的令牌。在 Windows 上的示例为 `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <生成的令牌> --user_name <新用户>`。 +**用户 (User)** 指的是在设备上登录的 RustDesk 用户，或在 **设备列表** 中点击设备旁边的 **Edit（编辑）**，然后在 **User（用户）** 框中下拉选择要分配的用户。 +你也可以在 **用户列表 (User List)** 中点击 **More → Assign Devices** 来批量分配设备给某个用户。 -您也可以通过这种方式分配策略，例如 `--assign --token <生成的令牌> --strategy_name <策略名称>`。 +要将设备添加到某个设备组，可以在 **设备列表 (Device List)** 中点击设备旁的 **Edit（编辑）** 并更改 **Group（组）**， +或者进入 **设备组列表 (Device Groups)**，点击某个设备组名称，在该组中调整包含的设备。 -您也可以通过这种方式分配通讯录，例如 `--assign --token <生成的令牌> --address_book_name <通讯录名称>` 或 `--assign --token <生成的令牌> --address_book_name <通讯录名称> --address_book_tag <通讯录标签> --address_book_alias <别名>`。`--address_book_alias` 需要 RustDesk 服务器专业版 >=1.5.8 和客户端 >=1.4.1。 +要为设备分配策略，可以将鼠标悬停在 **策略列表 (Strategy List)** 的右侧，点击菜单中的 **Edit Devices（编辑设备）**、**Edit Users（编辑用户）** 或 **Edit Device Groups（编辑设备组）**， +以添加对应的设备、用户设备或设备组设备到所选策略中。 -您也可以通过这种方式分配设备组名称，例如 `--assign --token <生成的令牌> --device_group_name <设备组名称>`。 +--- + +## API 令牌（Token） + +首先，请前往 **Settings → Tokens → Create** 创建一个具有所需权限的令牌，所需权限包括： +**Device, Audit Log, User, Group, Strategy, Address Book**。 + +创建完成后，可以通过 **命令行 (Command Line)** 或 **Python CLI** 使用这些令牌执行相应权限的操作。 + +### 使用命令行令牌分配 + +你也可以使用 RustDesk 可执行文件并带上 `--assign` 参数来执行分配操作。 +这可以让你在命令行中直接将用户、策略、地址簿或设备组分配给设备。 + +**示例：** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +**支持的参数：** + +| 参数名 | 说明 | RustDesk Server Pro | RustDesk Client | +| ------- | ---- | ------------------- | ---------------- | +| `--user_name ` | 为设备分配用户 | | | +| `--strategy_name ` | 为设备分配策略 | | | +| `--address_book_name ` | 将设备分配到地址簿 | | | +| `--address_book_tag ` | 按标签分配地址簿 | | | +| `--address_book_alias ` | 设置地址簿别名 | 1.5.8 | 1.4.1 | +| `--address_book_password ` | 为地址簿条目设置密码 | 1.6.6 | 1.4.3 | +| `--address_book_note ` | 为地址簿条目添加备注 | 1.6.6 | 1.4.3 | +| `--device_group_name ` | 将设备分配到设备组 | | | +| `--note ` | 为设备添加备注 | 1.6.6 | 1.4.3 | +| `--device_username ` | 设置设备用户名 | 1.6.6 | 1.4.3 | +| `--device_name ` | 设置设备名称 | 1.6.6 | 1.4.3 | + +Windows 命令行默认无输出，如需查看输出，可使用如下方式运行： + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + +或 + + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +详情参考：RustDesk 讨论区相关评论链接（原文处有链接）。 + +--- + +### Python CLI 管理工具 + +#### 用户管理 （users.py） + +**查看帮助：** + + ./users.py -h + +**查看用户：** + + ./users.py --url --token view [--name ] [--group_name ] + +**过滤条件：** +`--name`：用户名 +`--group_name`：用户组名 + +**示例：** + + ./users.py --url https://example.com --token view --group_name admins + +**操作命令：** +`view` 可替换为 `enable`（启用）、`disable`（禁用）或 `delete`（删除）。 + +**示例（禁用用户）：** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### 设备管理 （devices.py） + +**查看帮助：** + + ./devices.py -h + +**查看设备：** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**过滤条件：** +`--id`：设备 ID +`--device_name`：设备名称 +`--user_name`：分配的用户 +`--group_name`：用户组 +`--device_group_name`：设备组 +`--offline_days`：离线天数 + +**示例：** + + ./devices.py --url https://example.com --token view --user_name mike + +**操作命令：** +`view` 可替换为 `enable`（启用）、`disable`（禁用）、`delete`（删除）或 `assign`（分配）。 + +**示例（分配设备）：** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### 地址簿管理 （ab.py） + +**查看帮助：** + + ./ab.py -h + +**查看共享地址簿：** + + ./ab.py --url --token view-ab [--ab-name ] + +**获取个人地址簿 GUID：** + + ./ab.py --url --token get-personal-ab + +**添加共享地址簿：** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**更新或删除共享地址簿：** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**查看地址簿中的设备（peer）：** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**添加、更新或删除设备（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 + +**标签管理：** + + ./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 + +**访问规则管理：** + + ./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 + +**示例（为用户 mike 添加只读权限）：** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### 审计日志 （audits.py） + +**查看帮助：** + + ./audits.py -h + +**查看连接审计：** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看文件审计：** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看告警审计：** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看控制台操作审计：** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**过滤条件：** +`--remote`：对端 ID（用于连接或文件审计） +`--conn-type`：连接类型（0=远程桌面，1=文件传输，2=端口转发，3=查看摄像头，4=终端） +`--device`：设备 ID（用于告警审计） +`--operator`：操作员用户名（用于控制台审计） +`--created-at`：本地时间过滤，如 `"2025-09-16 14:15:57"` +`--days-ago`：筛选指定天数内的记录 +`--page-size` / `--current`：分页参数 + +**示例：** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 -Windows 上的命令行默认没有输出。要获得输出，请这样运行：`"C:\Program Files\RustDesk\rustdesk.exe" <参数1> <参数2> ... | more` 或 `"C:\Program Files\RustDesk\rustdesk.exe" <参数1> <参数2> ... | Out-String`，参见[这里](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。 ## 搜索设备 1. 进入设备页面。 diff --git a/content/self-host/rustdesk-server-pro/console/_index.zh-tw.md b/content/self-host/rustdesk-server-pro/console/_index.zh-tw.md index 2b0742f..fd46d5e 100644 --- a/content/self-host/rustdesk-server-pro/console/_index.zh-tw.md +++ b/content/self-host/rustdesk-server-pro/console/_index.zh-tw.md @@ -88,18 +88,207 @@ weight: 10 7. 在 `寄件者` 中輸入您的 Gmail 帳號，例如 `myrustdeskserver@gmail.com`。 8. 點選 `檢查` 儲存。 -## 將裝置使用者/群組/策略/裝置群組指派給裝置 -使用者是登入在裝置上的 RustDesk 使用者，或透過點選裝置旁邊的 `編輯` 指派給裝置的使用者，點選 `使用者` 方塊並從下拉式選單中選擇您的使用者，這將根據使用者被指派到的群組自動指派群組。 +## 透過 Web 控制台分配設備使用者/策略/設備群組 -這也可以透過 API 在部署時或之後在命令列中完成，呼叫 RustDesk 執行檔後接 `--assign --token <產生的權杖> --user_name <使用者名稱>`。您需要先進入 `設定 → 權杖 → 建立` 並建立具有裝置權限的權杖。在 Windows 上的範例為 `"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <產生的權杖> --user_name <新使用者>`。 +使用者是已登入該設備的 RustDesk 使用者，或可透過點擊設備旁的 **編輯**，在 **使用者** 欄位中從下拉選單選擇使用者來分配。 +也可以透過在 **使用者列表** 點擊 **更多 → 分配設備**，批次將設備分配給使用者。 -您也可以透過這種方式指派策略，例如 `--assign --token <產生的權杖> --strategy_name <策略名稱>`。 +若要將設備加入設備群組，可在 **設備列表** 中點擊設備旁的 **編輯**，修改 **群組**，或前往 **設備群組** 列表，點擊群組名稱並調整該群組內的設備。 -您也可以透過這種方式指派通訊錄，例如 `--assign --token <產生的權杖> --address_book_name <通訊錄名稱>` 或 `--assign --token <產生的權杖> --address_book_name <通訊錄名稱> --address_book_tag <通訊錄標籤> --address_book_alias <別名>`。`--address_book_alias` 需要 RustDesk 伺服器專業版 >=1.5.8 和客戶端 >=1.4.1。 +若要將策略分配給設備，將滑鼠移至 **策略** 列表右側，並在選單中點擊 **編輯設備**、**編輯使用者** 或 **編輯設備群組**，將對應的設備、使用者設備或群組設備加入所選策略。 -您也可以透過這種方式指派裝置群組名稱，例如 `--assign --token <產生的權杖> --device_group_name <裝置群組名稱>`。 +--- -Windows 上的命令列預設沒有輸出。要取得輸出，請這樣執行：`"C:\Program Files\RustDesk\rustdesk.exe" <參數1> <參數2> ... | more` 或 `"C:\Program Files\RustDesk\rustdesk.exe" <參數1> <參數2> ... | Out-String`，參見[這裡](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。 +## API Token + +首先，需前往 **設定 → Token → 建立**，並建立擁有所需權限的權杖：**設備、審計日誌、使用者、群組、策略、通訊錄**。 + +建立後，可透過 **命令列** 或 **Python CLI** 使用這些權杖，執行擁有相應權限的操作。 + +### 透過命令列使用Token分配 + +也可以使用 RustDesk 可執行檔搭配 `--assign` 參數進行分配。 +這可直接透過命令列將使用者、策略、通訊錄或設備群組分配給設備。 + +**範例：** + + "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name + +支援參數 + +| 參數 | 說明 | RustDesk Server Pro | RustDesk Client | +| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | +| `--user_name ` | 將使用者分配給設備 | | | +| `--strategy_name ` | 將策略分配給設備 | | | +| `--address_book_name ` | 將設備分配給通訊錄 | | | +| `--address_book_tag ` | 使用通訊錄標籤進行分配 | | | +| `--address_book_alias ` | 使用通訊錄別名進行分配 | 1.5.8 | 1.4.1 | +| `--address_book_password ` | 設定通訊錄條目的密碼 | 1.6.6 | 1.4.3 | +| `--address_book_note ` | 設定通訊錄條目的備註 | 1.6.6 | 1.4.3 | +| `--device_group_name ` | 將設備分配到設備群組 | | | +| `--note ` | 為設備添加備註 | 1.6.6 | 1.4.3 | +| `--device_username ` | 設定設備使用者名稱 | 1.6.6 | 1.4.3 | +| `--device_name ` | 設定設備名稱 | 1.6.6 | 1.4.3 | + +Windows 命令列預設不會輸出結果。若要查看輸出，可使用： + + "C:\Program Files\RustDesk\rustdesk.exe" ... | more + "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String + +詳情參考 [這裡](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。 + +### Python CLI 管理工具 + +#### 使用者管理 (`users.py`) + +**顯示幫助：** + + ./users.py -h + +**查看使用者：** + + ./users.py --url --token view [--name ] [--group_name ] + +**篩選條件：** + + --name : 使用者名稱 + --group_name : 使用者群組 + +**範例：** + + ./users.py --url https://example.com --token view --group_name admins + +**操作：** + +`view` 可替換為 `enable`、`disable` 或 `delete`。 + +**範例（停用使用者）：** + + ./users.py --url https://example.com --token disable --name testuser + +--- + +#### 設備管理 (`devices.py`) + +**顯示幫助：** + + ./devices.py -h + +**查看設備：** + + ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] + +**篩選條件：** + + --id : 設備 ID + --device_name : 設備名稱 + --user_name : 分配的使用者 + --group_name : 使用者群組 + --device_group_name : 設備群組 + --offline_days : 離線天數 + +**範例：** + + ./devices.py --url https://example.com --token view --user_name mike + +**操作：** + +`view` 可替換為 `enable`、`disable`、`delete` 或 `assign`。 + +**範例（分配設備）：** + + ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike + +--- + +#### 通訊錄管理 (`ab.py`) + +**顯示幫助：** + + ./ab.py -h + +**查看共享通訊錄：** + + ./ab.py --url --token view-ab [--ab-name ] + +**取得個人通訊錄 GUID：** + + ./ab.py --url --token get-personal-ab + +**新增共享通訊錄：** + + ./ab.py --url --token add-ab --ab-name [--note ] [--password ] + +**更新或刪除共享通訊錄：** + + ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] + ./ab.py --url --token delete-ab --ab-guid + +**查看通訊錄中的 peer：** + + ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] + +**新增、更新或刪除 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 + +**標籤管理：** + + ./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 + +**存取規則管理：** + + ./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 + +**範例（為使用者 "mike" 新增唯讀規則）：** + + ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro + +--- + +#### 稽核 (`audits.py`) + +**顯示幫助：** + + ./audits.py -h + +**查看連線稽核：** + + ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看檔案稽核：** + + ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看警示稽核：** + + ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**查看控制台稽核：** + + ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] + +**篩選條件：** + + --remote : peer ID（連線或檔案稽核用） + --conn-type : 0=遠端桌面, 1=檔案傳輸, 2=端口傳輸, 3=觀看攝影機, 4=終端機 + --device : 設備 ID（警示稽核用） + --operator : 操作者使用者名稱（控制台稽核用） + --created-at : 本地時間篩選，例如 "2025-09-16 14:15:57" + --days-ago : 篩選 n 天內的紀錄 + --page-size / --current : 分頁 + +**範例：** + + ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## 搜尋裝置 1. 進入裝置頁面。