Introdução ao OpenSSH para Windows

2025-09-04
Aplica-se a: ✅ Windows Server 2025, ✅ Windows Server 2022, ✅ Windows Server 2019, ✅ Windows 11, ✅ Windows 10

O OpenSSH é uma ferramenta de conectividade para entrada remota que usa o protocolo SSH. Ele criptografa todo o tráfego entre o cliente e o servidor para eliminar interceptações, sequestro de conexão e outros ataques.

Um cliente compatível com OpenSSH pode ser usado para se conectar a dispositivos cliente Windows Server e Windows.

Important

Se você baixou o OpenSSH beta do repositório GitHub no PowerShell/openssh-portal, siga as instruções listadas nele, não as deste artigo. Algumas informações no repositório Win32-OpenSSH referem-se ao produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.

Prerequisites

Antes de começar, certifique-se de que seu computador atenda aos seguintes requisitos:

Um dispositivo que executa pelo menos o Windows Server 2019 ou Windows 10 (build 1809).
PowerShell 5.1 ou posterior.
Uma conta que é membro do grupo de administradores internos.

Verificação de pré-requisitos

Para validar seu ambiente, abra uma sessão do PowerShell com privilégios elevados e faça o seguinte:

Insirawinver.exe e pressione Enter para ver os detalhes da versão do dispositivo Windows.
Execute a $PSVersionTable.PSVersion. Verifique se a versão principal é pelo menos 5 e a versão secundária pelo menos 1. Saiba mais sobre como instalar o PowerShell no Windows.

Para verificar quando você é um administrador, execute o comando a seguir. A saída exibirá True quando você for membro do grupo de administradores interno.

(New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

Habilitar o Servidor OpenSSH

A partir do Windows Server 2025, o OpenSSH agora está instalado por padrão. Você também pode habilitar ou desabilitar o sshd serviço no Gerenciador do Servidor.

GUI
PowerShell

Para habilitar o SSHD usando o Gerenciador do Servidor:

No Gerenciador do Servidor, no painel de navegação à esquerda, selecione Servidor Local.
Na janela Propriedades , localize o Acesso SSH Remoto.
Selecione Desabilitado para habilitar o serviço OpenSSH.

Note

Se você precisar permitir ou restringir usuários ou grupos específicos de usar o OpenSSH para acesso remoto, adicione-os ao grupo de usuários OpenSSH Users .

Para habilitar o SSHD usando o PowerShell:

Abra o PowerShell como administrador e execute o seguinte cmdlet para iniciar o serviço SSHD:
```
# Start the sshd service
Start-Service sshd
```
Você também pode executar o seguinte cmdlet opcional, mas recomendado, para iniciar automaticamente o SSHD para garantir que ele permaneça habilitado:
```
Set-Service -Name sshd -StartupType 'Automatic'
```

Por fim, execute o seguinte comando para verificar se o processo de configuração do SSHD configurou automaticamente a regra de firewall:

if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, creating it..."
    New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
} else {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' has been created and exists."
}

Para instalar os componentes OpenSSH em dispositivos Windows Server:

Selecione Iniciar, digite Recursos Opcionais na caixa de pesquisa e selecione Recursos Opcionais.
Examine a lista para ver se o OpenSSH já está instalado. Caso contrário, na parte superior da página, selecione Recursos de exibição e:
- Pesquise e selecione O Cliente OpenSSH e, em seguida, selecione Adicionar
- Pesquise e selecione o Servidor OpenSSH e, em seguida, selecione Adicionar
Abra o aplicativo Serviços da área de trabalho. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviços ou pressione ENTER.)
No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.
Na guia Geral , no menu suspenso Tipo de inicialização, selecione Automático e, em seguida, selecione Ok.
Para iniciar o serviço, selecione Iniciar.

Note

A instalação do Servidor OpenSSH cria e habilita uma regra de firewall chamada OpenSSH-Server-In-TCP. Essa regra permite o tráfego SSH de entrada na porta 22. Se essa regra não estiver habilitada e essa porta não estiver aberta, as conexões serão recusadas ou redefinidas.

Para instalar o OpenSSH usando o PowerShell:

Execute o PowerShell como um Administrador.

Execute o seguinte cmdlet para se certificar de que o OpenSSH está disponível:

Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'

Esse comando deverá retornar a seguinte saída se nenhum deles estiver instalado:

Name  : OpenSSH.Client~~~~0.0.1.0
State : NotPresent

Name  : OpenSSH.Server~~~~0.0.1.0
State : NotPresent

Depois disso, execute os seguintes cmdlets para instalar os componentes do servidor ou do cliente conforme necessário:

# Install the OpenSSH Client
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Install the OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Ambos os comandos retornarão a seguinte saída:

Path          :
Online        : True
RestartNeeded : False

