---
title: Implantação do Cliente
weight: 400
pre: "<b>2.4. </b>"
description: "Documentação do RustDesk sobre Implantação do Cliente. Consulte guias de instalação, configuração, implantação e solução de problemas."
keywords: ["rustdesk client deployment", "rustdesk powershell deploy", "rustdesk mass deployment", "rustdesk intune", "rustdesk rmm", "rustdesk silent deployment"]
---

<!-- GEO-LOCALIZED-INTRO:START -->

## Resposta rápida

Para implantações em larga escala, use scripts, pacotes MSI ou ferramentas RMM/MDM para que o RustDesk seja instalado automaticamente com a configuração correta do servidor. O melhor método depende principalmente do sistema operacional e da pilha de gerenciamento que você já usa.

## Pontos principais

- Host do servidor ou endereço de `ID Server`
- Chave pública do servidor auto-hospedado
- `API Server` opcional para login Pro
- Uma string de configuração ou método de empacotamento compatível com seu ferramental

<!-- GEO-LOCALIZED-INTRO:END -->

A maneira mais simples é usar um cliente personalizado, https://twitter.com/rustdesk/status/1788905463678951787.

Você pode implantar usando vários métodos, alguns são cobertos em [Configuração do Cliente](https://rustdesk.com/docs/en/self-host/client-configuration/).

Alternativamente, você pode usar scripts de implantação em massa com seu RMM, Intune, etc. O ID e a senha são outputados pelo script. Você deve coletar isso ou dividi-lo em scripts diferentes para coletar o ID e a senha.

A senha permanente pode ser alterada de aleatória para uma de sua preferência modificando o conteúdo dentro de `()` após `rustdesk_pw` para sua senha preferida para PowerShell e a linha correspondente para qualquer outra plataforma.

## PowerShell

```powershell
$ErrorActionPreference= 'silentlycontinue'

# Atribuir o valor da senha aleatória à variável senha
$rustdesk_pw=(-join ((65..90) + (97..122) | Get-Random -Count 12 | % {[char]$_}))

# Obtenha sua string de configuração do seu portal Web e preencha abaixo
$rustdesk_cfg="configstring"

################################## Por favor não edite abaixo desta linha #########################################

# Executar como administrador e permanecer no diretório atual
if (-Not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))
{
    if ([int](Get-CimInstance -Class Win32_OperatingSystem | Select-Object -ExpandProperty BuildNumber) -ge 6000)
    {
        Start-Process PowerShell -Verb RunAs -ArgumentList "-NoProfile -ExecutionPolicy Bypass -Command `"cd '$pwd'; & '$PSCommandPath';`"";
        Exit;
    }
}

# Esta função retornará a última versão e link de download como um objeto
function getLatest()
{
    $Page = Invoke-WebRequest -Uri 'https://github.com/rustdesk/rustdesk/releases/latest' -UseBasicParsing
    $HTML = New-Object -Com "HTMLFile"
    try
    {
        $HTML.IHTMLDocument2_write($Page.Content)
    }
    catch
    {
        $src = [System.Text.Encoding]::Unicode.GetBytes($Page.Content)
        $HTML.write($src)
    }

    # Link de exemplo atual: https://github.com/rustdesk/rustdesk/releases/download/1.2.6/rustdesk-1.2.6-x86_64.exe
    $Downloadlink = ($HTML.Links | Where {$_.href -match '(.)+\/rustdesk\/rustdesk\/releases\/download\/\d{1}.\d{1,2}.\d{1,2}(.{0,3})\/rustdesk(.)+x86_64.exe'} | select -first 1).href

    # correção de bug - às vezes você precisa substituir "about:"
    $Downloadlink = $Downloadlink.Replace('about:', 'https://github.com')

    $Version = "unknown"
    if ($Downloadlink -match './rustdesk/rustdesk/releases/download/(?<content>.*)/rustdesk-(.)+x86_64.exe')
    {
        $Version = $matches['content']
    }

    if ($Version -eq "unknown" -or $Downloadlink -eq "")
    {
        Write-Output "ERRO: Versão ou link de download não encontrado."
        Exit
    }

    # Criar objeto para retornar
    $params += @{Version = $Version}
    $params += @{Downloadlink = $Downloadlink}
    $Result = New-Object PSObject -Property $params

    return($Result)
}

