Merge pull request #564 from 21pages/command_line_and_python_cli_doc

preset options, command line and python cli doc
This commit is contained in:
RustDesk 2025-10-20 08:47:15 +08:00 committed by GitHub
commit d7d5a95804
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
20 changed files with 2243 additions and 124 deletions

View File

@ -1015,9 +1015,9 @@ Die Option „trackpad-speed“ in den Einstellungen jedes Peers steuert dann di
## Sonstiges
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Voreingestellter Adressbuchname und -tag, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Voreingestellter Adressbuchname, Geräte-Tag, Geräte-Alias, Geräte-Passwort, Geräte-Notiz, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Sie können nur preset-address-book-name setzen, wenn Sie keinen Tag setzen möchten.
Bitte verwenden Sie gültige Adressbuchnamen und -tags auf Ihrer Adressbuchseite der Web-Konsole.
@ -1025,6 +1025,11 @@ Bitte verwenden Sie gültige Adressbuchnamen und -tags auf Ihrer Adressbuchseite
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<Adressbuchname>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<Adressbuch-Tag-Name>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<Geräte-Alias>` |
| preset-address-book-password | N | | | `preset-address-book-password=<Geräte-Passwort>` |
| preset-address-book-note | N | | | `preset-address-book-note=<Geräte-Notiz>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note sind verfügbar in RustDesk-Client >=1.4.3, Pro >= 1.6.6.
### disable-group-panel
@ -1175,14 +1180,16 @@ Steuert, ob nur TCP verwendet wird. Es wird UDP 21116 nicht mehr verwenden, stat
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Weisen Sie Benutzer / Strategie / Gerätegruppe dem Gerät zu. Sie können dies auch über die [Befehlszeile](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices) tun.
Weisen Sie Benutzer / Strategie / Gerätegruppe / Geräte-Benutzername / Geräte-Name(Hostname) / Notiz dem Gerät zu. Sie können dies auch über die [Befehlszeile](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices) tun.
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
Gerätegruppe ist verfügbar in RustDesk-Client >=1.3.8, Pro >= 1.5.0
preset-device-username, preset-device-name, preset-note sind verfügbar in RustDesk-Client >=1.4.3, Pro >= 1.6.6.
### default-connect-password
Sie verwenden das `Standard-Verbindungspasswort`, um Verbindungen zu Remote-Geräten herzustellen. Dieses Passwort wird auf der Steuerungsseite konfiguriert und sollte nicht mit einem [voreingestellten Passwort](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) verwechselt werden, das auf dem gesteuerten (nur eingehenden) Client zu finden ist.
@ -1309,7 +1316,7 @@ Das Gerät nicht registrieren, Sie werden es nicht auf der Geräteseite in der W
Wenn `register-device=N`, funktioniert das Folgende nicht für dieses Gerät.
- Anmelden
- `--assign`-Befehl
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Audit-Logs
- Strategie

View File

