--- title: Console Web weight: 10 --- O console web está integrado no RustDesk Server Pro, servido pela porta `21114`. Recursos: - Navegar dispositivos - Adicionar/modificar usuários e grupos de usuários - Modificar permissões de acesso a dispositivos - Navegar logs de conexão de dispositivos e outros logs - Atualizar configurações - Gerenciar estratégias de sincronização de configurações do cliente - Gerenciar cadernos de endereços compartilhados - Gerar build personalizado do cliente ## Fazer login A porta padrão do console web é 21114. Digite `http://:21114` no navegador para acessar a página do console, conforme mostrado na figura a seguir. O nome de usuário/senha padrão do administrador é `admin`/`test1234`: ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-login.png) Se você precisar de suporte HTTPS, instale um servidor web como `Nginx` ou use `IIS` para Windows. Após fazer login, certifique-se de alterar a senha, selecione `Configurações` no menu da conta no canto superior direito para acessar a página de modificação de senha, conforme mostrado na figura a seguir. Você também pode criar outra conta de administrador e excluir esta. É recomendável habilitar a verificação de login por email. ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2) Usuários não-administradores também podem fazer login para navegar seus dispositivos e logs, alterar suas configurações de usuário. ## Configurações Automáticas Ao clicar em `Windows EXE` você poderá obter as configurações para seu próprio RustDesk Server Pro, isso ajudará a configurar seus clientes. Para clientes Windows, você pode omitir a configuração personalizada do servidor e colocar as informações de configuração no nome do arquivo `rustdesk.exe`. Como mostrado acima, vá para a página de boas-vindas do console e clique em `Windows EXE`. **Cliente ≥ 1.1.9 necessário.** Você pode usar isso em conjunto com [configuração do cliente](https://rustdesk.com/docs/en/self-host/client-configuration/) e [scripts de implantação](https://rustdesk.com/docs/en/self-host/client-deployment/) para configurar seus clientes. ## Criando um novo usuário diferente do usuário padrão `admin` {{% notice note %}} O plano `Individual` não possui este recurso. {{% /notice %}} 1. Clique em `Usuários` no menu da esquerda. 2. Crie outra conta com `administrador` habilitado. 3. Faça login com a nova conta administrativa. 4. Exclua o `admin` na página `Usuários`. ## Criando um novo usuário 1. Clique em `Usuários` no menu da esquerda. 2. Crie um novo usuário. 3. Selecione em qual grupo eles devem estar (se você precisar adicionar novos grupos, continue lendo). ## Adicionar um novo Grupo 1. Clique em `Grupos` no menu da esquerda. 2. Crie um novo grupo. 3. Uma vez criado, você pode permitir que grupos acessem uns aos outros, clique em `Editar`. 4. Selecione os grupos relevantes que você deseja acesso (adiciona automaticamente no grupo correspondente). ## Configurando múltiplos servidores de relay 1. Vá para `Configurações` no menu da esquerda. 2. Clique em `Relay` no submenu. 3. Clique em `+` ao lado de `Servidores Relay`. 4. Digite o endereço DNS ou endereço IP do servidor relay na caixa que agora aparece e pressione Enter. 5. Se você tiver mais de um servidor relay, pode continuar clicando em `+` e adaptando as configurações geográficas se necessário (lembre-se e copie sua chave para os outros servidores). ## Definir ou alterar a licença 1. Vá para `Configurações` no menu da esquerda. 2. Clique em `Licença` no submenu. 3. Clique em `Editar` e cole seu código de licença. 4. Clique em `OK`. ## Visualizando Logs No lado esquerdo, clique em `Logs`. ## Configurar Emails Gmail neste exemplo 1. Vá para `Configurações` no menu da esquerda. 2. Clique em `SMTP` no submenu. 3. Digite o endereço SMTP `smtp.gmail.com`. 4. Digite a Porta 587 em `Porta SMTP`. 5. Digite a conta Gmail, ou seja, `myrustdeskserver@gmail.com` em `Conta de Email`. 6. Digite sua senha (você pode precisar de uma senha de aplicativo). 7. Digite sua conta Gmail, ou seja, `myrustdeskserver@gmail.com` em `De`. 8. Clique em `Verificar` para salvar. ## Atribuindo Usuários/Estratégias/Grupos de Dispositivos a Dispositivos via Console Web 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**. 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. 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. --- ## Token de API Primeiro, você deve ir em **Configurações → Tokens → Criar** e criar um token com as permissões necessárias: **Dispositivo, Registro de Auditoria, Usuário, Grupo, Estratégia, Livro de Endereços**. Depois de criado, você pode usar esses tokens via **linha de comando** ou **CLI Python** para executar ações com as permissões correspondentes. ### Atribuição via Token pelo Linha de Comando Você também pode realizar atribuições usando o executável RustDesk com o parâmetro `--assign`. Isso permite atribuir usuários, estratégias, livros de endereços ou grupos de dispositivos a um dispositivo diretamente da linha de comando. **Exemplo:** "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name Parâmetros suportados | Parâmetro | Descrição | RustDesk Server Pro | RustDesk Client | | --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | | `--user_name ` | Atribui um usuário ao dispositivo | | | | `--strategy_name ` | Atribui uma estratégia ao dispositivo | | | | `--address_book_name ` | Atribui o dispositivo a um livro de endereços | | | | `--address_book_tag ` | Atribui com tag do livro de endereços | | | | `--address_book_alias ` | Atribui com alias do livro de endereços | 1.5.8 | 1.4.1 | | `--address_book_password ` | Define a senha da entrada do livro | 1.6.6 | 1.4.3 | | `--address_book_note ` | Define nota para a entrada do livro | 1.6.6 | 1.4.3 | | `--device_group_name ` | Atribui o dispositivo a um grupo | | | | `--note ` | Adiciona nota ao dispositivo | 1.6.6 | 1.4.3 | | `--device_username ` | Define o nome de usuário do dispositivo | 1.6.6 | 1.4.3 | | `--device_name ` | Define o nome do dispositivo | 1.6.6 | 1.4.3 | A linha de comando no Windows não produz saída por padrão. Para obter saída, execute: "C:\Program Files\RustDesk\rustdesk.exe" ... | more "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String veja [aqui](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952). ### Ferramentas de Gerenciamento Python CLI #### Gerenciamento de Usuários (`users.py`) **Mostrar ajuda:** ./users.py -h **Visualizar usuários:** ./users.py --url --token view [--name ] [--group_name ] **Filtros:** --name : nome do usuário --group_name : grupo de usuários **Exemplo:** ./users.py --url https://example.com --token view --group_name admins **Operações:** `view` pode ser substituído por `enable`, `disable` ou `delete`. **Exemplo (desativar usuário):** ./users.py --url https://example.com --token disable --name testuser --- #### Gerenciamento de Dispositivos (`devices.py`) **Mostrar ajuda:** ./devices.py -h **Visualizar dispositivos:** ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] **Filtros:** --id : ID do dispositivo --device_name : nome do dispositivo --user_name : usuário atribuído --group_name : grupo de usuários --device_group_name : grupo de dispositivos --offline_days : dias offline **Exemplo:** ./devices.py --url https://example.com --token view --user_name mike **Operações:** `view` pode ser substituído por `enable`, `disable`, `delete` ou `assign`. **Exemplo (atribuir dispositivo):** ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike --- #### Gerenciamento de Livro de Endereços (`ab.py`) **Mostrar ajuda:** ./ab.py -h **Visualizar livros de endereços compartilhados:** ./ab.py --url --token view-ab [--ab-name ] **Obter GUID do livro de endereços pessoal:** ./ab.py --url --token get-personal-ab **Adicionar livro de endereços compartilhado:** ./ab.py --url --token add-ab --ab-name [--note ] [--password ] **Atualizar ou deletar livro de endereços compartilhado:** ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] ./ab.py --url --token delete-ab --ab-guid **Visualizar peers em um livro de endereços:** ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] **Adicionar, atualizar ou deletar um peer:** ./ab.py --url --token add-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token update-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token delete-peer --ab-guid --peer-id **Gerenciamento de tags:** ./ab.py --url --token view-tag --ab-guid ./ab.py --url --token add-tag --ab-guid --tag-name [--tag-color 0xFF00FF00] ./ab.py --url --token update-tag --ab-guid --tag-name --tag-color 0xFFFF0000 ./ab.py --url --token delete-tag --ab-guid --tag-name **Gerenciamento de regras de acesso:** ./ab.py --url --token view-rule --ab-guid ./ab.py --url --token add-rule --ab-guid [--rule-type user|group|everyone] [--rule-user ] [--rule-group ] --rule-permission ro|rw|full ./ab.py --url --token update-rule --rule-guid --rule-permission rw ./ab.py --url --token delete-rule --rule-guid **Exemplo (adicionar regra somente leitura para usuário "mike"):** ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro --- #### Auditorias (`audits.py`) **Mostrar ajuda:** ./audits.py -h **Visualizar auditoria de conexões:** ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizar auditoria de arquivos:** ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizar auditoria de alarmes:** ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Visualizar auditoria de console:** ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **Filtros:** --remote : ID do peer (para auditoria de conexão ou arquivos) --conn-type : 0=Desktop Remoto, 1=Transferência de Arquivos, 2=Transferência de Portas, 3=Visualizar Câmera, 4=Terminal --device : ID do dispositivo (para auditoria de alarmes) --operator : nome do operador (para auditoria de console) --created-at : filtro de horário local, ex: "2025-09-16 14:15:57" --days-ago : filtra registros mais recentes do que n dias atrás --page-size / --current : paginação **Exemplo:** ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## Procurando por um dispositivo 1. Vá para Dispositivos. 2. No Campo de Pesquisa de Nome do Dispositivo, digite o nome e clique em `Consultar` ou pressione Enter. 3. Para usar um curinga, adicione `%` no início, fim ou ambos do termo de pesquisa.