$RustDeskOnGitHub = getLatest


$rdver = ((Get-ItemProperty  "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RustDesk\").Version)

if ($rdver -eq $RustDeskOnGitHub.Version)
{
    Write-Output "RustDesk $rdver é a versão mais recente."
    Exit
}

if (!(Test-Path C:\Temp))
{
    New-Item -ItemType Directory -Force -Path C:\Temp | Out-Null
}

cd C:\Temp

Invoke-WebRequest $RustDeskOnGitHub.Downloadlink -Outfile "rustdesk.exe"
Start-Process .\rustdesk.exe --silent-install
Start-Sleep -seconds 20

$ServiceName = 'Rustdesk'
$arrService = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue

if ($arrService -eq $null)
{
    Write-Output "Instalando serviço"
    cd $env:ProgramFiles\RustDesk
    Start-Process .\rustdesk.exe --install-service
    Start-Sleep -seconds 20
    $arrService = Get-Service -Name $ServiceName
}

while ($arrService.Status -ne 'Running')
{
    Start-Service $ServiceName
    Start-Sleep -seconds 5
    $arrService.Refresh()
}

cd $env:ProgramFiles\RustDesk\
.\rustdesk.exe --get-id | Write-Output -OutVariable rustdesk_id

.\rustdesk.exe --config $rustdesk_cfg

.\rustdesk.exe --password $rustdesk_pw

Write-Output "..............................................."
# Mostrar o valor da variável ID
Write-Output "ID RustDesk: $rustdesk_id"

# Mostrar o valor da variável senha
Write-Output "Senha: $rustdesk_pw"
Write-Output "..............................................."
```

## Windows batch/cmd

```bat
@echo off

REM Atribuir o valor da senha aleatória à variável senha
setlocal ENABLEEXTENSIONS ENABLEDELAYEDEXPANSION
set alfanum=ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
set rustdesk_pw=
for /L %%b in (1, 1, 12) do (
    set /A rnd_num=!RANDOM! %% 62
    for %%c in (!rnd_num!) do (
        set rustdesk_pw=!rustdesk_pw!!alfanum:~%%c,1!
    )
)

REM Obtenha sua string de configuração do seu portal Web e preencha abaixo
set rustdesk_cfg="configstring"

REM ############################### Por favor não edite abaixo desta linha #########################################

if not exist C:\Temp\ md C:\Temp\
cd C:\Temp\

curl -L "https://github.com/rustdesk/rustdesk/releases/download/1.2.6/rustdesk-1.2.6-x86_64.exe" -o rustdesk.exe

rustdesk.exe --silent-install
timeout /t 20

cd "C:\Program Files\RustDesk\"
rustdesk.exe --install-service
timeout /t 20

for /f "delims=" %%i in ('rustdesk.exe --get-id ^| more') do set rustdesk_id=%%i

rustdesk.exe --config %rustdesk_cfg%

rustdesk.exe --password %rustdesk_pw%

echo ...............................................
REM Mostrar o valor da variável ID
echo ID RustDesk: %rustdesk_id%

REM Mostrar o valor da variável senha
echo Senha: %rustdesk_pw%
echo ...............................................
```

## MSI

Você também pode usar msi em vez de `rustdesk.exe --silent-install`.

https://rustdesk.com/docs/en/client/windows/msi/


## macOS Bash

```sh
#!/bin/bash

# Atribuir o valor da senha aleatória à variável senha
rustdesk_pw=$(openssl rand -hex 4)

# Obtenha sua string de configuração do seu portal Web e preencha abaixo
rustdesk_cfg="configstring"

################################## Por favor não edite abaixo desta linha #########################################

# Solicitação de senha de root para elevação de privilégio
[ "$UID" -eq 0 ] || exec sudo bash "$0" "$@"

# Especificar o ponto de montagem para o DMG (diretório temporário)
mount_point="/Volumes/RustDesk"

# Baixar o arquivo rustdesk.dmg
echo "Baixando RustDesk agora"

if [[ $(arch) == 'arm64' ]]; then
    rd_link=$(curl -sL https://github.com/rustdesk/rustdesk/releases/latest | grep -Eo "(http|https)://[a-zA-Z0-9./?=_-]*/\d{1}.\d{1,2}.\d{1,2}/rustdesk.\d{1}.\d{1,2}.\d{1,2}.aarch64.dmg")
    dmg_file=$(echo $rd_link | grep -Eo "rustdesk.\d{1}.\d{1,2}.\d{1,2}.aarch64.dmg")
    curl -L "$rd_link" --output "$dmg_file"
else
    rd_link=$(curl -sL https://github.com/rustdesk/rustdesk/releases/latest | grep -Eo "(http|https)://[a-zA-Z0-9./?=_-]*/\d{1}.\d{1,2}.\d{1,2}/rustdesk.\d{1}.\d{1,2}.\d{1,2}.x86_64.dmg")
    dmg_file=$(echo $rd_link | grep -Eo "rustdesk.\d{1}.\d{1,2}.\d{1,2}.x86_64.dmg")
    curl -L "$rd_link" --output "$dmg_file"
fi

# Montar o arquivo DMG no ponto de montagem especificado
hdiutil attach "$dmg_file" -mountpoint "$mount_point" &> /dev/null

# Verificar se a montagem foi bem-sucedida
if [ $? -eq 0 ]; then
    # Mover o conteúdo do DMG montado para a pasta /Applications
    cp -R "$mount_point/RustDesk.app" "/Applications/" &> /dev/null

    # Desmontar o arquivo DMG
    hdiutil detach "$mount_point" &> /dev/null
else
    echo "Falha ao montar o DMG do RustDesk. Instalação abortada."
    exit 1
fi

# Executar o comando rustdesk com --get-id e armazenar a saída na variável rustdesk_id
cd /Applications/RustDesk.app/Contents/MacOS/
rustdesk_id=$(./RustDesk --get-id)

# Aplicar nova senha ao RustDesk
./RustDesk --server &
/Applications/RustDesk.app/Contents/MacOS/RustDesk --password $rustdesk_pw &> /dev/null

/Applications/RustDesk.app/Contents/MacOS/RustDesk --config $rustdesk_cfg

# Matar todos os processos chamados RustDesk
rdpid=$(pgrep RustDesk)
kill $rdpid &> /dev/null

echo "..............................................."
# Verificar se rustdesk_id não está vazio
if [ -n "$rustdesk_id" ]; then
    echo "ID RustDesk: $rustdesk_id"
else
    echo "Falha ao obter o ID do RustDesk."
fi

# Mostrar o valor da variável senha
echo "Senha: $rustdesk_pw"
echo "..............................................."

echo "Por favor complete a instalação na GUI, lançando RustDesk agora."
open -n /Applications/RustDesk.app
```

## Linux

```sh
#!/bin/bash

# Atribuir um valor aleatório à variável senha
rustdesk_pw=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 8 | head -n 1)

# Obtenha sua string de configuração do seu portal Web e preencha abaixo
rustdesk_cfg="configstring"

################################## Por favor não edite abaixo desta linha #########################################

# Verificar se o script está sendo executado como root
if [[ $EUID -ne 0 ]]; then
    echo "Este script deve ser executado como root."
    exit 1
fi

# Identificar OS
if [ -f /etc/os-release ]; then
    # freedesktop.org e systemd
    . /etc/os-release
    OS=$NAME
    VER=$VERSION_ID

    UPSTREAM_ID=${ID_LIKE,,}

    # Retornar para ID_LIKE se ID não era 'ubuntu' ou 'debian'
    if [ "${UPSTREAM_ID}" != "debian" ] && [ "${UPSTREAM_ID}" != "ubuntu" ]; then
        UPSTREAM_ID="$(echo ${ID_LIKE,,} | sed s/\"//g | cut -d' ' -f1)"
    fi

elif type lsb_release >/dev/null 2>&1; then
    # linuxbase.org
    OS=$(lsb_release -si)
    VER=$(lsb_release -sr)
elif [ -f /etc/lsb-release ]; then
    # Para algumas versões do Debian/Ubuntu sem o comando lsb_release
    . /etc/lsb-release
    OS=$DISTRIB_ID
    VER=$DISTRIB_RELEASE
elif [ -f /etc/debian_version ]; then
    # Debian mais antigo, Ubuntu, etc.
    OS=Debian
    VER=$(cat /etc/debian_version)
elif [ -f /etc/SuSE-release ]; then
    # SuSE mais antigo etc.
    OS=SuSE
    VER=$(cat /etc/SuSE-release)
elif [ -f /etc/redhat-release ]; then
    # Red Hat mais antigo, CentOS, etc.
    OS=RedHat
    VER=$(cat /etc/redhat-release)
else
    # Retornar para uname, ex. "Linux <version>", também funciona para BSD, etc.
    OS=$(uname -s)
    VER=$(uname -r)
fi

# Instalar RustDesk

echo "Instalando RustDesk"
if [ "${ID}" = "debian" ] || [ "$OS" = "Ubuntu" ] || [ "$OS" = "Debian" ] || [ "${UPSTREAM_ID}" = "ubuntu" ] || [ "${UPSTREAM_ID}" = "debian" ]; then
    wget https://github.com/rustdesk/rustdesk/releases/download/1.2.6/rustdesk-1.2.6-x86_64.deb
    apt-get install -fy ./rustdesk-1.2.6-x86_64.deb > /dev/null
elif [ "$OS" = "CentOS" ] || [ "$OS" = "RedHat" ] || [ "$OS" = "Fedora Linux" ] || [ "${UPSTREAM_ID}" = "rhel" ] || [ "$OS" = "Almalinux" ] || [ "$OS" = "Rocky*" ] ; then
    wget https://github.com/rustdesk/rustdesk/releases/download/1.2.6/rustdesk-1.2.6-0.x86_64.rpm
    yum localinstall ./rustdesk-1.2.6-0.x86_64.rpm -y > /dev/null
else
    echo "SO não suportado"
    # aqui você pode perguntar ao usuário permissão para tentar instalar mesmo assim
    # se eles disserem sim, então faça a instalação
    # se eles disserem não, saia do script
    exit 1
fi

# Executar o comando rustdesk com --get-id e armazenar a saída na variável rustdesk_id
rustdesk_id=$(rustdesk --get-id)

# Aplicar nova senha ao RustDesk
rustdesk --password $rustdesk_pw &> /dev/null

rustdesk --config $rustdesk_cfg

systemctl restart rustdesk

echo "..............................................."
# Verificar se rustdesk_id não está vazio
if [ -n "$rustdesk_id" ]; then
    echo "ID RustDesk: $rustdesk_id"
else
    echo "Falha ao obter o ID do RustDesk."
fi

# Mostrar o valor da variável senha
echo "Senha: $rustdesk_pw"
echo "..............................................."
```

## Implantação explícita para novos dispositivos

Por padrão, um cliente RustDesk é registrado no servidor auto-hospedado quando se conecta ao servidor pela primeira vez. No modo normal, nenhuma etapa extra de implantação é necessária.

Se você habilitar **Configurações → Outros → Exigir implantação para novos dispositivos** no console web do servidor, os novos dispositivos deverão ser implantados explicitamente antes de poderem se registrar neste servidor.

Crie um [token de API](/docs/en/self-host/rustdesk-server-pro/console/#api-token) no console web do servidor com uma conta de administrador. O token deve ter a permissão **Dispositivos** definida como **Leitura e gravação**. Em seguida, execute o comando de implantação em cada novo dispositivo desktop depois que o RustDesk tiver sido instalado e configurado para usar seu servidor auto-hospedado.

### Windows, macOS e Linux

No Windows, execute o Prompt de Comando ou o PowerShell como administrador:

```bat
rustdesk --deploy --token <api_token>
```

No macOS e Linux, execute o comando com `sudo`:

```sh
sudo rustdesk --deploy --token <api_token>
```

### ID personalizado opcional

Para implantar o dispositivo com um ID RustDesk específico, adicione `--id <custom_id>`:

```sh
rustdesk --deploy --token <api_token> --id <custom_id>
```

Se o ID já estiver sendo usado por outra máquina, a implantação falhará e o RustDesk informará que o ID já está em uso.

### Android

O Android não usa o fluxo de implantação por linha de comando. Quando o servidor exige implantação e o cliente Android ainda não foi implantado, o RustDesk mostra um prompt **Deploy**. Toque em **OK**, insira o token de API na caixa de diálogo de implantação e, opcionalmente, insira um ID personalizado. Você também pode abrir a mesma caixa de diálogo manualmente em **Configurações → Deploy**.

Depois que a implantação for bem-sucedida, o dispositivo será adicionado à lista de dispositivos do servidor e o cliente poderá se registrar normalmente.