@ -1027,9 +1027,9 @@ The "trackpad-speed" option in each peer's settings will then control the fps if
## Others
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Preset address book name and tag, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Preset address book name, device tag, device alias, device password, device note, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
You can set preset-address-book-name only if you do not want to set tag.
Please use valid address book name and tag on your address book page of web console.
@ -1037,6 +1037,11 @@ Please use valid address book name and tag on your address book page of web cons
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<address book name>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<address book tag name>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<device alias>` |
| preset-address-book-password | N | | | `preset-address-book-password=<device password>` |
| preset-address-book-note | N | | | `preset-address-book-note=<device note>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note are available in RustDesk client >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1187,14 +1192,16 @@ Controls whether to use TCP only. It will not use UDP 21116 any more, TCP 21116
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Assign user / strategy / device group to device. You can also do this via [command line](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Assign user / strategy / device group / device username / device-name(hostname) / note to device. You can also do this via [command line](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
device group is available in RustDesk client >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note are available in RustDesk client >=1.4.3, pro >= 1.6.6.
### default-connect-password
You use the `default connection password` to establish connections to remote devices. This password is configured on the controlling side and should not be confused with any [preset password](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) found on the controlled (incoming-only) client.
@ -1322,7 +1329,7 @@ Do not register the device, you will not see it in the devices page on web conso
If `register-device=N`, below will not work for this device.
- Log in
- `--assign` command
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Audit Logs
- Strategy

View File

@ -1015,9 +1015,9 @@ La opción "trackpad-speed" en la configuración de cada par controlará los fps
## Otros
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Nombre y etiqueta de libreta de direcciones preestablecidos, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Nombre de libreta de direcciones, etiqueta de dispositivo, alias de dispositivo, contraseña de dispositivo, nota de dispositivo preestablecidos, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Puedes establecer preset-address-book-name solamente si no quieres establecer etiqueta.
Por favor usa un nombre y etiqueta de libreta de direcciones válidos en tu página de libreta de direcciones de consola web.
@ -1025,6 +1025,11 @@ Por favor usa un nombre y etiqueta de libreta de direcciones válidos en tu pág
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<nombre de libreta de direcciones>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<nombre de etiqueta de libreta de direcciones>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<alias de dispositivo>` |
| preset-address-book-password | N | | | `preset-address-book-password=<contraseña de dispositivo>` |
| preset-address-book-note | N | | | `preset-address-book-note=<nota de dispositivo>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note están disponibles en cliente RustDesk >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1175,14 +1180,16 @@ Controla si usar solo TCP. No usará más UDP 21116, TCP 21116 se usará en su l
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Asigna usuario / estrategia / grupo de dispositivo a dispositivo. También puedes hacer esto vía [línea de comandos](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Asigna usuario / estrategia / grupo de dispositivo / nombre de usuario de dispositivo / nombre de dispositivo(hostname) / nota a dispositivo. También puedes hacer esto vía [línea de comandos](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
grupo de dispositivo está disponible en cliente RustDesk >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note están disponibles en cliente RustDesk >=1.4.3, pro >= 1.6.6.
### default-connect-password
Usas la `contraseña de conexión predeterminada` para establecer conexiones a dispositivos remotos. Esta contraseña se configura en el lado de control y no debe confundirse con ninguna [contraseña preestablecida](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) encontrada en el cliente controlado (solo entrante).
@ -1309,7 +1316,7 @@ No registrar el dispositivo, no lo verás en la página de dispositivos en conso
Si `register-device=N`, lo siguiente no funcionará para este dispositivo.
- Iniciar sesión
- Comando `--assign`
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Registros de auditoría
- Estrategia

View File

@ -1015,9 +1015,9 @@ L'option "trackpad-speed" dans les paramètres de chaque pair contrôlera alors
## Autres
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Nom et tag de carnet d'adresses prédéfinis, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Nom de carnet d'adresses, tag d'appareil, alias d'appareil, mot de passe d'appareil, note d'appareil prédéfinis, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Vous pouvez définir preset-address-book-name uniquement si vous ne voulez pas définir de tag.
Veuillez utiliser un nom et un tag de carnet d'adresses valides sur votre page de carnet d'adresses de la console web.
@ -1025,6 +1025,11 @@ Veuillez utiliser un nom et un tag de carnet d'adresses valides sur votre page d
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<nom du carnet d'adresses>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<nom du tag du carnet d'adresses>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<alias d'appareil>` |
| preset-address-book-password | N | | | `preset-address-book-password=<mot de passe d'appareil>` |
| preset-address-book-note | N | | | `preset-address-book-note=<note d'appareil>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note sont disponibles dans le client RustDesk >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1175,14 +1180,16 @@ Contrôle s'il faut utiliser TCP uniquement. Il n'utilisera plus UDP 21116, TCP
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Assigne utilisateur / stratégie / groupe d'appareils à l'appareil. Vous pouvez aussi faire cela via [ligne de commande](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Assigne utilisateur / stratégie / groupe d'appareils / nom d'utilisateur d'appareil / nom d'appareil(hostname) / note à l'appareil. Vous pouvez aussi faire cela via [ligne de commande](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
le groupe d'appareils est disponible dans le client RustDesk >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note sont disponibles dans le client RustDesk >=1.4.3, pro >= 1.6.6.
### default-connect-password
Vous utilisez le `mot de passe de connexion par défaut` pour établir des connexions aux appareils distants. Ce mot de passe est configuré du côté contrôleur et ne doit pas être confondu avec un [mot de passe prédéfini](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) trouvé sur le client contrôlé (entrant uniquement).
@ -1309,7 +1316,7 @@ Ne pas enregistrer l'appareil, vous ne le verrez pas dans la page des appareils
Si `register-device=N`, les éléments suivants ne fonctionneront pas pour cet appareil.
- Connexion
- Commande `--assign`
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Journaux d'audit
- Stratégie

View File

@ -1015,9 +1015,9 @@ L'opzione "trackpad-speed" nelle impostazioni di ogni peer controllerà quindi g
## Altri
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Nome e tag rubrica preimpostati, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Nome rubrica, tag dispositivo, alias dispositivo, password dispositivo, nota dispositivo preimpostati, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Puoi impostare preset-address-book-name solo se non vuoi impostare il tag.
Usa un nome e tag rubrica validi nella tua pagina rubrica della console web.
@ -1025,6 +1025,11 @@ Usa un nome e tag rubrica validi nella tua pagina rubrica della console web.
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<nome rubrica>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<nome tag rubrica>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<alias dispositivo>` |
| preset-address-book-password | N | | | `preset-address-book-password=<password dispositivo>` |
| preset-address-book-note | N | | | `preset-address-book-note=<nota dispositivo>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note sono disponibili nel client RustDesk >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1175,14 +1180,16 @@ Controlla se usare solo TCP. Non userà più UDP 21116, TCP 21116 sarà usato in
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Assegna utente / strategia / gruppo dispositivo al dispositivo. Puoi anche farlo tramite [riga di comando](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Assegna utente / strategia / gruppo dispositivo / nome utente dispositivo / nome dispositivo(hostname) / nota al dispositivo. Puoi anche farlo tramite [riga di comando](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
gruppo dispositivo è disponibile nel client RustDesk >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note sono disponibili nel client RustDesk >=1.4.3, pro >= 1.6.6.
### default-connect-password
Usi la `password di connessione predefinita` per stabilire connessioni ai dispositivi remoti. Questa password è configurata sul lato di controllo e non deve essere confusa con alcuna [password preimpostata](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) trovata sul client controllato (solo in ingresso).
@ -1309,7 +1316,7 @@ Non registrare il dispositivo, non lo vedrai nella pagina dispositivi sulla cons
Se `register-device=N`, quanto segue non funzionerà per questo dispositivo.
- Login
- Comando `--assign`
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Log di audit
- Strategia

View File

@ -1026,9 +1026,9 @@ RustDesk 1.4.1, RustDesk Server Pro 1.6.2から利用可能
## その他
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
プリセットアドレスブック名とタグ、https://github.com/rustdesk/rustdesk-server-pro/issues/257。
プリセットアドレスブック名、デバイスタグ、デバイスエイリアス、デバイスパスワード、デバイスノート、https://github.com/rustdesk/rustdesk-server-pro/issues/257。
タグを設定したくない場合は、preset-address-book-nameのみを設定できます。
Web コンソールのアドレスブックページで有効なアドレスブック名とタグを使用してください。
@ -1036,6 +1036,11 @@ Web コンソールのアドレスブックページで有効なアドレスブ
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<アドレスブック名>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<アドレスブックタグ名>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<デバイスエイリアス>` |
| preset-address-book-password | N | | | `preset-address-book-password=<デバイスパスワード>` |
| preset-address-book-note | N | | | `preset-address-book-note=<デバイスノート>` |
preset-address-book-alias、preset-address-book-password、preset-address-book-noteはRustDeskクライアント>=1.4.3、pro >= 1.6.6で利用可能。
### disable-group-panel
@ -1186,14 +1191,16 @@ TCPのみを使用するかどうかを制御します。UDP 21116は使用さ
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
ユーザー/ストラテジー/デバイスグループをデバイスに割り当てます。これは[コマンドライン](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)でも行うことができます。
ユーザー/ストラテジー/デバイスグループ/デバイスユーザー名/デバイス名(ホスト名)/ノートをデバイスに割り当てます。これは[コマンドライン](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)でも行うことができます。
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
デバイスグループはRustDeskクライアント>=1.3.8、pro >= 1.5.0で利用可能
preset-device-username、preset-device-name、preset-noteはRustDeskクライアント>=1.4.3、pro >= 1.6.6で利用可能。
### default-connect-password
リモートデバイスへの接続を確立するために`デフォルト接続パスワード`を使用します。このパスワードは制御側で設定され、被制御(受信のみ)クライアントで見つかる[プリセットパスワード](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access)と混同してはいけません。
@ -1320,7 +1327,7 @@ RustDeskクライアント>=1.4.1およびProサーバー>= 1.5.9でのみ利用
`register-device=N`の場合、このデバイスでは以下が動作しません。
- ログイン
- `--assign`コマンド
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- 監査ログ
- ストラテジー

View File

@ -1027,9 +1027,9 @@ Opcja "trackpad-speed" w ustawieniach każdego partnera będzie wtedy kontrolowa
## Inne
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Nazwa i tag wstępnie ustawionej książki adresowej, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Nazwa książki adresowej, tag urządzenia, alias urządzenia, hasło urządzenia, notatka urządzenia wstępnie ustawione, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Wartość preset-address-book-name można ustawić tylko wtedy, gdy nie chcesz ustawiać tagu.
Użyj prawidłowej nazwy książki adresowej i tagu na stronie książki adresowej konsoli webowej.
@ -1037,6 +1037,11 @@ Użyj prawidłowej nazwy książki adresowej i tagu na stronie książki adresow
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<nazwa książki adresowej>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<nazwa tagu książki adresowej>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<alias urządzenia>` |
| preset-address-book-password | N | | | `preset-address-book-password=<hasło urządzenia>` |
| preset-address-book-note | N | | | `preset-address-book-note=<notatka urządzenia>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note są dostępne w kliencie RustDesk >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1187,14 +1192,16 @@ Kontroluje, czy używać wyłącznie protokołu TCP. Nie będzie już używać p
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Przypisz użytkownika / strategię / grupę urządzeń do urządzenia. Możesz to również zrobić za pomocą [wiersza poleceń](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Przypisz użytkownika / strategię / grupę urządzeń / nazwę użytkownika urządzenia / nazwę urządzenia(hostname) / notatkę do urządzenia. Możesz to również zrobić za pomocą [wiersza poleceń](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
funkcja grup urządzeń jest dostępna w klientach RustDeska >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note są dostępne w kliencie RustDesk >=1.4.3, pro >= 1.6.6.
### default-connect-password
Używasz `domyślnego hasła połączenia`, żeby połączyć się z urządzeniami zdalnymi. Hasło to jest konfigurowane po stronie kontrolującej i nie należy go mylić z żadnym [hasłem domyślnym](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) znajdującym się na kliencie kontrolowanym (tylko przychodzącym).
@ -1321,7 +1328,7 @@ Nie rejestruj urządzenia, nie będzie ono widoczne na stronie urządzeń w kons
Jeśli `register-device=N`, poniższe nie będzie działać dla tego urządzenia.
- Logowanie się
- Polecenie `--assign`
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Dzienniki audytowe
- Strategie

View File

@ -1017,9 +1017,9 @@ A opção "trackpad-speed" nas definições de cada par irá então controlar os
## Outros
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
Nome e tag de catálogo de endereços predefinidos, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Nome do catálogo de endereços, tag do dispositivo, alias do dispositivo, senha do dispositivo, nota do dispositivo predefinidos, https://github.com/rustdesk/rustdesk-server-pro/issues/257.
Você pode definir preset-address-book-name apenas se não quiser definir tag.
Por favor, use nome e tag de catálogo de endereços válidos na sua página de catálogo de endereços do console web.
@ -1027,6 +1027,11 @@ Por favor, use nome e tag de catálogo de endereços válidos na sua página de
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | N | | | `preset-address-book-name=<nome do catálogo de endereços>` |
| preset-address-book-tag | N | | | `preset-address-book-tag=<nome da tag do catálogo de endereços>` |
| preset-address-book-alias | N | | | `preset-address-book-alias=<alias do dispositivo>` |
| preset-address-book-password | N | | | `preset-address-book-password=<senha do dispositivo>` |
| preset-address-book-note | N | | | `preset-address-book-note=<nota do dispositivo>` |
preset-address-book-alias, preset-address-book-password, preset-address-book-note estão disponíveis no cliente RustDesk >=1.4.3, pro >= 1.6.6.
### disable-group-panel
@ -1177,14 +1182,16 @@ Controla se deve usar apenas TCP. Não usará mais UDP 21116, TCP 21116 será us
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
Atribui usuário / estratégia / grupo de dispositivo ao dispositivo. Você também pode fazer isso via [linha de comando](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
Atribui usuário / estratégia / grupo de dispositivo / nome de usuário do dispositivo / nome do dispositivo(hostname) / nota ao dispositivo. Você também pode fazer isso via [linha de comando](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices).
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
grupo de dispositivo está disponível no cliente RustDesk >=1.3.8, pro >= 1.5.0
preset-device-username, preset-device-name, preset-note estão disponíveis no cliente RustDesk >=1.4.3, pro >= 1.6.6.
### default-connect-password
Você usa a `senha de conexão padrão` para estabelecer conexões com dispositivos remotos. Esta senha é configurada no lado de controle e não deve ser confundida com qualquer [senha predefinida](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access) encontrada no cliente controlado (apenas entrada).
@ -1311,7 +1318,7 @@ Não registrar o dispositivo, você não o verá na página de dispositivos no c
Se `register-device=N`, o seguinte não funcionará para este dispositivo.
- Login
- Comando `--assign`
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- Logs de Auditoria
- Estratégia

View File

@ -1016,9 +1016,9 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
## 其他
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
预设通讯录名称和标签https://github.com/rustdesk/rustdesk-server-pro/issues/257。
预设通讯录名称、设备标签、设备别名、设备密码、设备备注https://github.com/rustdesk/rustdesk-server-pro/issues/257。
如果不想设置标签可以仅设置preset-address-book-name。
请在Web控制台的通讯录页面上使用有效的通讯录名称和标签。
@ -1026,6 +1026,11 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | 否 | | | `preset-address-book-name=<通讯录名称>` |
| preset-address-book-tag | 否 | | | `preset-address-book-tag=<通讯录标签名称>` |
| preset-address-book-alias | 否 | | | `preset-address-book-alias=<设备别名>` |
| preset-address-book-password | 否 | | | `preset-address-book-password=<设备密码>` |
| preset-address-book-note | 否 | | | `preset-address-book-note=<设备备注>` |
preset-address-book-alias、preset-address-book-password、preset-address-book-note在RustDesk客户端>=1.4.3、pro >= 1.6.6中可用。
### disable-group-panel
@ -1176,14 +1181,16 @@ https://github.com/rustdesk/rustdesk-server-pro/issues/277
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
将用户/策略/设备组分配给设备。您也可以通过[命令行](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)执行此操作。
将用户/策略/设备组/设备用户名/设备名(主机名)/备注分配给设备。您也可以通过[命令行](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)执行此操作。
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
设备组在RustDesk客户端>=1.3.8、pro >= 1.5.0中可用
preset-device-username、preset-device-name、preset-note在RustDesk客户端>=1.4.3、pro >= 1.6.6中可用。
### default-connect-password
您使用`默认连接密码`来建立到远程设备的连接。此密码在控制端配置,不应与受控(仅传入)客户端上找到的任何[预设密码](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access)混淆。
@ -1312,7 +1319,7 @@ D3D渲染可以获得高帧率并减少CPU使用率但在某些设备上远
如果`register-device=N`,以下功能对此设备不起作用。
- 登录
- `--assign`命令
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- 审计日志
- 策略

View File

@ -959,9 +959,9 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
## 其他
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
預設通訊錄名稱和標籤https://github.com/rustdesk/rustdesk-server-pro/issues/257。
預設通訊錄名稱、設備標籤、設備別名、設備密碼、設備備註https://github.com/rustdesk/rustdesk-server-pro/issues/257。
如果不想設定標籤可以僅設定preset-address-book-name。
請在Web控制台的通訊錄頁面上使用有效的通訊錄名稱和標籤。
@ -969,6 +969,11 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | 否 | | | `preset-address-book-name=<通訊錄名稱>` |
| preset-address-book-tag | 否 | | | `preset-address-book-tag=<通訊錄標籤名稱>` |
| preset-address-book-alias | 否 | | | `preset-address-book-alias=<設備別名>` |
| preset-address-book-password | 否 | | | `preset-address-book-password=<設備密碼>` |
| preset-address-book-note | 否 | | | `preset-address-book-note=<設備備註>` |
preset-address-book-alias、preset-address-book-password、preset-address-book-note在RustDesk用戶端>=1.4.3、pro >= 1.6.6中可用。
### disable-group-panel
@ -1119,14 +1124,16 @@ https://github.com/rustdesk/rustdesk-server-pro/issues/277
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
將使用者/策略/設備群組分配給設備。您也可以透過[命令列](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)執行此操作。
將使用者/策略/設備群組/設備使用者名稱/設備名稱(主機名)/備註分配給設備。您也可以透過[命令列](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)執行此操作。
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
設備群組在RustDesk用戶端>=1.3.8、pro >= 1.5.0中可用
preset-device-username、preset-device-name、preset-note在RustDesk用戶端>=1.4.3、pro >= 1.6.6中可用。
### default-connect-password
您使用`預設連接密碼`來建立到遠端設備的連接。此密碼在控制端設定,不應與受控(僅傳入)用戶端上找到的任何[預設密碼](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access)混淆。
@ -1255,7 +1262,7 @@ D3D渲染可以獲得高幀率並減少CPU使用率但在某些設備上遠
如果`register-device=N`,以下功能對此設備不起作用。
- 登入
- `--assign`命令
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- 稽核日誌
- 策略
@ -1459,9 +1466,9 @@ D3D渲染可以獲得高幀率並減少CPU使用率但在某些設備上遠
## 其他
### preset-address-book-name & preset-address-book-tag
### preset-address-book-name & preset-address-book-tag & preset-address-book-alias & preset-address-book-password & preset-address-book-note
預設通訊錄名稱和標籤https://github.com/rustdesk/rustdesk-server-pro/issues/257。
預設通訊錄名稱、設備標籤、設備別名、設備密碼、設備備註https://github.com/rustdesk/rustdesk-server-pro/issues/257。
如果不想設定標籤可以僅設定preset-address-book-name。
請在Web控制台的通訊錄頁面上使用有效的通訊錄名稱和標籤。
@ -1469,6 +1476,11 @@ D3D渲染可以獲得高幀率並減少CPU使用率但在某些設備上遠
| :------: | :------: | :------: | :------: | :------: |
| preset-address-book-name | 否 | | | `preset-address-book-name=<通訊錄名稱>` |
| preset-address-book-tag | 否 | | | `preset-address-book-tag=<通訊錄標籤名稱>` |
| preset-address-book-alias | 否 | | | `preset-address-book-alias=<設備別名>` |
| preset-address-book-password | 否 | | | `preset-address-book-password=<設備密碼>` |
| preset-address-book-note | 否 | | | `preset-address-book-note=<設備備註>` |
preset-address-book-alias、preset-address-book-password、preset-address-book-note在RustDesk用戶端>=1.4.3、pro >= 1.6.6中可用。
### disable-group-panel
@ -1619,14 +1631,16 @@ https://github.com/rustdesk/rustdesk-server-pro/issues/277
| :------: | :------: | :------: |
| Y, N | N | `disable-udp=Y` |
### preset-user-name / preset-strategy-name / preset-device-group-name
### preset-user-name / preset-strategy-name / preset-device-group-name / preset-device-username / preset-device-name / preset-note
將使用者/策略/設備群組分配給設備。您也可以透過[命令列](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)執行此操作。
將使用者/策略/設備群組/設備使用者名稱/設備名稱(主機名)/備註分配給設備。您也可以透過[命令列](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices)執行此操作。
https://github.com/rustdesk/rustdesk-server-pro/discussions/304
設備群組在RustDesk用戶端>=1.3.8、pro >= 1.5.0中可用
preset-device-username、preset-device-name、preset-note在RustDesk用戶端>=1.4.3、pro >= 1.6.6中可用。
### default-connect-password
您使用`預設連接密碼`來建立到遠端設備的連接。此密碼在控制端設定,不應與受控(僅傳入)用戶端上找到的任何[預設密碼](https://github.com/rustdesk/rustdesk/wiki/FAQ#how-can-we-set-up-a-client-with-a-fixed-password-for-unattended-remote-access)混淆。
@ -1755,7 +1769,7 @@ D3D渲染可以獲得高幀率並減少CPU使用率但在某些設備上遠
如果`register-device=N`,以下功能對此設備不起作用。
- 登入
- `--assign`命令
- `preset-address-book-name`, `--preset-address-book-tag`, `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`
- `preset-address-book-name`, `preset-address-book-tag`, `preset-address-book-alias`, `preset-address-book-password`, `preset-address-book-note` `preset-user-name`, `preset-strategy-name`, `preset-device-group-name`, `preset-device-username`, `preset-device-name`, `preset-note`
- 稽核日誌
- 策略

View File

@ -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 <generatedtoken> --user_name <username>`. 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 <generatedtoken> --user_name <newuser>`.
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 <generatedtoken> --strategy_name <strategyname>` 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 <generatedtoken> --address_book_name <addressbookname>` oder `--assign --token <generatedtoken> --address_book_name <addressbookname> --address_book_tag <addressbooktag> --address_book_alias <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 <generatedtoken> --device_group_name <devicegroupname>`.
---
## 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 <generatedtoken> --user_name <username>
---
Unterstützte Parameter
| Parameter | Beschreibung | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | -------------------------------------------------- | ------------------- | --------------- |
| `--user_name <username>` | Weist dem Gerät einen Benutzer zu | | |
| `--strategy_name <strategyname>` | Weist dem Gerät eine Strategie zu | | |
| `--address_book_name <addressbookname>` | Weist das Gerät einem Adressbuch zu | | |
| `--address_book_tag <addressbooktag>` | Weist über Adressbuch-Tag zu | | |
| `--address_book_alias <alias>` | Weist über Adressbuch-Alias zu | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Setzt das Passwort für den Adressbucheintrag | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Fügt eine Notiz für den Adressbucheintrag hinzu | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Weist das Gerät einer Gerätegruppe zu | | |
| `--note <note>` | Fügt dem Gerät eine Notiz hinzu | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Legt den Gerätenutzernamen fest | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more`
oder
`"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filter:**
`--name`: Benutzername
`--group_name`: Benutzergruppe
**Beispiel:**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Geräteverwaltung (`devices.py`)
**Hilfe anzeigen:**
./devices.py -h
**Geräte anzeigen:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]
**Persönliche Adressbuch-GUID abrufen:**
./ab.py --url <url> --token <token> get-personal-ab
**Ein freigegebenes Adressbuch hinzufügen:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Ein freigegebenes Adressbuch aktualisieren oder löschen:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Peers in einem Adressbuch anzeigen:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Peer hinzufügen, aktualisieren oder löschen:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Tag-Verwaltung:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Zugriffsregelverwaltung:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Beispiel (Lesezugriff für Benutzer „mike“ hinzufügen):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Prüfprotokolle (`audits.py`)
**Hilfe anzeigen:**
./audits.py -h
**Verbindungsprotokolle anzeigen:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Dateiübertragungsprotokolle anzeigen:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Alarmprotokolle anzeigen:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Konsolenprotokolle anzeigen:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 <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" <arg1> <arg2> ... | more` oder `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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.

View File

@ -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 <generatedtoken> --user_name <username>`. 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 <generatedtoken> --user_name <newuser>`.
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 <generatedtoken> --strategy_name <strategyname>`.
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 <generatedtoken> --address_book_name <addressbookname>` or `--assign --token <generatedtoken> --address_book_name <addressbookname> --address_book_tag <addressbooktag> --address_book_alias <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 <generatedtoken> --device_group_name <devicegroupname>`.
---
## 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 <generatedtoken> --user_name <username>
```
Supported Parameters
| Parameter | Description | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | --------------------------------------- | ------------------- | --------------- | ------------------- |
| `--user_name <username>` | Assign a user to the device | | |
| `--strategy_name <strategyname>` | Assign a strategy to the device | | |
| `--address_book_name <addressbookname>` | Assign device to an address book | | |
| `--address_book_tag <addressbooktag>` | Assign with address book tag | | |
| `--address_book_alias <alias>` | Assign with address book alias | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Set password for the address book entry | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Set note for the address book entry | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Assign device to a device group | | |
| `--note <note>` | Add note to the device | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Set the device username | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more` or `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]`
**Filters:**
`--name`: username
`--group_name`: user group
**Example:**
`./users.py --url https://example.com --token <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 <token> disable --name testuser`
---
#### Devices Management (`devices.py`)
**Show help:**
`./devices.py -h`
**View devices:**
`./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]`
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]`
**Get personal address book GUID:**
`./ab.py --url <url> --token <token> get-personal-ab`
**Add a shared address book:**
`./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]`
**Update or delete a shared address book:**
`./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]`
`./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>`
**View peers in an address book:**
`./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]`
**Add, update, or delete a peer:**
`./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]`
`./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]`
`./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>`
**Tags management:**
`./ab.py --url <url> --token <token> view-tag --ab-guid <guid>`
`./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]`
`./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000`
`./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>`
**Access rules management:**
`./ab.py --url <url> --token <token> view-rule --ab-guid <guid>`
`./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full`
`./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw`
`./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>`
**Example (add read-only rule for user "mike"):**
`./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro`
---
#### Audits (`audits.py`)
**Show help:**
`./audits.py -h`
**View connection audits:**
`./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]`
**View file audits:**
`./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]`
**View alarm audits:**
`./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]`
**View console audits:**
`./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]`
**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 <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 <kbd>Enter</kbd>.

View File

@ -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 <token generado> --user_name <nombre de usuario>`. 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 <token generado> --user_name <nuevo usuario>`.
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 <token generado> --strategy_name <nombre de estrategia>`.
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 <token generado> --address_book_name <nombre de libreta de direcciones>` o `--assign --token <token generado> --address_book_name <nombre de libreta de direcciones> --address_book_tag <etiqueta de libreta de direcciones> --address_book_alias <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 <token generado> --device_group_name <nombre de grupo de dispositivo>`.
---
La línea de comandos en Windows no tiene salida por defecto. Para obtener salida, ejecute así, `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more` o `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <generatedtoken> --user_name <username>
Parámetros Soportados
| Parámetro | Descripción | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | --------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Asignar un usuario al dispositivo | | |
| `--strategy_name <strategyname>` | Asignar una estrategia al dispositivo | | |
| `--address_book_name <addressbookname>` | Asignar dispositivo a una libreta | | |
| `--address_book_tag <addressbooktag>` | Asignar con etiqueta de libreta | | |
| `--address_book_alias <alias>` | Asignar con alias de libreta | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Establecer contraseña para la entrada | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Establecer nota para la entrada | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Asignar dispositivo a un grupo | | |
| `--note <note>` | Agregar nota al dispositivo | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Establecer el nombre de usuario del dispositivo | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtros:**
--name: nombre de usuario
--group_name: grupo de usuarios
**Ejemplo:**
./users.py --url https://example.com --token <token> view --group_name admins
**Operaciones:**
`view` puede reemplazarse por `enable`, `disable`, o `delete`.
**Ejemplo (deshabilitar usuario):**
./users.py --url https://example.com --token <token> disable --name testuser
---
#### Gestión de Dispositivos (`devices.py`)
**Mostrar ayuda:**
./devices.py -h
**Ver dispositivos:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]
**Obtener GUID de libreta personal:**
./ab.py --url <url> --token <token> get-personal-ab
**Agregar una libreta compartida:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Actualizar o eliminar una libreta compartida:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Ver peers en una libreta:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Agregar, actualizar o eliminar un peer:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Gestión de etiquetas:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Gestión de reglas de acceso:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Ejemplo (agregar regla de solo lectura para el usuario "mike"):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <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 <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Ver auditorías de archivos:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Ver auditorías de alarmas:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Ver auditorías de consola:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 <token> view-conn --remote 123456789 --days-ago 7
## Buscar un dispositivo
1. Vaya a Dispositivos.

