Instalação do DWAgent

Para usuários avançados.

O DWAgent é o componente principal do DWService, uma solução gratuita e de código aberto para acesso remoto, administração e suporte a dispositivos via navegador web. Este manual guia você através dos passos para instalar e configurar o DWAgent em diferentes sistemas operacionais: Windows, Linux e macOS.

Pré-requisitos

Uma conta no DWService (crie uma gratuitamente em https://www.dwservice.net/pt_BR/home.html).
Conexão com internet no dispositivo onde o agente será instalado.
Direitos de administrador no sistema.

Criando uma Conta no DWService

Acesse o site https://www.dwservice.net/pt_BR/home.html.
Clique em "Ainda não está registrado? Registre-se aqui.".
Preencha os campos com seu e-mail, senha e outras informações solicitadas.
Confirme o e-mail de verificação enviado para sua caixa de entrada.
Faça login na sua conta.

Use uma senha forte. O DWService não armazena senhas em texto plano para maior segurança.

Adicionando um Agente no Painel

Antes de instalar, registre um agente no seu dashboard:

No painel do DWService (após login), clique em "Adicionar Agente" ou vá para a seção de agentes.
Escolha o método de instalação:
- Com Código de Instalação (Installation Code): Recomendado para instalações manuais. O sistema gera um código numérico único.
- Com Credenciais (Credentials): Configure um usuário (seu e-mail) e uma senha de instalação separada (não use a senha da conta para segurança).
Anote o código ou credenciais gerados – você precisará deles durante a instalação.

Para credenciais, acesse Configurações > Credenciais no painel e defina uma senha de instalação diferente da senha da conta.

Baixando o DWAgent

No painel do DWService, vá para a página de Download (ou acesse diretamente https://www.dwservice.net/download.html).
Selecione a versão correspondente ao seu sistema operacional:
- Windows: dwagent.exe
- Linux: dwagent.sh
- macOS: dwagent.dmg
Clique em Download e salve o arquivo no dispositivo alvo.

Instalação por Sistema Operacional

Instalação no Windows

Método com Código de Instalação

Execute o arquivo dwagent.exe baixado (clique duplo).
Um assistente (wizard) será aberto. Clique em Next para prosseguir.
Aceite os termos de licença e clique em Next.
Escolha o diretório de instalação (padrão: C:\Program Files\DWAgent) e clique em Next.
Selecione "Creating a new agent" e clique em Next.
Insira o Código de Instalação gerado no Passo 2.
Clique em Next e aguarde a instalação.
Ao final, um ícone DWAgent Monitor aparecerá na barra de tarefas. Clique nele para verificar o status (deve mostrar "Online").

Método com Credenciais

Siga os passos acima até selecionar "Creating a new agent".
Insira:
- Usuário: Seu e-mail da conta DWService.
- Senha: A senha de instalação configurada nas credenciais.
Prossiga com Next e finalize.

Instalação Silenciosa (para scripts ou GPO): use:

Comando de instalação silenciosa (Windows)

(substitua SEU_CODIGO pelo código de instalação)

Instalação no Linux (Console ou GUI)

Método com Código de Instalação (Console)

cd ~/Downloads
wget -N https://www.dwservice.net/download/dwagent.sh
chmod +x dwagent.sh
sudo bash dwagent.sh -console
# Siga o assistente: confirme caminho (padrão /usr/share/dwagent), selecione opções e insira o Código de Instalação
# Verifique o status:
systemctl status dwagent

Método com GUI (se disponível)

Execute:

sudo bash dwagent.sh

Siga o assistente gráfico, inserindo o código conforme solicitado.

Método com Credenciais (Console)

Baixe e torne o script executável conforme acima.
No assistente, escolha a opção para criar um novo agente com credenciais e insira e-mail e senha de instalação.

O DWAgent roda como root por padrão. Para rodar como usuário não-root, edite o serviço systemd após instalação:

sudo systemctl edit dwagent

Instalação no macOS

Método com Código de Instalação

Abra o arquivo dwagent.dmg baixado.
Arraste o app para a pasta Aplicações.
Abra o Terminal e execute:

sudo /Applications/DWAgent.app/Contents/MacOS/Install

No assistente:
- Escolha o caminho (padrão: /Library/DWAgent).
- Selecione "Creating a new agent".
- Insira o Código de Instalação.
Conceda permissões:
- Vá para Preferências do Sistema > Privacidade e Segurança > Acessibilidade.
- Adicione /Library/DWAgent/native/DWAgentSvc.app à lista e ative.

Método com Credenciais

Siga os passos acima, mas insira e-mail e senha de instalação no lugar do código.

Instalação Silenciosa (macOS): crie um script dwagent.sh com o conteúdo abaixo e execute com sudo sh dwagent.sh:

dwagent.sh (exemplo de instalação silenciosa macOS)

(substitua SEU_CODIGO pelo código de instalação)

Configuração Inicial e Conexão

Após a instalação, o DWAgent deve iniciar automaticamente e se conectar ao servidor DWService (verifique o ícone do monitor: verde para online).
No painel web do DWService, o agente aparecerá na lista de dispositivos.
Para configurar opções avançadas:
- Clique no agente no painel > Configurar.
- Ajuste idioma, notificações, aplicações disponíveis (ex: Tela, Arquivos, Processos).
- Defina grupos para organização (útil para múltiplos agentes).
Para conectar remotamente:
- No navegador, acesse https://www.dwservice.net e faça login.
- Selecione o agente e inicie a sessão (controle de tela, arquivos, etc).

Aplicações Disponíveis: dependendo do SO, você terá acesso a Tela Remota, Gerenciador de Arquivos, Terminal, Monitor de Logs, etc.

Solução de Problemas

Agente offline

Verifique firewall (portas 80/443), antivírus e conexão de internet.
Reinicie o serviço:
- Windows: abra Services (services.msc) e reinicie o serviço DWAgent.
- Linux: sudo systemctl restart dwagent
- macOS: reinicie via launchctl.

Erro de código/credenciais

Gere um novo código/credenciais no painel do DWService e reinstale.

Permissões negadas (macOS)

Reative permissões em Preferências do Sistema > Privacidade e Segurança e adicione o componente nativo do DWAgent à lista de Acessibilidade/Automação conforme necessário.

Logs

Consulte logs para depuração:
- Windows: C:\Program Files\DWAgent\logs
- Linux: /usr/share/dwagent/logs

Instalação Avançada

Silenciosa em Massa: use scripts com parâmetros -silent para deploy em rede.
Integração API: para desenvolvedores, consulte https://docs.dwservice.net/docs/site/developer/.
Sem Instalação: opção de agente portátil disponível no download.

Para mais detalhes, consulte a documentação oficial: https://docs.dwservice.net/docs/site/dwservice-installation/how-do-i-install-the-agent/.

Este manual é baseado na documentação oficial do DWService (versão atual em outubro de 2025). Atualize conforme novas versões. Se precisar de suporte, contate a equipe via site.

AnteriorInstalação SPTRemote PróximoDWService API