--- title: Consola Web weight: 10 --- La consola web está integrada en RustDesk Server Pro, servida por el puerto `21114`. Características: - Explorar dispositivos - Agregar/modificar usuarios y grupos de usuarios - Modificar permisos de acceso a dispositivos - Explorar registros de conexión de dispositivos y otros registros - Actualizar configuraciones - Gestionar estrategias de sincronización de configuración del cliente - Gestionar libretas de direcciones compartidas - Generar compilación personalizada del cliente ## Iniciar sesión El puerto predeterminado de la consola web es 21114. Ingrese `http://:21114` en el navegador para acceder a la página de la consola, como se muestra en la siguiente figura. El nombre de usuario/contraseña predeterminado del administrador es `admin`/`test1234`: ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-login.png) Si necesita soporte HTTPS, instale un servidor web como `Nginx` o use `IIS` para Windows. Después de iniciar sesión, asegúrese de cambiar la contraseña, seleccione `Configuración` en el menú de cuenta en la esquina superior derecha para acceder a la página de modificación de contraseña, como se muestra en la siguiente figura. También puede crear otra cuenta de administrador y eliminar esta. Es recomendable habilitar la verificación de inicio de sesión por correo electrónico. ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2) Los usuarios no administradores también pueden iniciar sesión para explorar sus dispositivos y registros, cambiar sus configuraciones de usuario. ## Configuraciones Automáticas Al hacer clic en `Windows EXE` podrá obtener las configuraciones para su propio RustDesk Server Pro, esto ayudará a configurar sus clientes. Para clientes de Windows, puede omitir la configuración personalizada del servidor y poner la información de configuración en el nombre de archivo `rustdesk.exe` en su lugar. Como se muestra arriba, vaya a la página de bienvenida de la consola y haga clic en `Windows EXE`. **Se requiere Cliente ≥ 1.1.9.** Puede usar esto junto con [configuración del cliente](https://rustdesk.com/docs/en/self-host/client-configuration/) y [scripts de implementación](https://rustdesk.com/docs/en/self-host/client-deployment/) para configurar sus clientes. ## Crear un nuevo usuario diferente del usuario predeterminado `admin` {{% notice note %}} El plan `Individual` no tiene esta característica. {{% /notice %}} 1. Haga clic en `Usuarios` en el menú de la izquierda. 2. Cree otra cuenta with `administrador` habilitado. 3. Inicie sesión con la nueva cuenta administrativa. 4. Elimine el `admin` en la página `Usuarios`. ## Crear un nuevo usuario 1. Haga clic en `Usuarios` en el menú de la izquierda. 2. Cree un nuevo usuario. 3. Seleccione en qué grupo deberían estar (si necesita agregar nuevos grupos, siga leyendo). ## Agregar un nuevo Grupo 1. Haga clic en `Grupos` en el menú de la izquierda. 2. Cree un nuevo grupo. 3. Una vez creado, puede permitir que los grupos accedan entre sí, haga clic en `Editar`. 4. Seleccione los grupos relevantes a los que desea acceso (los agrega automáticamente en el grupo correspondiente). ## Configurar múltiples servidores de retransmisión 1. Vaya a `Configuración` en el menú de la izquierda. 2. Haga clic en `Retransmisión` en el submenú. 3. Haga clic en `+` junto a `Servidores de Retransmisión`. 4. Ingrese la dirección DNS o dirección IP del servidor de retransmisión en el cuadro que ahora se muestra y presione Enter. 5. Si tiene más de un servidor de retransmisión, puede seguir haciendo clic en `+` y adaptar la configuración geográfica si es necesario (recuerde y copie su clave a los otros servidores). ## Establecer o cambiar la licencia 1. Vaya a `Configuración` en el menú de la izquierda. 2. Haga clic en `Licencia` en el submenú. 3. Haga clic en `Editar` y pegue su código de licencia. 4. Haga clic en `OK`. ## Ver Registros En el lado izquierdo, haga clic en `Registros`. ## Configurar Correos Electrónicos Gmail en este ejemplo 1. Vaya a `Configuración` en el menú de la izquierda. 2. Haga clic en `SMTP` en el submenú. 3. Ingrese la dirección SMTP `smtp.gmail.com`. 4. Ingrese el Puerto 587 en `Puerto SMTP`. 5. Ingrese la cuenta de Gmail, es decir, `myrustdeskserver@gmail.com` en `Cuenta de Correo`. 6. Ingrese su contraseña (podría necesitar una contraseña de aplicación). 7. Ingrese su cuenta de Gmail, es decir, `myrustdeskserver@gmail.com` en `De`. 8. Haga clic en `Verificar` para guardar. ## Asignar Usuarios/Estrategias/Grupos de Dispositivos a Dispositivos a través de la Consola Web 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**. 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. 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. --- ## Token de API Primero debe ir a **Configuración → Tokens → Crear** y crear un token con los permisos requeridos: **Dispositivo, Registro de Auditoría, Usuario, Grupo, Estrategia, Libreta de Direcciones**. Una vez creado, puede usar estos tokens a través de **línea de comandos** o **Python CLI** para realizar acciones con los permisos correspondientes. ### Asignar mediante Token desde la Línea de Comandos También puede realizar asignaciones usando el ejecutable de RustDesk con el parámetro `--assign`. Esto permite asignar usuarios, estrategias, libretas de direcciones o grupos de dispositivos a un dispositivo directamente desde la línea de comandos. **Ejemplo:** "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name Parámetros Soportados | Parámetro | Descripción | RustDesk Server Pro | RustDesk Client | | --------------------------------------- | --------------------------------------- | ----------------- | --------------- | | `--user_name ` | Asignar un usuario al dispositivo | | | | `--strategy_name ` | Asignar una estrategia al dispositivo | | | | `--address_book_name ` | Asignar dispositivo a una libreta | | | | `--address_book_tag ` | Asignar con etiqueta de libreta | | | | `--address_book_alias ` | Asignar con alias de libreta | 1.5.8 | 1.4.1 | | `--address_book_password ` | Establecer contraseña para la entrada | 1.6.6 | 1.4.3 | | `--address_book_note ` | Establecer nota para la entrada | 1.6.6 | 1.4.3 | | `--device_group_name ` | Asignar dispositivo a un grupo | | | | `--note ` | Agregar nota al dispositivo | 1.6.6 | 1.4.3 | | `--device_username ` | Establecer el nombre de usuario del dispositivo | 1.6.6 | 1.4.3 | | `--device_name ` | Establecer el nombre del dispositivo | 1.6.6 | 1.4.3 | La línea de comandos en Windows no muestra salida por defecto. Para obtener salida, ejecute así: "C:\Program Files\RustDesk\rustdesk.exe" ... | more "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String ver [aquí](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). ### Herramientas de Gestión Python CLI #### Gestión de Usuarios (`users.py`) **Mostrar ayuda:** `./users.py -h` **Ver usuarios:** `./users.py --url --token view [--name ] [--group_name ]` **Filtros:** - `--name`: nombre de usuario (búsqueda difusa) - `--group_name`: grupo de usuarios (coincidencia exacta) **Ejemplo:** `./users.py --url https://example.com --token view --group_name Default` **Operaciones básicas:** - **Deshabilitar usuario:** `./users.py --url --token disable --name testuser` - **Habilitar usuario:** `./users.py --url --token enable --name testuser` - **Eliminar usuario:** `./users.py --url --token delete --name testuser` **Creación e invitación de usuarios:** - **Crear nuevo usuario:** `./users.py --url --token new --name username --password 'password123' --group_name Default [--email user@example.com] [--note "nota"]` Requerido: `--name`, `--password`, `--group_name` Opcional: `--email`, `--note` - **Invitar usuario por correo:** `./users.py --url --token invite --email user@example.com --name username --group_name Default [--note "nota"]` Requerido: `--email`, `--name`, `--group_name` Opcional: `--note` **Operaciones 2FA y seguridad:** - **Habilitar aplicación 2FA:** `./users.py --url --token enable-2fa-enforce --name username --web-console-url ` Requerido: `--web-console-url` - **Deshabilitar aplicación 2FA:** `./users.py --url --token disable-2fa-enforce --name username [--web-console-url ]` Opcional: `--web-console-url` - **Restablecer 2FA:** `./users.py --url --token reset-2fa --name username` - **Deshabilitar verificación por correo:** `./users.py --url --token disable-email-verification --name username` - **Cerrar sesión forzada:** `./users.py --url --token force-logout --name username` **Notas:** - Al operar sobre múltiples usuarios (coincidentes con filtros), se solicitará confirmación - Si no hay usuarios coincidentes, se mostrará "Found 0 users" --- #### Gestión de Grupos de Usuarios (`user_group.py`) **Mostrar ayuda:** `./user_group.py -h` **Ver grupos de usuarios:** `./user_group.py --url --token view [--name ]` **Ejemplo:** `./user_group.py --url https://example.com --token view --name "Equipo Ventas"` **Operaciones de grupo:** - **Crear grupo de usuarios:** `./user_group.py --url --token add --name "NombreGrupo" [--note "descripción"] [--accessed-from ''] [--access-to '']` Ejemplo con control de acceso: `./user_group.py --url --token add --name "Ingeniería" --accessed-from '[{"type":0,"name":"Gerentes"}]' --access-to '[{"type":1,"name":"Servidores Dev"}]'` - **Actualizar grupo de usuarios:** `./user_group.py --url --token update --name "NombreGrupo" [--new-name "Nuevo Nombre"] [--note "nueva nota"] [--accessed-from ''] [--access-to '']` - **Eliminar grupo de usuarios:** `./user_group.py --url --token delete --name "NombreGrupo"` Admite nombres separados por comas: `--name "Grupo1,Grupo2,Grupo3"` **Gestión de usuarios en grupos:** - **Ver usuarios en grupo:** `./user_group.py --url --token view-users [--name ] [--user-name ]` Filtros: - `--name`: nombre del grupo (coincidencia exacta, opcional) - `--user-name`: nombre de usuario (búsqueda difusa, opcional) Ejemplo: `./user_group.py --url --token view-users --name Default --user-name john` - **Agregar usuarios al grupo:** `./user_group.py --url --token add-users --name "NombreGrupo" --users "user1,user2,user3"` **Parámetros de control de acceso:** - `--accessed-from`: array JSON que define quién puede acceder a este grupo de usuarios - Type 0 = Grupo de usuarios (ej. `[{"type":0,"name":"Admins"}]`) - Type 2 = Usuario (ej. `[{"type":2,"name":"john"}]`) - `--access-to`: array JSON que define a qué puede acceder este grupo de usuarios - Type 0 = Grupo de usuarios (ej. `[{"type":0,"name":"Soporte"}]`) - Type 1 = Grupo de dispositivos (ej. `[{"type":1,"name":"Servidores"}]`) **Nota:** Use comillas simples alrededor de los arrays JSON para evitar problemas de análisis del shell. **Requisitos de permisos:** - Los comandos `view/add/update/delete/add-users` requieren **Permiso de Grupo de Usuarios** - El comando `view-users` requiere **Permiso de Usuario** --- #### Gestión de Grupos de Dispositivos (`device_group.py`) **Mostrar ayuda:** `./device_group.py -h` **Ver grupos de dispositivos:** `./device_group.py --url --token view [--name ]` **Ejemplo:** `./device_group.py --url https://example.com --token view` **Operaciones de grupo:** - **Crear grupo de dispositivos:** `./device_group.py --url --token add --name "NombreGrupo" [--note "descripción"] [--accessed-from '']` Ejemplo: `./device_group.py --url --token add --name "Producción" --accessed-from '[{"type":0,"name":"Admins"}]'` - **Actualizar grupo de dispositivos:** `./device_group.py --url --token update --name "NombreGrupo" [--new-name "Nuevo Nombre"] [--note "nueva nota"] [--accessed-from '']` - **Eliminar grupo de dispositivos:** `./device_group.py --url --token delete --name "NombreGrupo"` Admite nombres separados por comas: `--name "Grupo1,Grupo2,Grupo3"` **Gestión de dispositivos en grupos:** - **Ver dispositivos en grupo:** `./device_group.py --url --token view-devices [filtros]` Filtros disponibles: - `--name`: nombre del grupo de dispositivos (coincidencia exacta) - `--id`: ID del dispositivo (búsqueda difusa) - `--device-name`: nombre del dispositivo (búsqueda difusa) - `--user-name`: nombre de usuario/propietario (búsqueda difusa) - `--device-username`: nombre de usuario conectado en el dispositivo (búsqueda difusa) Ejemplos: ```bash # Ver todos los dispositivos en un grupo ./device_group.py --url --token view-devices --name Producción # Buscar por nombre de dispositivo ./device_group.py --url --token view-devices --device-name server # Combinar filtros ./device_group.py --url --token view-devices --name Producción --user-name john ``` - **Agregar dispositivos al grupo:** `./device_group.py --url --token add-devices --name "NombreGrupo" --ids "deviceid1,deviceid2"` - **Quitar dispositivos del grupo:** `./device_group.py --url --token remove-devices --name "NombreGrupo" --ids "deviceid1,deviceid2"` **Parámetro de control de acceso:** - `--accessed-from`: array JSON que define quién puede acceder a este grupo de dispositivos - Type 0 = Grupo de usuarios (ej. `[{"type":0,"name":"Ingenieros"}]`) - Type 2 = Usuario (ej. `[{"type":2,"name":"admin"}]`) **Requisitos de permisos:** - Los comandos `view/add/update/delete/add-devices/remove-devices` requieren **Permiso de Grupo de Dispositivos** - El comando `view-devices` requiere **Permiso de Dispositivo** --- #### Gestión de Dispositivos (`devices.py`) **Mostrar ayuda:** ./devices.py -h **Ver dispositivos:** ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] **Filtros:** --id: ID del dispositivo --device_name: nombre del dispositivo --user_name: usuario asignado --group_name: grupo de usuarios --device_group_name: grupo de dispositivos --offline_days: días sin conexión **Ejemplo:** ./devices.py --url https://example.com --token view --user_name mike **Operaciones:** `view` puede reemplazarse por `enable`, `disable`, `delete`, o `assign`. **Ejemplo (asignar dispositivo):** ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike --- #### Gestión de Libretas de Direcciones (`ab.py`) **Mostrar ayuda:** ./ab.py -h **Ver libretas de direcciones compartidas:** ./ab.py --url --token view-ab [--ab-name ] **Obtener GUID de libreta personal:** ./ab.py --url --token get-personal-ab **Agregar una libreta compartida:** ./ab.py --url --token add-ab --ab-name [--note ] [--password ] **Actualizar o eliminar una libreta compartida:** ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] ./ab.py --url --token delete-ab --ab-guid **Ver peers en una libreta:** ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] **Agregar, actualizar o eliminar un peer:** ./ab.py --url --token add-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token update-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token delete-peer --ab-guid --peer-id **Gestión de etiquetas:** ./ab.py --url --token view-tag --ab-guid ./ab.py --url --token add-tag --ab-guid --tag-name [--tag-color 0xFF00FF00] ./ab.py --url --token update-tag --ab-guid --tag-name --tag-color 0xFFFF0000 ./ab.py --url --token delete-tag --ab-guid --tag-name **Gestión de reglas de acceso:** ./ab.py --url --token view-rule --ab-guid ./ab.py --url --token add-rule --ab-guid [--rule-type user|group|everyone] [--rule-user ] [--rule-group ] --rule-permission ro|rw|full ./ab.py --url --token update-rule --rule-guid --rule-permission rw ./ab.py --url --token delete-rule --rule-guid **Ejemplo (agregar regla de solo lectura para el usuario "mike"):** ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro --- #### Gestión de Estrategias (`strategies.py`) **Mostrar ayuda:** `./strategies.py -h` **Listar todas las estrategias:** `./strategies.py --url --token list` **Ver una estrategia específica:** ```bash # Por nombre ./strategies.py --url --token view --name "Default" # Por GUID ./strategies.py --url --token view --guid "01983006-fcca-7c12-9a91-b1df483c6073" ``` **Habilitar o deshabilitar una estrategia:** ```bash ./strategies.py --url --token enable --name "NombreEstrategia" ./strategies.py --url --token disable --name "NombreEstrategia" ``` **Asignar estrategia a dispositivos, usuarios o grupos de dispositivos:** ```bash # Asignar a dispositivos (por ID de dispositivo) ./strategies.py --url --token assign --name "Default" --peers "1849118658,1337348840" # Asignar a usuarios (por nombre de usuario) ./strategies.py --url --token assign --name "Default" --users "admin,user1" # Asignar a grupos de dispositivos (por nombre de grupo) ./strategies.py --url --token assign --name "Default" --device-groups "device_group1,Production" # Asignación mixta ./strategies.py --url --token assign \ --name "Default" \ --peers "1849118658" \ --users "admin" \ --device-groups "device_group1" ``` **Desasignar estrategia:** ```bash # Desasignar de dispositivos ./strategies.py --url --token unassign --peers "1849118658,1337348840" # Desasignar de usuarios ./strategies.py --url --token unassign --users "admin" # Desasignar de grupos de dispositivos ./strategies.py --url --token unassign --device-groups "device_group1" ``` **Notas:** - El script admite nombres y GUIDs para usuarios y grupos de dispositivos - Los IDs de dispositivos se convierten automáticamente en GUIDs - Todas las operaciones assign/unassign pueden trabajar con múltiples objetivos a la vez **Requisitos de permisos:** - Los comandos `list/view/enable/disable/assign/unassign` requieren **Permiso de Estrategia** - `--peers` requiere **Permiso de Dispositivo:r** (para búsqueda de ID a GUID) - `--users` requiere **Permiso de Usuario:r** (para búsqueda de nombre de usuario a GUID) - `--device-groups` requiere **Permiso de Grupo de Dispositivos:r** (para búsqueda de nombre de grupo a GUID) --- #### Auditorías (`audits.py`) **Mostrar ayuda:** ./audits.py -h **Ver auditorías de conexión:** ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Ver auditorías de archivos:** ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Ver auditorías de alarmas:** ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Ver auditorías de consola:** ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Filtros:** --remote: ID del peer (para auditorías de conexión o archivos) --conn-type: 0=Escritorio Remoto, 1=Transferencia de Archivos, 2=Transferencia de Puertos, 3=Ver Cámara, 4=Terminal --device: ID del dispositivo (para auditorías de alarmas) --operator: nombre de usuario del operador (para auditorías de consola) --created-at: filtro de hora local, por ejemplo, "2025-09-16 14:15:57" --days-ago: filtrar registros más recientes que los días indicados --page-size / --current: paginación **Ejemplo:** ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Buscar un dispositivo 1. Vaya a Dispositivos. 2. En el Campo de Búsqueda de Nombre de Dispositivo escriba el nombre y haga clic en `Consultar` o presione Enter. 3. Para usar un comodín agregue `%` al inicio, final o ambos del término de búsqueda.