View File

@ -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 <token généré> --user_name <nom d'utilisateur>`. 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 <token généré> --user_name <nouvel utilisateur>`.
LUtilisateur est lutilisateur 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 <token généré> --strategy_name <nom de stratégie>`.
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 dun 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 <token généré> --address_book_name <nom du carnet d'adresses>` ou `--assign --token <token généré> --address_book_name <nom du carnet d'adresses> --address_book_tag <tag du carnet d'adresses> --address_book_alias <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 <token généré> --device_group_name <nom du groupe d'appareils>`.
---
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" <arg1> <arg2> ... | more` ou `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String`, voir [ici](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952).
## Jeton API
Vous devez dabord aller dans **Paramètres → Jetons → Créer** et créer un jeton avec les permissions requises : **Périphérique, Journal dAudit, Utilisateur, Groupe, Stratégie, Carnet dAdresses**.
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 lexécutable RustDesk avec le paramètre `--assign`.
Cela permet dassigner des utilisateurs, des stratégies, des carnets dadresses 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 <generatedtoken> --user_name <username>
Paramètres pris en charge
| Paramètre | Description | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Assigner un utilisateur au périphérique | | |
| `--strategy_name <strategyname>` | Assigner une stratégie au périphérique | | |
| `--address_book_name <addressbookname>` | Assigner le périphérique à un carnet | | |
| `--address_book_tag <addressbooktag>` | Assigner avec un tag du carnet | | |
| `--address_book_alias <alias>` | Assigner avec un alias de carnet | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Définir le mot de passe de lentrée | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Définir une note pour lentrée | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Assigner le périphérique à un groupe | | |
| `--note <note>` | Ajouter une note au périphérique | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Définir le nom dutilisateur du périphérique | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String
voir [ici](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952).
### Outils de Gestion Python CLI
#### Gestion des Utilisateurs (`users.py`)
**Afficher laide :**
./users.py -h
**Voir les utilisateurs :**
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtres :**
--name : nom dutilisateur
--group_name : groupe dutilisateurs
**Exemple :**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Gestion des Périphériques (`devices.py`)
**Afficher laide :**
./devices.py -h
**Voir les périphériques :**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**Filtres :**
--id : ID du périphérique
--device_name : nom du périphérique
--user_name : utilisateur assigné
--group_name : groupe dutilisateurs
--device_group_name : groupe de périphériques
--offline_days : jours hors ligne
**Exemple :**
./devices.py --url https://example.com --token <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 <token> assign --device_name PC01 --assign_to user_name=mike
---
#### Gestion du Carnet dAdresses (`ab.py`)
**Afficher laide :**
./ab.py -h
**Voir les carnets partagés :**
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
**Obtenir le GUID du carnet personnel :**
./ab.py --url <url> --token <token> get-personal-ab
**Ajouter un carnet partagé :**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Mettre à jour ou supprimer un carnet partagé :**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Voir les pairs dans un carnet :**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Ajouter, mettre à jour ou supprimer un pair :**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Gestion des étiquettes :**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Gestion des règles daccès :**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Exemple (ajouter une règle en lecture seule pour lutilisateur "mike") :**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Audits (`audits.py`)
**Afficher laide :**
./audits.py -h
**Voir les audits de connexion :**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Voir les audits de fichiers :**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Voir les audits dalarme :**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Voir les audits de console :**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 dalarme)
--operator : nom de lopé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 <token> view-conn --remote 123456789 --days-ago 7
## Rechercher un appareil
1. Allez dans Appareils.

