Como corrigir o problema da interface gráfica do YaST não iniciar via SSH com encaminhamento X11

Se a janela gráfica do YaST falhar via SSH, verifique primeiro se o encaminhamento X11 está funcionando. No computador cliente, conecte-se com `yast -r` ssh -X admin@server, e teste outro programa gráfico remoto. Se esse programa abrir, mas o YaST exibir XIO: fatal IO error 11uma mensagem como `\n` localhost:11.0, a SUSE documenta uma solução alternativa específica: execute o comando afetado do YaST com `-r` QT_XCB_GL_INTEGRATION=noneantes dele. Por exemplo, use `yast QT_XCB_GL_INTEGRATION=none yast2 disk-r`. Essa solução alternativa se aplica a falhas de encaminhamento do Qt/OpenGL; ela não corrigirá um servidor X local ausente, um `X11` não configurado DISPLAY, encaminhamento de servidor bloqueado ou um módulo do YaST não instalado.

Comece com as verificações mais rápidas.

A interface gráfica do YaST requer um monitor X no lado do cliente e um túnel SSH X11 funcional. O cliente SSH define um DISPLAYvalor de encaminhamento no host remoto quando o encaminhamento está ativo. Um login SSH simples ainda pode funcionar mesmo quando os gráficos não estão encaminhados, portanto, uma sessão de terminal bem-sucedida por si só não confirma o X11.

1. Certifique-se de que o computador cliente tenha um servidor X ativo ou uma sessão de exibição compatível com X11. No Windows, a SUSE documenta a ativação do encaminhamento X11 no PuTTY em Conexão > SSH > X11 ; um servidor X local também deve estar disponível.
2. Reconecte com o encaminhamento ativado: ssh -X admin@server. Use sua conta e nome de host reais.
3. No shell remoto, verifique echo "$DISPLAY". Com um display encaminhado, ele normalmente deve mostrar um valor como localhost:10.0ou localhost:11.0. Um valor em branco significa que a sessão não estabeleceu o encaminhamento X11.
4. Inicie um pequeno aplicativo X instalado no sistema remoto. Se ele não abrir na sua área de trabalho local, corrija o encaminhamento antes de solucionar problemas no YaST.

Por exemplo, um administrador que se conecta de uma estação de trabalho Linux pode usar o comando ssh -X ops@server.example`yast -v`, e então executar um aplicativo de teste disponível. Se a janela do aplicativo aparecer localmente, o túnel SSH e a exibição local estão funcionando. Caso contrário, um erro como "Não foi possível abrir o display" indica um problema no caminho do X11, e não uma solução alternativa gráfica específica do YaST.

Aplique a solução alternativa específica do YaST da SUSE.

O Guia de Implantação do SLES 15 SP7 da SUSE documenta um caso em que a GUI do YaST via SSH com encaminhamento X falha com `--disable XIO: fatal IO error 11 (Resource temporarily unavailable)-open` localhost:11.0. A solução recomendada é desativar a integração XCB GL do Qt para esse comando específico. Execute o comando para o módulo desejado, por exemplo:

QT_XCB_GL_INTEGRATION=none yast2 disk

Para a interface de instalação do YaST, o mesmo guia fornece este exemplo:

QT_XCB_GL_INTEGRATION=none yast.ssh

Use o comando que corresponde à sua tarefa; ` yast2 disk--disk` abre o módulo de disco, enquanto ` yast.ssh--install` é exibido para o fluxo de trabalho de instalação. Prefixar um único comando mantém a configuração limitada àquela execução. Não o adicione permanentemente a um perfil de shell global, a menos que você tenha um motivo específico para alterar o comportamento do Qt para outros programas.

Essa correção é especialmente relevante quando o próprio X11 funciona, mas o YaST é encerrado ou exibe o erro XIO específico. Se o mesmo erro persistir, teste um módulo diferente e revise a configuração de encaminhamento do cliente e do servidor. Outras falhas gráficas podem ter causas diferentes; a solução alternativa do SUSE não é uma cura geral para todos os problemas de Qt, GPU ou exibição.

Verifique o servidor SSH quando a tela estiver vazia.

No servidor SUSE, o encaminhamento X11 deve ser permitido pela configuração do daemon SSH. Um administrador pode inspecionar /etc/ssh/sshd_confige confirmar se a configuração efetiva inclui:

X11Forwarding yes

A política do servidor também pode ser fornecida por meio de arquivos de configuração incluídos ou gerenciada centralmente; portanto, não presuma que editar uma única linha seja suficiente. Após uma alteração autorizada, valide a configuração e reinicie o serviço.

