A solução de origem continua a ser invulgarmente atual. Um membro da comunidade indicou diretamente as instruções oficiais da Homey para Linux e utilizou um contentor Docker com rede do anfitrião, modo privilegiado, reinício automático e um ~/.homey-shs diretório. O autor original respondeu que a instalação funcionou.
As páginas oficiais de suporte atuais da Homey continuam a utilizar a mesma arquitetura de contentor e disponibilizam agora também um exemplo de Docker Compose. No ZimaOS, o Compose é geralmente mais fácil de documentar e reproduzir do que um docker run comando.
Verifique os requisitos mínimos atuais da Homey
Atualmente, o servidor autoalojado da Homey requer:
- CPU Intel/AMD ou Arm de 64 bits;
- pelo menos 1 GB de RAM disponível;
- pelo menos 1 GB de armazenamento disponível;
- um endereço IP/caminho LAN dedicado ao qual os clientes possam aceder.
O ZimaOS já fornece Docker, por isso não execute o script genérico de “instalação do Docker” da Homey no anfitrião.
A solução original utilizou a arquitetura oficial de Docker Run da Homey
O comando de origem utilizado foi:
-
--network host; -
--privileged; -
--restart unless-stopped; - uma pasta persistente do anfitrião mapeada para
/homey/user/; -
ghcr.io/athombv/homey-shs.
O autor original confirmou que o servidor foi instalado e funcionava.
A documentação atual da Homey também fornece Docker Compose
O exemplo de Compose mantido pela Homey utiliza o mesmo design:
services:
homey-shs:
image: ghcr.io/athombv/homey-shs:latest
container_name: homey-shs
restart: unless-stopped
network_mode: host
privileged: true
volumes:
- ~/.homey-shs:/homey/userConsulte o fluxo atual do Compose para o servidor autoalojado da Homey.
Utilizar um caminho persistente deliberado no ZimaOS
O ~/.homey-shs o caminho é válido numa shell Linux genérica, mas no ZimaOS é mais simples escolher uma localização de armazenamento gravável explícita, como uma pasta AppData dedicada no espaço de armazenamento que efetivamente salvaguarda.
Mapeie essa pasta do anfitrião para /homey/user e documente antes de futuras reinstalações.
A utilização da rede do anfitrião é intencional
O Compose oficial do Homey utiliza network_mode: host, o que dá ao contentor acesso direto ao espaço de nomes da rede do anfitrião, em vez do mapeamento normal de portas do Docker.
Isto facilita a deteção na LAN e a comunicação com dispositivos, mas também reduz o isolamento da rede. Verifique que serviços o contentor abre no anfitrião.
O modo privilegiado concede permissões significativas
O contentor oficial do Homey é executado com privilégios. Isto confere ao contentor capacidades de acesso ao anfitrião/dispositivos muito mais amplas do que as de um serviço normal da App Store.
Utilize apenas a imagem/fonte oficial e mantenha-a atualizada. Não adicione software não relacionado ao mesmo contentor privilegiado.
Conhecer as portas de serviço do Homey
A documentação atual do Homey indica as portas predefinidas do servidor/ponte, incluindo 4859-4862. A utilização da rede do anfitrião significa que esses serviços ficam diretamente disponíveis no anfitrião ZimaOS.
Se for utilizada uma firewall no anfitrião, como a ZFW, certifique-se de que as portas LAN necessárias são permitidas deliberadamente.
Concluir a configuração na aplicação móvel do Homey
Depois de o contentor estar em execução, abra o Homey no iOS ou Android, adicione um novo Homey e selecione Servidor autoalojado. Se a deteção automática falhar, a configuração atual do Homey permite HOMEY_LOCAL_ADDRESS para definir o endereço IPv4 da LAN do anfitrião.
Atualizar através da transferência e recriação do contentor
As instruções atuais do Homey atualizam a imagem e recriam o contentor, mantendo a pasta persistente no anfitrião. Os dados são preservados porque ficam fora do contentor descartável.
Fazer uma cópia de segurança da pasta persistente do Homey
O Homey indica explicitamente que deve fazer uma cópia de segurança dos ficheiros e pastas armazenados no .homey-shs caminho. Essa cópia de segurança é mais importante do que preservar o próprio contentor.
Perguntas frequentes sobre o Homey no ZimaOS
O utilizador de origem confirmou que o Homey funcionava?
Sim. Disseram que a instalação sugerida do Docker estava a funcionar bem.
Os utilizadores do ZimaOS devem instalar o Docker com o script curl do Homey?
Não. O ZimaOS já inclui o Docker; utilize apenas a parte relativa ao contentor/Compose.
Por que motivo deve persistir /homey/user fora do contentor?
Esse diretório contém o estado persistente do Homey e permite atualizar ou recriar o contentor sem perder a configuração.