View File

@ -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 <token generato> --user_name <nome utente>`. 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 <token generato> --user_name <nuovo utente>`.
LUtente è lutente 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 <token generato> --strategy_name <nome strategia>`.
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 <token generato> --address_book_name <nome rubrica>` o `--assign --token <token generato> --address_book_name <nome rubrica> --address_book_tag <tag rubrica> --address_book_alias <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 <token generato> --device_group_name <nome gruppo dispositivo>`.
---
La riga di comando su Windows non ha output per impostazione predefinita. Per ottenere output, esegui così, `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more` o `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 leseguibile RustDesk con il parametro `--assign`.
Questo permette di assegnare utenti, strategie, rubriche o gruppi di dispositivi a un dispositivo direttamente dalla linea di comando.
**Esempio:**
"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <generatedtoken> --user_name <username>
Parametri supportati
| Parametro | Descrizione | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ----------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Assegna un utente al dispositivo | | |
| `--strategy_name <strategyname>` | Assegna una strategia al dispositivo | | |
| `--address_book_name <addressbookname>` | Assegna il dispositivo a una rubrica | | |
| `--address_book_tag <addressbooktag>` | Assegna con tag della rubrica | | |
| `--address_book_alias <alias>` | Assegna con alias della rubrica | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Imposta la password per la voce | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Imposta una nota per la voce | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Assegna il dispositivo a un gruppo | | |
| `--note <note>` | Aggiunge una nota al dispositivo | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Imposta il nome utente del dispositivo | 1.6.6 | 1.4.3 |
| `--device_name <device_name>` | Imposta il nome del dispositivo | 1.6.6 | 1.4.3 |
La linea di comando su Windows non produce output per default. Per ottenere output, eseguire:
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String
vedi [qui](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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtri:**
--name : nome utente
--group_name : gruppo utenti
**Esempio:**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Gestione Dispositivi (`devices.py`)
**Mostra aiuto:**
./devices.py -h
**Visualizza dispositivi:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**Filtri:**
--id : ID dispositivo
--device_name : nome dispositivo
--user_name : utente assegnato
--group_name : gruppo utenti
--device_group_name : gruppo dispositivi
--offline_days : giorni offline
**Esempio:**
./devices.py --url https://example.com --token <token> view --user_name mike
**Operazioni:**
`view` può essere sostituito con `enable`, `disable`, `delete`, o `assign`.
**Esempio (assegnare dispositivo):**
./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike
---
#### Gestione Rubrica (`ab.py`)
**Mostra aiuto:**
./ab.py -h
**Visualizza rubriche condivise:**
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
**Ottieni GUID rubrica personale:**
./ab.py --url <url> --token <token> get-personal-ab
**Aggiungi rubrica condivisa:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Aggiorna o elimina rubrica condivisa:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Visualizza peer in una rubrica:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Aggiungi, aggiorna o elimina un peer:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Gestione tag:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Gestione regole di accesso:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Esempio (aggiungi regola sola lettura per lutente "mike"):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Audit (`audits.py`)
**Mostra aiuto:**
./audits.py -h
**Visualizza audit di connessione:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizza audit file:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizza audit allarmi:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizza audit console:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Filtri:**
--remote : ID peer (per audit di connessione o file)
--conn-type : 0=Desktop Remoto, 1=Trasferimento File, 2=Trasferimento Porte, 3=Visualizza Telecamera, 4=Terminale
--device : ID dispositivo (per audit allarmi)
--operator : nome operatore (per audit console)
--created-at : filtro orario locale, es. "2025-09-16 14:15:57"
--days-ago : filtra record più recenti di n giorni
--page-size / --current : paginazione
**Esempio:**
./audits.py --url https://example.com --token <token> view-conn --remote 123456789 --days-ago 7
## Cercare un dispositivo
1. Vai su Dispositivi.

View File

@ -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" <arg1> <arg2> ... | more`または`"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String`のように実行してください。[こちら](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)を参照してください。
## APIトークン
まず、**設定 → トークン → 作成**に移動し、必要な権限(**デバイス、監査ログ、ユーザー、グループ、戦略、アドレス帳**)を持つトークンを作成する必要があります。
作成後、これらのトークンを**コマンドライン**または**Python CLI**を通じて使用し、対応する権限で操作を実行できます。
### コマンドラインからトークンを使用して割り当て
`--assign`パラメータを使用してRustDesk実行ファイルで割り当てを行うこともできます。
これにより、ユーザー、戦略、アドレス帳、またはデバイスグループをコマンドラインから直接デバイスに割り当てることができます。
**例:**
"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <generatedtoken> --user_name <username>
サポートされているパラメータ
| パラメータ | 説明 | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | デバイスにユーザーを割り当て | | |
| `--strategy_name <strategyname>` | デバイスに戦略を割り当て | | |
| `--address_book_name <addressbookname>` | デバイスをアドレス帳に割り当て | | |
| `--address_book_tag <addressbooktag>` | アドレス帳タグで割り当て | | |
| `--address_book_alias <alias>` | アドレス帳のエイリアスで割り当て | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | アドレス帳エントリのパスワードを設定 | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | アドレス帳エントリにメモを設定 | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | デバイスをデバイスグループに割り当て | | |
| `--note <note>` | デバイスにメモを追加 | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | デバイスのユーザー名を設定 | 1.6.6 | 1.4.3 |
| `--device_name <device_name>` | デバイス名を設定 | 1.6.6 | 1.4.3 |
Windowsのコマンドラインはデフォルトでは出力を表示しません。出力を取得するには次のように実行してください
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String
詳細は[こちら](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。
### Python CLI管理ツール
#### ユーザー管理 (`users.py`)
**ヘルプ表示:**
./users.py -h
**ユーザー表示:**
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]
**フィルター:**
--name : ユーザー名
--group_name : ユーザーグループ
**例:**
./users.py --url https://example.com --token <token> view --group_name admins
**操作:**
`view`は`enable`、`disable`、`delete`に置き換え可能です。
**例(ユーザーを無効化):**
./users.py --url https://example.com --token <token> disable --name testuser
---
#### デバイス管理 (`devices.py`)
**ヘルプ表示:**
./devices.py -h
**デバイス表示:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**フィルター:**
--id : デバイスID
--device_name : デバイス名
--user_name : 割り当てユーザー
--group_name : ユーザーグループ
--device_group_name : デバイスグループ
--offline_days : オフライン日数
**例:**
./devices.py --url https://example.com --token <token> view --user_name mike
**操作:**
`view`は`enable`、`disable`、`delete`、`assign`に置き換え可能です。
**例(デバイスを割り当てる):**
./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike
---
#### アドレス帳管理 (`ab.py`)
**ヘルプ表示:**
./ab.py -h
**共有アドレス帳表示:**
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
**個人アドレス帳GUID取得**
./ab.py --url <url> --token <token> get-personal-ab
**共有アドレス帳追加:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**共有アドレス帳の更新または削除:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**アドレス帳内のピア表示:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**ピアの追加、更新、削除:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**タグ管理:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**アクセスルール管理:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**例(ユーザー "mike" に読み取り専用ルールを追加):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### 監査 (`audits.py`)
**ヘルプ表示:**
./audits.py -h
**接続監査の表示:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**ファイル監査の表示:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**アラーム監査の表示:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**コンソール監査の表示:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**フィルター:**
--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 <token> view-conn --remote 123456789 --days-ago 7
## デバイスの検索
1. デバイスに移動します。

