Este conteúdo tem um resultado final simples: alterar a interface Web do ZimaOS para utilizar portas diferentes da 80/443 interrompeu a conectividade da Zima App 2.3.0 no ZimaBoard 2 do utilizador, mas, depois de atualizar o ZimaOS para a versão 1.5, o utilizador regressou e afirmou que o problema tinha sido resolvido.
Isto significa que a página não deve ensinar os utilizadores atuais a configurar manualmente uma “porta do ZimaClient” oculta com base na falha de 2025. Tratou-se de um problema histórico de compatibilidade entre o cliente e uma porta personalizada da interface Web, e a própria fonte estabelece a versão 1.5 como o ponto de recuperação.
O utilizador alterou as portas para o Nginx Proxy Manager
Normalmente, o Nginx Proxy Manager necessita das portas 80 e 443 do anfitrião para o tráfego de entrada HTTP/HTTPS. Por isso, o utilizador alterou o ZimaOS para:
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443e reiniciou o serviço de gateway do CasaOS/ZimaOS.
A aplicação Zima para Windows deixou então de conseguir estabelecer ligação
O ambiente de origem era:
- ZimaBoard 2 1664;
- kernel ZimaOS 6.12.25;
- Zima App 2.3.0 no Windows 11.
Depois da alteração da porta da interface Web, reiniciar a aplicação do Windows e tentar estabelecer novamente a ligação não funcionou.
A IceWhale pediu detalhes reproduzíveis em vez de presumir uma configuração de porta
Zima-Giorgio pediu ao utilizador que fornecesse a descrição exata do problema, os passos para o reproduzir, as alterações anteriores, as correções tentadas, o hardware, a versão do sistema operativo e a versão do cliente. Esta é uma boa prática de análise, porque a mesma falha de ligação visível pode resultar de problemas de descoberta, acesso remoto, TLS, portas ou versão do cliente.
A atualização para o ZimaOS 1.5 resolveu o caso da fonte
Três dias depois, ThomasSpi publicou: “Depois da atualização para o Zima OS 1.5, funciona. Problema resolvido.”
Esta é a conclusão mais sólida da fonte e deve substituir a especulação sobre ensinar manualmente à Zima App uma porta personalizada.
O ZimaClient atual continuou a evoluir
A documentação atual da IceWhale descreve o ZimaClient como encontrando automaticamente a ligação utilizável mais rápida à interface Web através da LAN, da rede externa, de hotspots e de outros caminhos suportados.
Consulte o modelo atual de instalação e ligação do ZimaClient antes de recriar uma correção da era da versão 2.3.0.
O ZimaOS 1.7.1 melhorou ainda mais os URLs Web do Docker e o tratamento dinâmico da rede
O registo de alterações da versão 1.7.1 inclui uma configuração mais flexível das portas dos URLs Web do Docker e um tratamento melhorado dos URLs em ambientes de rede dinâmicos. Estas alterações dizem respeito aos URLs das aplicações, não comprovam nada de específico sobre o antigo erro do ZimaClient, mas mostram que o tratamento de portas e URLs da plataforma continuou a evoluir.
O proxy inverso e o ZimaClient são caminhos de acesso separados
O Nginx Proxy Manager pode fornecer domínios HTTPS fáceis de utilizar para aplicações ou até para o painel do ZimaOS. O ZimaClient utiliza a sua própria lógica de descoberta e acesso remoto. Não se deve presumir que uma alteração no proxy inverso reconfigure automaticamente o ZimaClient em todas as versões.
Se utilizar um proxy para o painel do ZimaOS, mantenha os WebSockets
Um caso posterior da comunidade, em 2026, mostrou que o painel podia carregar visualmente através do Nginx Proxy Manager, enquanto os widgets em tempo real e as caixas de diálogo das aplicações falhavam até a opção de suporte para WebSockets ser ativada. O conflito de portas e o proxy de WebSockets são camadas separadas.
Uma forma mais segura de alterar a porta da interface Web
- Registe a porta original.
- Altere a porta da interface Web através da interface suportada, quando disponível.
- Verifique o acesso direto no navegador através do novo IP:porta.
- Reinicie/atualize o ZimaClient e confirme a descoberta.
- Só depois atribua as portas 80/443 ao proxy inverso.
- Mantenha um método de recuperação local caso o proxy e o cliente falhem.
Perguntas frequentes sobre a alteração da porta do ZimaClient
O utilizador da fonte encontrou uma configuração manual de porta personalizada na Zima App?
Não. A discussão terminou com a atualização do sistema operativo a resolver o problema.
Que versão resolveu o caso da fonte?
O utilizador afirmou explicitamente que o ZimaOS 1.5 resolveu o problema.
Os utilizadores atuais devem presumir que o comportamento do ZimaClient 2.3.0 ainda se aplica?
Não. O tratamento das ligações pelo ZimaClient e pelo ZimaOS atuais é substancialmente mais recente.