sudo sshd -t
sudo systemctl reload sshd.service

Mantenha a sessão SSH atual aberta enquanto verifica a configuração e teste um segundo login antes de fechá-la. Uma verificação de sintaxe detecta configurações malformadas, mas não garante que a política esteja correta ou que o encaminhamento funcione a partir do cliente. Se você não administra o servidor SSH, peça ao administrador para verificar a política em vigor em vez de editar os arquivos do sistema você mesmo.

Reconecte após qualquer alteração no servidor e repita os DISPLAYtestes de aplicativo remoto. Se o servidor reportar um problema de autorização, verifique se o usuário remoto possui uma entrada de autorização X válida xauth list. Evite copiar cookies de autorização manualmente ou enfraquecer os controles de acesso de exibição para abrir a janela.

Execute o YaST com privilégios de administrador sem perder a visualização.

O YaST altera as configurações do sistema e geralmente requer autorização administrativa. Uma fonte comum de confusão é que o usuário sem privilégios consegue exibir uma janela de teste, mas o YaST falha após a elevação de privilégios. O processo com privilégios elevados pode não reter os DISPLAYdados de autorização encaminhados ou os dados de autorização X necessários para se conectar a ele.

Use o método de elevação de privilégios aprovado pela sua organização e verifique o que o processo do YaST recebe. Não habilite o login SSH direto como root apenas para obter uma interface gráfica; as diretrizes de segurança da SUSE recomendam fazer login como um usuário sem privilégios e usar sudoo comando `sudo` para executar comandos de root. Se a sua política de sudo filtrar intencionalmente variáveis ​​de ambiente relacionadas à exibição, solicite a um administrador que forneça um método aprovado com escopo restrito. Evite regras ou comandos de preservação de ambiente abrangentes que exponham a exibição local a todos os usuários do host.

A distinção diagnóstica relevante é simples: se um aplicativo X for aberto com sua conta normal, mas o YaST falhar apenas quando os privilégios forem elevados, concentre-se na transferência de privilégios e autorizações. Se ambos falharem com a conta normal, retorne ao cliente SSH, ao servidor X local e às configurações de encaminhamento de servidor.

Escolha a interface de texto quando os gráficos forem desnecessários.

O encaminhamento X11 é útil quando um fluxo de trabalho específico realmente exige a interface gráfica, mas adiciona dependências e pode parecer lento em conexões de alta latência. O YaST também fornece uma interface de texto ncurses para sessões de terminal. A SUSE documenta como forçá-lo para o módulo de disco com:

yast2 disk --ncurses

Essa é uma opção prática em um servidor sem interface gráfica, quando o cliente não possui um servidor X ou quando a sessão gráfica está instável. Você também pode executar módulos do YaST a partir da linha de comando, sempre que as opções disponíveis permitirem. Verifique a lista de módulos com `yast list` yast -le consulte a ajuda do módulo em questão, em vez de presumir que todos os módulos gráficos possuem operações equivalentes na linha de comando.

Guia de sintomas e ação

Notas de segurança e versão

O encaminhamento X11 é mais do que uma mera conveniência visual: programas gráficos remotos comunicam-se com a tela do cliente. Use-o apenas com sistemas nos quais você confia. O OpenSSH distingue o encaminhamento não confiável (untrusted forwarding) -Xdo encaminhamento confiável (trusted forwarding) -Y; o encaminhamento confiável concede aos clientes X remotos um acesso mais amplo à tela local. Comece com ` --trusted forwarding` -X. Considere usar um host confiável apenas -Yquando uma aplicação específica exigir e sua política de segurança permitir.

O erro do YaST e a solução alternativa acima foram verificados no Guia de Implantação do SUSE Linux Enterprise Server 15 SP7. Os módulos do YaST, os backends gráficos disponíveis e o comportamento de inicialização podem variar entre as versões do SLES, SLED e openSUSE. Consulte a documentação para obter informações sobre o produto e a versão exatos instalados no host remoto. Revisado em 6 de outubro de 2026.

Referências: Guia de Implantação do SUSE SLES 15 SP7: YaST via SSH ; Guia de Segurança e Reforço do SUSE SLES 15 SP7: OpenSSH ; Guia do SUSE SLES 15 SP7: Sistema X Window e autenticação ; Guia de Administração do SUSE SLES 15 SP7: Modo texto do YaST e opções de linha de comando .