View File

@ -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 <wygenerowanytoken> --user_name <nazwa_użytkownika>`. 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 <wygenerowanytoken> --user_name <nazwa_użytkownika>`.
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 <wygenerowanytoken> --strategy_name <nazwastrategii>`.
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 <wygenerowanytoken> --address_book_name <nazwaksiążkiadresowej>` lub `--assign --token <wygenerowanytoken> --address_book_name <nazwaksiążkiadresowej> --address_book_tag <znacznikksiążkiadresowej> --address_book_alias <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 <wygenerowanytoken> --device_group_name <nazwagrupyurządzeń>`.
---
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" <arg1> <arg2> ... | więcej` lub `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <generatedtoken> --user_name <username>
Obsługiwane parametry
| Parametr | Opis | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Przypisz użytkownika do urządzenia | | |
| `--strategy_name <strategyname>` | Przypisz strategię do urządzenia | | |
| `--address_book_name <addressbookname>` | Przypisz urządzenie do książki adresowej | | |
| `--address_book_tag <addressbooktag>` | Przypisz z tagiem książki adresowej | | |
| `--address_book_alias <alias>` | Przypisz z aliasem książki adresowej | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Ustaw hasło dla wpisu w książce adresowej| 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Ustaw notatkę dla wpisu w książce adresowej | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Przypisz urządzenie do grupy | | |
| `--note <note>` | Dodaj notatkę do urządzenia | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Ustaw nazwę użytkownika urządzenia | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtry:**
--name : nazwa użytkownika
--group_name : grupa użytkowników
**Przykład:**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Zarządzanie urządzeniami (`devices.py`)
**Pokaż pomoc:**
./devices.py -h
**Wyświetl urządzenia:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]
**Pobierz GUID osobistej książki adresowej:**
./ab.py --url <url> --token <token> get-personal-ab
**Dodaj udostępnioną książkę adresową:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Aktualizuj lub usuń udostępnioną książkę adresową:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Wyświetl peerów w książce adresowej:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Dodaj, zaktualizuj lub usuń peer:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Zarządzanie tagami:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Zarządzanie regułami dostępu:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Przykład (dodaj regułę tylko do odczytu dla użytkownika "mike"):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Audyty (`audits.py`)
**Pokaż pomoc:**
./audits.py -h
**Wyświetl audyt połączeń:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt plików:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt alarmów:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt konsoli:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 <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 <generatedtoken> --user_name <username>
Obsługiwane parametry
| Parametr | Opis | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Przypisz użytkownika do urządzenia | | |
| `--strategy_name <strategyname>` | Przypisz strategię do urządzenia | | |
| `--address_book_name <addressbookname>` | Przypisz urządzenie do książki adresowej | | |
| `--address_book_tag <addressbooktag>` | Przypisz z tagiem książki adresowej | | |
| `--address_book_alias <alias>` | Przypisz z aliasem książki adresowej | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Ustaw hasło dla wpisu w książce adresowej| 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Ustaw notatkę dla wpisu w książce adresowej | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Przypisz urządzenie do grupy | | |
| `--note <note>` | Dodaj notatkę do urządzenia | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Ustaw nazwę użytkownika urządzenia | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtry:**
--name : nazwa użytkownika
--group_name : grupa użytkowników
**Przykład:**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Zarządzanie urządzeniami (`devices.py`)
**Pokaż pomoc:**
./devices.py -h
**Wyświetl urządzenia:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]
**Pobierz GUID osobistej książki adresowej:**
./ab.py --url <url> --token <token> get-personal-ab
**Dodaj udostępnioną książkę adresową:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Aktualizuj lub usuń udostępnioną książkę adresową:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Wyświetl peerów w książce adresowej:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Dodaj, zaktualizuj lub usuń peer:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Zarządzanie tagami:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Zarządzanie regułami dostępu:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Przykład (dodaj regułę tylko do odczytu dla użytkownika "mike"):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Audyty (`audits.py`)
**Pokaż pomoc:**
./audits.py -h
**Wyświetl audyt połączeń:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt plików:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt alarmów:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Wyświetl audyt konsoli:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 <token> view-conn --remote 123456789 --days-ago 7
## Wyszukiwanie urządzenia
1. Przejdź do sekcji Urządzenia.

