Introdução ao OpenSSH para Windows

• Aplica-se a:

  ✅ Windows Server 2025, ✅ Windows Server 2022, ✅ Windows Server 2019, ✅ Windows Server 2016

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.

Importante

Se você baixou a versão beta do OpenSSH do repositório GitHub em PowerShell/Win32-OpenSSH, siga as instruções listadas nele, não as que estão neste artigo. Algumas informações no repositório Win32-OpenSSH estão relacionadas a produtos de pré-lançamento que poderão ser substancialmente modificados antes do lançamento. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.

Pré-requisitos

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:

• Insira winver.exe e pressione Enter para ver os detalhes da versão do seu dispositivo Windows.

• Execute $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.

• 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 OpenSSH para Windows Server 2025

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

GUI

Para habilitar o SSHD usando o Gerenciador do Servidor:

1. No Gerenciador do Servidor no painel de navegação à esquerda selecione Servidor Local.

2. Na janela Propriedades, localize Acesso SSH Remoto.

3. Selecione Desabilitado para habilitar o serviço OpenSSH.

Observação

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

PowerShell

Para habilitar o SSHD usando o PowerShell:

1. Abra o PowerShell como administrador e execute o seguinte cmdlet para iniciar o serviço SSHD:

   # Start the sshd service
   Start-Service sshd
   

2. 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'
   

3. 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 | Select-Object Name, Enabled)) {
       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."
   }
   

Instalação do OpenSSH para Windows Server

GUI

Para instalar os componentes OpenSSH em dispositivos Windows 10:

1. Abra Configurações, selecione Sistema e Recursos Opcionais.

2. 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:

   • Encontre Cliente do OpenSSH e selecione Instalar

   • Encontre Servidor do OpenSSH e selecione Instalar

3. Abra o aplicativo da área de trabalho de Serviços. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviço ou pressione ENTER.)

4. No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.

5. Na guia Geral, no menu suspenso Tipo de inicialização, selecione Automático e depois OK.

6. Para iniciar o serviço, selecione Iniciar.

Para instalar os componentes OpenSSH em dispositivos Windows 11:

1. Abra Configurações, selecione Sistema e Recursos Opcionais.

2. Examine a lista para ver se o OpenSSH já está instalado. Caso contrário, na parte superior da página, selecione Visualizar recursos. Em seguida:

   • Procure por OpenSSH Client, selecione Avançar e depois selecione Instalar

   • Procure por OpenSSH Server, selecione Avançar e depois selecione Instalar

3. Abra o aplicativo da área de trabalho de Serviços. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviço ou pressione ENTER.)

4. No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.

5. Na guia Geral, no menu suspenso Tipo de inicialização, selecione Automático e depois OK.

6. Para iniciar o serviço, selecione Iniciar.

Para instalar os componentes OpenSSH em dispositivos Windows Server:

1. Abra Configurações, selecione Sistema, depois selecione Recursos Opcionais (também conhecido como Gerenciador de recursos opcionais).

2. 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:

   • Procure OpenSSH Client e selecione Instalar

   • Procure OpenSSH Server e selecione Instalar

3. Abra o aplicativo da área de trabalho de Serviços. (Selecione Iniciar, digite services.msc na caixa de pesquisa e selecione o aplicativo Serviço ou pressione ENTER.)

4. No painel de detalhes, clique duas vezes em Servidor OpenSSH SSH.

5. Na guia Geral, no menu suspenso Tipo de inicialização, selecione Automático e depois OK.

6. Para iniciar o serviço, selecione Iniciar.

Observação

A instalação do Servidor OpenSSH criará e habilitará uma regra de firewall chamada OpenSSH-Server-In-TCP. Isso 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.

PowerShell

Para instalar o OpenSSH usando o PowerShell:

1. Execute o PowerShell como um Administrador.

2. 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
   

3. 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
   

4. 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 | Select-Object Name, Enabled)) {
       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)?

Ao inserir Sim, você adiciona esse servidor à lista de hosts SSH conhecidos no 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>

Desinstalar o OpenSSH para Windows

GUI

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

1. Abra Configurações, selecione Sistema, depois selecione Recursos Opcionais (também conhecido como Gerenciador de recursos opcionais).

2. Na lista, selecione Cliente OpenSSH ou Servidor OpenSSH.

3. Selecione Desinstalar.

PowerShell

Para desinstalar os componentes do OpenSSH usando o PowerShell, 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

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