AbriuPúblico

Rede do local

Como a rede do local precisa estar para a central e os terminais se verem, e o que a central acessa na internet.

A central fala com os terminais pela rede local e com a Abriu pela internet. Nada é aberto no roteador e nenhum endereço fixo de internet é necessário. A própria central não aceita conexões: só o SSH vindo da rede local, para o suporte.

A rede local

  • A central e todos os terminais ficam na mesma rede (o mesmo roteador ou switch, a mesma VLAN). Se o local separa redes, a central precisa alcançar os terminais na porta 80 (HTTP).
  • A central pega endereço por DHCP: o endereço dela pode mudar sem problema.
  • Cada terminal e o relé do portão precisam de um endereço fixo: uma reserva de DHCP no roteador (pelo endereço MAC) ou um IP estático configurado no próprio aparelho, fora da faixa do DHCP (veja Endereço fixo). O painel guarda o endereço de cada um; se ele mudar, o aparelho fica "offline" no painel até ser corrigido.
  • Anote o endereço, o usuário e a senha de cada terminal para o cadastro no painel (veja Cadastrar o terminal no painel).
  • Cabo sempre que possível. A central por Wi-Fi funciona, mas uma queda do Wi-Fi para o sistema todo; terminais por Wi-Fi não são recomendados.

Endereço fixo

O painel fala com cada terminal e com o relé do portão pelo endereço guardado no cadastro. Se o roteador der outro endereço ao aparelho (depois de uma queda de energia, de uma troca de roteador ou de muito tempo desligado), ele fica Offline no painel até alguém corrigir. Por isso todo terminal e todo relé precisa de um endereço que não muda. A central não precisa: ela pega endereço por DHCP.

Reserva no roteador

É o melhor caminho: nada muda no aparelho, e se ele for para outra rede volta a pegar endereço sozinho.

  1. Ache o endereço MAC do aparelho. No Shelly, ele está na etiqueta e na página dele (http://<ip do Shelly>), e é o que o painel mostra em Número de série (ACEBE6E66898, que no roteador se escreve AC:EB:E6:E6:68:98). No terminal, na etiqueta ou na página web dele.
  2. No roteador, procure Reserva de endereço, DHCP estático ou Address reservation (o nome muda com a marca), na lista de clientes conectados ou nas opções de DHCP, e reserve um endereço para esse MAC. Pode ser o endereço que ele já usa.
  3. Reinicie o aparelho (no Shelly, Settings, Reboot, ou desligue e ligue) e confira que ele voltou no mesmo endereço.
  4. Confira o endereço no cadastro do painel (na aba Configurações do dispositivo, Endereço IP ou host) e use Testar conexão.

IP estático no próprio aparelho

Quando não há acesso ao roteador. No Shelly, pela página dele: Settings, Wi-Fi, na rede em uso, IPv4 mode Static:

  • IP: um endereço da mesma rede, fora da faixa do DHCP do roteador (se o roteador distribui de .100 a .200, use um entre .20 e .99) e que nenhum outro aparelho use;
  • Netmask: em geral 255.255.255.0;
  • Gateway: o endereço do roteador;
  • DNS: o do roteador, ou 1.1.1.1.

Salve: o Shelly volta à rede no endereço novo. Abra a página dele nesse endereço, corrija o cadastro no painel e use Testar conexão.

Num relé já cadastrado, o painel faz o mesmo sem a página dele: na aba Aparelho, Shelly, Endereço fixo, Fixar endereço já vem preenchido com o que o Shelly usa (máscara 255.255.255.0, o roteador e o DNS quando ele não diz); o painel pede confirmação, grava no Shelly e passa a usar o endereço novo. Voltar ao DHCP desfaz.

Um endereço errado deixa o Shelly fora da rede. O caminho de volta é o ponto de acesso dele (entre na rede ShellyMini1G4-... e abra http://192.168.33.1): por isso deixe o ponto de acesso ligado, com senha. Se o local trocar o roteador ou a faixa da rede, o IP estático precisa ser refeito. No terminal, o IP estático fica nas opções de rede da página web dele.

Se o endereço mudar

O próprio sistema procura na rede dele um terminal, gravador ou relé que parou de responder: o relé pelo MAC, os outros pela identificação que dão sem senha. Quando o acha em outro endereço, passa a usá-lo e avisa quem acompanha os dispositivos ("mudou de endereço"). Isso nunca acontece depois de uma senha errada, e no máximo a cada 10 minutos por aparelho.

Se ele continuar Offline, com "Could not reach device", ache o endereço novo: na lista de clientes do roteador pelo MAC, no app da Shelly, ou com Procurar na rede ao lado do endereço, que lista os terminais Intelbras e Hikvision, os gravadores Hikvision e os Shellys da rede. Corrija na aba Configurações do dispositivo, em Endereço IP ou host, use Testar conexão e faça a reserva acima para não acontecer de novo.

O que a central acessa na internet

A central só faz conexões de saída, por HTTPS (porta 443) e pelo túnel da Cloudflare (porta 7844, com recuo para a 443). Na maioria dos locais nada precisa ser configurado. Numa rede com firewall de saída, estes destinos precisam estar liberados:

Para quê Destinos
Instalação, atualizações, acompanhamento e e-mails do local fleet-api.abriu.app, *.r2.cloudflarestorage.com
O painel chegar à central (túnel) *.argotunnel.com, *.cloudflare.com, pkg.cloudflare.com
Imagem do sistema ghcr.io, *.githubusercontent.com
Pacotes do sistema operacional deb.debian.org, archive.raspberrypi.com, download.docker.com
Suporte remoto da Abriu connect.raspberrypi.com, *.connect.raspberrypi.com
Relógio NTP (porta 123 UDP), servidores do NTP.br (*.st1.ntp.br)

Um proxy que exija autenticação ou que inspecione HTTPS impede a instalação: avise a Abriu antes.

Relógio

A central e os terminais precisam da hora certa: a validade de visitantes e o histórico de acessos dependem dela. A central acerta o relógio pela internet sozinha: pelo NTP e, numa rede que bloqueia o NTP, pela própria Abriu (fleet-api.abriu.app), a cada 15 minutos. Nos terminais, confira data, hora e fuso horário na instalação (veja Data e hora).

Quando a internet cai

Os terminais continuam abrindo a porta para quem já está cadastrado: a lista de pessoas está neles. O painel fica inacessível e os cadastros novos esperam a internet voltar. Convites de visitante criados antes seguem valendo nos terminais. A Abriu é avisada pela frota quando a central fica sem notícias por mais de 15 minutos.

Quando a energia cai

Sem energia, os terminais não abrem a porta: por isso o nobreak e um botão ou chave mecânica de emergência na porta, conforme a norma de saída de emergência local. Quando a energia volta, a central e os terminais religam sozinhos.