View File

@ -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 <token gerado> --user_name <nome do usuário>`. 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 <token gerado> --user_name <novo usuário>`.
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 <token gerado> --strategy_name <nome da estratégia>`.
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 <token gerado> --address_book_name <nome do caderno de endereços>` ou `--assign --token <token gerado> --address_book_name <nome do caderno de endereços> --address_book_tag <tag do caderno de endereços> --address_book_alias <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 <token gerado> --device_group_name <nome do grupo de dispositivo>`.
---
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" <arg1> <arg2> ... | more` ou `"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <generatedtoken> --user_name <username>
Parâmetros suportados
| Parâmetro | Descrição | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | Atribui um usuário ao dispositivo | | |
| `--strategy_name <strategyname>` | Atribui uma estratégia ao dispositivo | | |
| `--address_book_name <addressbookname>` | Atribui o dispositivo a um livro de endereços | | |
| `--address_book_tag <addressbooktag>` | Atribui com tag do livro de endereços | | |
| `--address_book_alias <alias>` | Atribui com alias do livro de endereços | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | Define a senha da entrada do livro | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | Define nota para a entrada do livro | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | Atribui o dispositivo a um grupo | | |
| `--note <note>` | Adiciona nota ao dispositivo | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | Define o nome de usuário do dispositivo | 1.6.6 | 1.4.3 |
| `--device_name <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" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | 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 <url> --token <token> view [--name <username>] [--group_name <group_name>]
**Filtros:**
--name : nome do usuário
--group_name : grupo de usuários
**Exemplo:**
./users.py --url https://example.com --token <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 <token> disable --name testuser
---
#### Gerenciamento de Dispositivos (`devices.py`)
**Mostrar ajuda:**
./devices.py -h
**Visualizar dispositivos:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**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 <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 <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 <url> --token <token> view-ab [--ab-name <address_book_name>]
**Obter GUID do livro de endereços pessoal:**
./ab.py --url <url> --token <token> get-personal-ab
**Adicionar livro de endereços compartilhado:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**Atualizar ou deletar livro de endereços compartilhado:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**Visualizar peers em um livro de endereços:**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**Adicionar, atualizar ou deletar um peer:**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**Gerenciamento de tags:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**Gerenciamento de regras de acesso:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**Exemplo (adicionar regra somente leitura para usuário "mike"):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### Auditorias (`audits.py`)
**Mostrar ajuda:**
./audits.py -h
**Visualizar auditoria de conexões:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizar auditoria de arquivos:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizar auditoria de alarmes:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**Visualizar auditoria de console:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**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 <token> view-conn --remote 123456789 --days-ago 7
## Procurando por um dispositivo
1. Vá para Dispositivos.

View File

@ -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 <generatedtoken> --user_name <username>
**支持的参数:**
| 参数名 | 说明 | RustDesk Server Pro | RustDesk Client |
| ------- | ---- | ------------------- | ---------------- |
| `--user_name <username>` | 为设备分配用户 | | |
| `--strategy_name <strategyname>` | 为设备分配策略 | | |
| `--address_book_name <addressbookname>` | 将设备分配到地址簿 | | |
| `--address_book_tag <addressbooktag>` | 按标签分配地址簿 | | |
| `--address_book_alias <alias>` | 设置地址簿别名 | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | 为地址簿条目设置密码 | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | 为地址簿条目添加备注 | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | 将设备分配到设备组 | | |
| `--note <note>` | 为设备添加备注 | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | 设置设备用户名 | 1.6.6 | 1.4.3 |
| `--device_name <device_name>` | 设置设备名称 | 1.6.6 | 1.4.3 |
Windows 命令行默认无输出,如需查看输出,可使用如下方式运行:
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String
详情参考RustDesk 讨论区相关评论链接(原文处有链接)。
---
### Python CLI 管理工具
#### 用户管理 users.py
**查看帮助:**
./users.py -h
**查看用户:**
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]
**过滤条件:**
`--name`:用户名
`--group_name`:用户组名
**示例:**
./users.py --url https://example.com --token <token> view --group_name admins
**操作命令:**
`view` 可替换为 `enable`(启用)、`disable`(禁用)或 `delete`(删除)。
**示例(禁用用户):**
./users.py --url https://example.com --token <token> disable --name testuser
---
#### 设备管理 devices.py
**查看帮助:**
./devices.py -h
**查看设备:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**过滤条件:**
`--id`:设备 ID
`--device_name`:设备名称
`--user_name`:分配的用户
`--group_name`:用户组
`--device_group_name`:设备组
`--offline_days`:离线天数
**示例:**
./devices.py --url https://example.com --token <token> view --user_name mike
**操作命令:**
`view` 可替换为 `enable`(启用)、`disable`(禁用)、`delete`(删除)或 `assign`(分配)。
**示例(分配设备):**
./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike
---
#### 地址簿管理 ab.py
**查看帮助:**
./ab.py -h
**查看共享地址簿:**
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
**获取个人地址簿 GUID**
./ab.py --url <url> --token <token> get-personal-ab
**添加共享地址簿:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**更新或删除共享地址簿:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**查看地址簿中的设备peer**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**添加、更新或删除设备peer**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**标签管理:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**访问规则管理:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**示例(为用户 mike 添加只读权限):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### 审计日志 audits.py
**查看帮助:**
./audits.py -h
**查看连接审计:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看文件审计:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看告警审计:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看控制台操作审计:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**过滤条件:**
`--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 <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. 进入设备页面。

