Lewati ke konten
SentinelDokumentasi Sentinel

Pemecahan masalah

Gejala dan pemeriksaan

Section titled “Gejala dan pemeriksaan”
Gejala Periksa
Node tidak dapat IP journalctl -u dnsmasq -f, kabel dan PoE, ip -br addr show <RACK_IF>
Node dapat IP tetapi tidak connect MQTT docker compose ps, sudo nft list table inet celestian_gw (penghitung drop), log serial node ([mqtt] broker …)
LCD AUTH! broker menolak kredensial atau client_id. Terutama di mode langsung: cek mqtt_user dan mqtt_pass, dan device terhubung ke channel dengan tipe publish. Di mode gateway broker lokal anonim, jadi periksa konfigurasi Mosquitto gateway
Node online di LAN tetapi tidak muncul di Celestian docker compose logs mosquitto (bridge ditolak = ID/key salah atau clientid tidak diawali ID gateway); docker compose logs history; belum ada rule penyimpanan di channel
Data tidak sampai Celestian gateway belum punya koneksi publish ke channel (history: “ditolak Celestian (0x87)”); belum ada rule penyimpanan
Telemetri dan event dobel di Celestian bridge.conf masih memuat +/telemetry / +/event; hapus kedua baris itu
Jam node salah, ts kosong chronyc clients, chronyc tracking di gateway
“Waktu perkiraan” di Celestian gateway tanpa hulu NTP (Reference ID 7F7F0101); isi NTP_UPSTREAM atau pastikan internet/terowongan ke NTP
history berhenti, “belum diisi” isi GATEWAY_ID, GATEWAY_KEY, WORKSPACE, CHANNEL di .env
config / cmd dari server tidak sampai gateway belum punya koneksi subscribe ke channel; baris downlink di bridge.conf
Rules, sumber, atau kelompok tidak terlihat di Celestian baris rules, sources, profiles, tgroups (dan */reported, */current) belum ada di bridge.conf
Rollout firmware gagal HTTP 503 CELESTIAN_WEB_URL / CELESTIAN_WEB_HOST belum diisi (OTA di gateway)

Lihat juga FAQ untuk masalah di sisi node.

Opsional: WireGuard ke server Celestian

Section titled “Opsional: WireGuard ke server Celestian”

Dengan WireGuard, bridge MQTT berjalan di dalam terowongan terenkripsi dan port broker tidak perlu dibuka ke internet. Login MQTT (ID + device key gateway) tetap dipakai. Fitur ini disiapkan, belum dipakai di produksi.

  1. Pasang dan siapkan terowongan (template host/wg0.conf.example):
    Terminal window
    sudo apt-get install -y wireguard
    Salin template ke /etc/wireguard/wg0.conf, isi kunci dan alamatnya, lalu:
    Terminal window
    sudo systemctl enable --now wg-quick@wg0
  2. Di mosquitto/conf.d/bridge.conf, arahkan address ke alamat VPN server dan port MQTT 5 internal broker (bukan port publik), mis. address 10.99.0.1:1884. Ubah CELESTIAN_HOST dan port di .env agar sama.
  3. docker compose restart mosquitto, lalu cek sudo wg show (ada “latest handshake”) dan log bridge.

Catatan:

  • AllowedIPs di gateway hanya berisi alamat VPN server, jadi jalur internet biasa gateway tidak berubah.
  • Container Mosquitto menjangkau terowongan lewat host; tidak perlu pengaturan Docker tambahan.
  • Node di LAN rak tetap tidak bisa menjangkau terowongan: firewall menolak semua penerusan dari LAN rak.
  • Terowongan yang sama bisa dipakai untuk SSH ke gateway dari server.