Para iniciar e configurar o OpenSSH Server para uso inicial, abra um prompt do PowerShell com privilégios elevados, clique com o botão direito do mouse e selecione Executar como administrador, e execute os seguintes comandos para iniciar sshd service:

# Start the sshd service
Start-Service sshd

# OPTIONAL but recommended:
Set-Service -Name sshd -StartupType 'Automatic'

# Confirm the Firewall rule is configured. It should be created automatically by setup. Run the following to verify
if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, creating it..."
    New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
} else {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' has been created and exists."
}

Instalar o OpenSSH Server &Client

GUI
PowerShell

Para instalar os componentes OpenSSH em dispositivos Windows Server:

Selecione Iniciar, digite Recurso Opcional na caixa de pesquisa e, em seguida, selecione Adicionar um recurso opcional.
Examine a lista para ver se o OpenSSH já está instalado. Caso contrário, na parte superior da página, selecione Adicionar um recurso e:
- Pesquise o cliente OpenSSH e selecione Instalar
- Pesquise o Servidor OpenSSH e, em seguida, selecione Instalar
Abra o aplicativo Serviços da área de trabalho. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviços ou pressione ENTER.)
No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.
Na guia Geral , no menu suspenso Tipo de inicialização, selecione Automático e, em seguida, selecione Ok.
Para iniciar o serviço, selecione Iniciar.

Note

Para instalar o OpenSSH usando o PowerShell:

Execute o PowerShell como um Administrador.

Execute o seguinte cmdlet para se certificar de que o OpenSSH está disponível:

Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'

Esse comando deverá retornar a seguinte saída se nenhum deles estiver instalado:

Name  : OpenSSH.Client~~~~0.0.1.0
State : NotPresent

Name  : OpenSSH.Server~~~~0.0.1.0
State : NotPresent

Depois disso, execute os seguintes cmdlets para instalar os componentes do servidor ou do cliente conforme necessário:

# Install the OpenSSH Client
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Install the OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Ambos os comandos retornarão a seguinte saída:

Path          :
Online        : True
RestartNeeded : False

# Start the sshd service
Start-Service sshd

# OPTIONAL but recommended:
Set-Service -Name sshd -StartupType 'Automatic'

# Confirm the Firewall rule is configured. It should be created automatically by setup. Run the following to verify
if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, creating it..."
    New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
} else {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' has been created and exists."
}

Instalar o OpenSSH Server &Client

GUI
PowerShell

Para instalar os componentes OpenSSH em dispositivos Windows Server:

Selecione Iniciar, digite Recursos Opcionais na caixa de pesquisa e selecione Recursos Opcionais (também conhecidos como Gerenciar recursos opcionais).
Examine a lista para ver se o OpenSSH já está instalado. Caso contrário, na parte superior da página, selecione Adicionar um recurso e:
- Pesquise o cliente OpenSSH e selecione Instalar
- Pesquise o Servidor OpenSSH e, em seguida, selecione Instalar
Abra o aplicativo Serviços da área de trabalho. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviços ou pressione ENTER.)
No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.
Na guia Geral , no menu suspenso Tipo de inicialização, selecione Automático e, em seguida, selecione Ok.
Para iniciar o serviço, selecione Iniciar.

Note

Para instalar o OpenSSH usando o PowerShell:

Execute o PowerShell como um Administrador.

Execute o seguinte cmdlet para se certificar de que o OpenSSH está disponível:

Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'

Esse comando deverá retornar a seguinte saída se nenhum deles estiver instalado:

Name  : OpenSSH.Client~~~~0.0.1.0
State : NotPresent

Name  : OpenSSH.Server~~~~0.0.1.0
State : NotPresent

Depois disso, execute os seguintes cmdlets para instalar os componentes do servidor ou do cliente conforme necessário:

# Install the OpenSSH Client
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Install the OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Ambos os comandos retornarão a seguinte saída:

Path          :
Online        : True
RestartNeeded : False

# Start the sshd service
Start-Service sshd

# OPTIONAL but recommended:
Set-Service -Name sshd -StartupType 'Automatic'

# Confirm the Firewall rule is configured. It should be created automatically by setup. Run the following to verify
if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, creating it..."
    New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22
} else {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' has been created and exists."
}

Conectar-se ao Servidor OpenSSH

Uma vez instalado, você poderá se conectar ao Servidor OpenSSH de um dispositivo Windows ou Windows Server com o cliente OpenSSH instalado. Em um prompt do PowerShell, execute o seguinte comando.

ssh ___domain\username@servername

Depois de conectado, você receberá uma mensagem semelhante à seguinte saída.

The authenticity of host 'servername (10.00.00.001)' can't be established.
ECDSA key fingerprint is SHA256:(<a large string>).
Are you sure you want to continue connecting (yes/no)?