View File

@ -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 <generatedtoken> --user_name <username>
支援參數
| 參數 | 說明 | RustDesk Server Pro | RustDesk Client |
| --------------------------------------- | ---------------------------------------- | ----------------- | --------------- |
| `--user_name <username>` | 將使用者分配給設備 | | |
| `--strategy_name <strategyname>` | 將策略分配給設備 | | |
| `--address_book_name <addressbookname>` | 將設備分配給通訊錄 | | |
| `--address_book_tag <addressbooktag>` | 使用通訊錄標籤進行分配 | | |
| `--address_book_alias <alias>` | 使用通訊錄別名進行分配 | 1.5.8 | 1.4.1 |
| `--address_book_password <password>` | 設定通訊錄條目的密碼 | 1.6.6 | 1.4.3 |
| `--address_book_note <note>` | 設定通訊錄條目的備註 | 1.6.6 | 1.4.3 |
| `--device_group_name <devicegroupname>` | 將設備分配到設備群組 | | |
| `--note <note>` | 為設備添加備註 | 1.6.6 | 1.4.3 |
| `--device_username <device_username>` | 設定設備使用者名稱 | 1.6.6 | 1.4.3 |
| `--device_name <device_name>` | 設定設備名稱 | 1.6.6 | 1.4.3 |
Windows 命令列預設不會輸出結果。若要查看輸出,可使用:
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String
詳情參考 [這裡](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。
### Python CLI 管理工具
#### 使用者管理 (`users.py`)
**顯示幫助:**
./users.py -h
**查看使用者:**
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]
**篩選條件:**
--name : 使用者名稱
--group_name : 使用者群組
**範例:**
./users.py --url https://example.com --token <token> view --group_name admins
**操作:**
`view` 可替換為 `enable`、`disable` 或 `delete`
**範例(停用使用者):**
./users.py --url https://example.com --token <token> disable --name testuser
---
#### 設備管理 (`devices.py`)
**顯示幫助:**
./devices.py -h
**查看設備:**
./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]
**篩選條件:**
--id : 設備 ID
--device_name : 設備名稱
--user_name : 分配的使用者
--group_name : 使用者群組
--device_group_name : 設備群組
--offline_days : 離線天數
**範例:**
./devices.py --url https://example.com --token <token> view --user_name mike
**操作:**
`view` 可替換為 `enable`、`disable`、`delete` 或 `assign`
**範例(分配設備):**
./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike
---
#### 通訊錄管理 (`ab.py`)
**顯示幫助:**
./ab.py -h
**查看共享通訊錄:**
./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]
**取得個人通訊錄 GUID**
./ab.py --url <url> --token <token> get-personal-ab
**新增共享通訊錄:**
./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]
**更新或刪除共享通訊錄:**
./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>
**查看通訊錄中的 peer**
./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]
**新增、更新或刪除 peer**
./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>
**標籤管理:**
./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>
**存取規則管理:**
./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>
**範例(為使用者 "mike" 新增唯讀規則):**
./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro
---
#### 稽核 (`audits.py`)
**顯示幫助:**
./audits.py -h
**查看連線稽核:**
./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看檔案稽核:**
./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看警示稽核:**
./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**查看控制台稽核:**
./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]
**篩選條件:**
--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 <token> view-conn --remote 123456789 --days-ago 7
## 搜尋裝置
1. 進入裝置頁面。