Inserir sim adiciona esse servidor à lista de hosts SSH conhecidos em seu cliente Windows.

Neste ponto, o serviço solicita sua senha. Como precaução de segurança, os caracteres da sua senha não são exibidos quando você os digita.

Uma vez conectado, você deverá ver o seguinte prompt do shell de comando do Windows:

___domain\username@SERVERNAME C:\Users\username>

Desabilitar o servidor OpenSSH

Você pode desabilitar o sshd serviço no Gerenciador de Servidores.

GUI
PowerShell

Para desabilitar o SSHD usando o Gerenciador de Servidores:

No Gerenciador do Servidor, no painel de navegação à esquerda, selecione Servidor Local.
Na janela Propriedades , localize o Acesso SSH Remoto.
Selecione Desabilitado para desabilitar o serviço OpenSSH.

Note

Se você precisar permitir ou restringir usuários ou grupos específicos de usar o OpenSSH para acesso remoto, adicione-os ao grupo de usuários OpenSSH Users .

Para desabilitar o SSHD usando o PowerShell:

Abra o PowerShell como administrador e execute o seguinte cmdlet para iniciar o serviço SSHD:
```
# Stop the sshd service
Stop-Service sshd
```
Você também pode executar o seguinte cmdlet opcional, mas recomendado, para iniciar automaticamente o SSHD para garantir que ele permaneça habilitado:
```
Set-Service -Name sshd -StartupType 'Disabled'
```

Por fim, execute o seguinte comando para desabilitar a regra de firewall SSHD padrão:

if ((Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' is being disabled."
    Disable-NetFirewallRule -Name 'OpenSSH-Server-In-TCP'
} else {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, disable failed..."
}

Desinstalar o OpenSSH Server &Client

GUI
PowerShell

Para desinstalar o OpenSSH usando as Configurações do Windows:

Selecione Iniciar, digite Recursos Opcionais na caixa de pesquisa e selecione Recurso opcional.
Examine a lista para ver se o OpenSSH está instalado:
- Pesquise e selecione O Cliente OpenSSH e, em seguida, selecione Remover
- Pesquise e selecione o Servidor OpenSSH e, em seguida, selecione Remover

Para desinstalar os componentes OpenSSH usando o PowerShell, siga estas etapas.

Abra o PowerShell como administrador.

Para remover o OpenSSH, use os seguintes comandos:

# Uninstall the OpenSSH Client
Remove-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Uninstall the OpenSSH Server
Remove-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Por fim, execute o seguinte comando para remover a regra de firewall:

if ((Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' is being removed."
    Remove-NetFirewallRule -Name 'OpenSSH-Server-In-TCP'
} else {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, removal failed..."
}

Desinstalar o OpenSSH Server &Client

GUI
PowerShell

Para desinstalar o OpenSSH usando as Configurações do Windows:

Selecione Iniciar, digite Recursos Opcionais na caixa de pesquisa e selecione Recursos opcionais (também conhecidos como Gerenciar recursos opcionais ou Ver histórico de recursos opcional).
Na lista, selecione OpenSSH Client ou OpenSSH Server.
Selecione Desinstalar.

Para desinstalar os componentes OpenSSH usando o PowerShell, siga estas etapas.

Abra o PowerShell como administrador.

Para remover o OpenSSH, use os seguintes comandos:

# Uninstall the OpenSSH Client
Remove-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Uninstall the OpenSSH Server
Remove-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Por fim, execute o seguinte comando para remover a regra de firewall:

if ((Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    Write-Output "Firewall rule 'OpenSSH-Server-In-TCP' is being removed."
    Remove-NetFirewallRule -Name 'OpenSSH-Server-In-TCP'
} else {
    Write-Output "Firewall Rule 'OpenSSH-Server-In-TCP' does not exist, removal failed..."
}

Se o serviço estava em uso quando você o desinstalou, reinicie o Windows.

Próximas etapas

Agora que você terminou de instalar o OpenSSH Server para o Windows, aqui estão alguns artigos que podem ajudá-lo a aprender como usá-lo:

Saiba mais sobre como usar pares de chaves para autenticação no Gerenciamento de chaves OpenSSH
Saiba mais sobre a Configuração do Servidor OpenSSH para Windows

Compartilhar via

Introdução ao OpenSSH para Windows

Prerequisites

Verificação de pré-requisitos

Habilitar o Servidor OpenSSH

Instalar o OpenSSH Server &Client

Instalar o OpenSSH Server &Client

Instalar o OpenSSH Server &Client

Conectar-se ao Servidor OpenSSH

Desabilitar o servidor OpenSSH

Desinstalar o OpenSSH Server &Client

Desinstalar o OpenSSH Server &Client

Próximas etapas

Comentários

Recursos adicionais