Eksploatacja

Praca lokalna

Jeśli nie chcesz, aby Appliance pozostawał online, możesz zawsze użyć przeglądarki w tej samej sieci lokalnej i przejść do adresu IP lub nazwy hosta Appliance:


http://<appliance-host>

Zaloguj się jako użytkownik admin:

Nazwa użytkownika: admin
Hasło: początkowe hasło administratora wygenerowane dla twojego Appliance

Instalator wyświetla to hasło na końcu instalacji. Jest ono również zapisane jako APPLIANCE_ADMIN_PASSWORD w pliku /opt/ironflock/.env na hoście Appliance, który może odczytać tylko root:


sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env

Zmień hasło po pierwszym logowaniu.

Nie pamiętasz hasła administratora? Uruchom to polecenie na hoście Appliance, aby ustawić nowe; polecenie wyświetli nowe hasło:


curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- --reset-admin-password

Starsze Appliance: Appliance zainstalowany, zanim instalator zaczął generować hasło administratora, ma początkowo hasło ironflock. Przy pierwszym logowaniu tym hasłem zostaniesz poproszony o ustawienie nowego hasła.

Interfejsy webowe aplikacji

Gdy aplikacja na podłączonym urządzeniu udostępnia interfejs webowy, Appliance udostępnia go przez swój wbudowany tunel. Od razu po instalacji nie wymaga to niczego od firmowego IT — każdy interfejs aplikacji jest publikowany przez zwykły HTTP na automatycznie przydzielonym porcie adresu Appliance (http://<appliance-host>:<port>), a IronFlock UI pokazuje link. Dostęp nadal jest chroniony logowaniem do Appliance.

Dla zaufanych adresów URL https:// we współdzielonej sieci firmowej — z użyciem certyfikatu wildcard od twojego CA lub reverse proxy terminującego TLS — zobacz Interfejsy aplikacji i HTTPS.

Powiązanie kont

Utwórz lokalne konta użytkowników dla swojego zespołu, zapraszając ich e-mailem w ustawieniach projektu na Appliance. E-mail z zaproszeniem zawiera wszystko, czego potrzebuje zaproszona osoba:

Osobisty link połączenia — otwarcie go na ironflock.com łączy konto ironflock.com zaproszonej osoby z Appliance. Jeśli nie ma ona jeszcze konta na ironflock.com, najpierw je zakłada, używając adresu e-mail z zaproszenia (połączenie jest przyznawane tylko wtedy, gdy oba adresy e-mail są zgodne). Po połączeniu Appliance pojawia się w jej selektorze projektów na ironflock.com i może ona od razu pracować na nim zdalnie — bez ręcznych kluczy, bez lokalnej rejestracji.
Link do lokalnej rejestracji — opcjonalnie: ukończenie lokalnej rejestracji dodatkowo umożliwia logowanie się bezpośrednio w interfejsie Appliance (http://<appliance-host>).

Kilka rzeczy, które warto wiedzieć:

Istniejący lokalni użytkownicy nie potrzebują nowego zaproszenia od właściciela projektu. W interfejsie Appliance otwierają swój Profil i klikają Wyślij mi link połączenia e-mailem w sekcji Połącz z ironflock.com.
Ponowne wysłanie: ponowne zaproszenie tego samego adresu e-mail (lub ponowne kliknięcie przycisku w profilu) generuje nowy link połączenia. Ważny jest wyłącznie link z najnowszego e-maila.
Jeśli Appliance nie może wysyłać e-maili — na przykład w restrykcyjnej sieci firmowej blokującej przekaźnik pocztowy — link połączenia jest zamiast tego wyświetlany bezpośrednio w interfejsie: zapraszający kopiuje go i przekazuje dowolnym kanałem. Link musi zostać otwarty w przeglądarce z dostępem do internetu.
Rozłączanie: użytkownik może w każdej chwili usunąć połączenie na ironflock.com w sekcji Profil → Instancje → Połączone instancje. Ponowne otwarcie najnowszego linku połączenia przywraca je.

Właściciel instancji — użytkownik, który utworzył Instance Key na ironflock.com — jest automatycznie połączony z lokalnym kontem administratora instancji; właściciel nie potrzebuje zaproszenia.

Synchronizacja aplikacji z App Store online

Appliance zawiera local App Store — prywatny katalog aplikacji i rejestr kontenerów obsługujący urządzenia w sieci lokalnej. Ten lokalny store możesz zasilać, synchronizując aplikacje z publicznego online IronFlock Store, pod warunkiem że Appliance ma dostępne połączenie internetowe w momencie synchronizacji. Stałe połączenie z internetem nie jest wymagane — wystarczy tymczasowe, aby pobrać potrzebne aplikacje.

Wymagania wstępne

Konto na publicznej platformie ironflock.com.
Twoje konto Appliance jest połączone z twoim kontem ironflock.com (zobacz Powiązanie kont). Konto administratora właściciela instancji jest połączone automatycznie.

Jak działa synchronizacja aplikacji


┌────────────────────┐                       ┌────────────────────┐
│  Online IronFlock  │  ◄──── account ─────► │  Appliance         │
│  Store (cloud)     │      connection       │  local Store       │
└────────────────────┘                       └────────────────────┘
         │                                            │
   apps available to                          sync button shown
   the connected account                      instead of install

Otwórz local App Store — Gdy Appliance ma aktywne połączenie z internetem, App Store wyświetli wszystkie aplikacje dostępne dla twojego połączonego konta ironflock.com na platformie online.
Zsynchronizuj potrzebne aplikacje — Zamiast przycisku Install każda aplikacja pokazuje przycisk Sync. Kliknięcie go pobiera aplikację — w tym obrazy kontenerów i metadane — z online store do lokalnego store.
Dodaj urządzenia — Po synchronizacji aplikacja jest w pełni dostępna w lokalnym store i możesz normalnie dodawać do niej urządzenia, bez potrzeby posiadania połączenia z internetem.

Przepływ aktualizacji

Gdy nowa wersja zsynchronizowanej aplikacji zostanie opublikowana w online store, przycisk Sync pojawi się ponownie dla tej aplikacji. Podłącz Appliance na chwilę do internetu, zsynchronizuj zaktualizowany release, a następnie wdróż go na urządzeniach za pomocą standardowego przepływu aktualizacji aplikacji.

Taka konstrukcja daje ci pełną kontrolę nad tym, co trafia do twojej sieci — nic nie jest pobierane automatycznie, a połączenie z internetem jest potrzebne wyłącznie na etapie synchronizacji.

Niestandardowy nadawca e-mail (SMTP)

Domyślnie wszystkie e-maile platformy — weryfikacja konta, odzyskiwanie hasła, zaproszenia i powiadomienia o alarmach — są przekazywane przez chmurowe proxy SMTP IronFlock i wyświetlają się jako [email protected]. Aby e-maile wyglądały na wysłane z Twojej własnej firmy, skieruj Appliance na własny serwer SMTP.

Na hoście Appliance edytuj plik środowiskowy wygenerowany przez instalator w /opt/ironflock/.env i ustaw następujące zmienne:


SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company

Użyj smtps:// dla niejawnego TLS (zwykle port 465) lub smtp:// ze STARTTLS (port 587).
Znaki specjalne w nazwie użytkownika lub haśle należy zakodować w adresie URL (np. @ → %40).
SMTP_FROM_ADDRESS i SMTP_FROM_NAME to wartości, które odbiorcy widzą w nagłówku Od każdego e-maila platformy.

Zastosuj zmiany, restartując stack:


sudo systemctl restart ironflock.service

Po restarcie wszystkie e-maile uwierzytelniania, powiadomienia platformy i e-maile alarmowe są wysyłane przez Twój serwer SMTP z adresem i nazwą nadawcy Twojej firmy.

Jeśli SMTP_CONNECTION_URI nie jest ustawione, Appliance nadal kieruje e-maile przez chmurowe proxy SMTP IronFlock uwierzytelniane Twoim kluczem licencyjnym — nie wymaga dodatkowej konfiguracji, ale e-maile będą oznaczone marką IronFlock.

Utrzymanie

Aby zaktualizować system IronFlock na Appliance, administrator może użyć przycisku aktualizacji w sekcji licencji w swoim profilu, gdy tylko dostępna jest nowa wersja. Appliance potrzebuje połączenia z internetem, aby pobrać aktualizację. IronFlock automatycznie uruchamia się ponownie po zakończeniu aktualizacji.

Aktualizacje systemu Linux pozostają w Twojej gestii.

Cykl życia licencji

Twoja licencja jest powiązana z jednym fizycznym Appliance. Ta sama licencja nie może jednocześnie uruchamiać drugiej instancji IronFlock na innym sprzęcie. W codziennej eksploatacji Appliance działa offline — dane produkcyjne, pulpity, zarządzanie aplikacjami i kontrola urządzeń brzegowych pozostają lokalnie na urządzeniu.

Kiedy Appliance potrzebuje internetu

Połączenie z internetem jest wymagane wyłącznie w następujących momentach:

Początkowa instalacja i aktualizacje Appliance — i tak konieczne, aby pobrać oprogramowanie z serwerów dystrybucyjnych IronFlock; licencja jest aktywowana w ramach tego samego kroku.
Okresowa ponowna weryfikacja licencji — zależy od twojego planu:
- Licencja miesięczna: raz na 30 dni.
- Licencja roczna: raz na 365 dni.
- Licencja wieczysta: brak okresowej ponownej weryfikacji — internet jest potrzebny wyłącznie przy instalacji i aktualizacji.
Przeniesienie licencji na nowy sprzęt (zobacz poniżej).
Usługa AI Multi Agent — wyłącznie gdy jest aktywnie używana.

Okres karencji i blokada

Jeśli okresowa ponowna weryfikacja nie może połączyć się z chmurą (awaria sieci, przejściowy błąd chmury), Appliance wchodzi w 7-dniowy okres karencji. W tym czasie Appliance nadal działa normalnie i automatycznie ponawia próby.

Jeżeli minie siedem pełnych dni bez pomyślnej ponownej weryfikacji, Appliance blokuje się: większość operacji jest odmawiana, a interfejs pokazuje licencję jako nieważną. Aby przywrócić działanie, należy przywrócić połączenie internetowe Appliance i kliknąć Zweryfikuj teraz w panelu licencji w swoim profilu w interfejsie Appliance (lokalny widok http://<appliance-host> lub twoja instancja otwarta przez ironflock.com).

Przenoszenie licencji na nowy sprzęt (handover)

Licencja jest powiązana z odciskiem sprzętowym jednej maszyny. Aby przenieść ją na inną maszynę, należy zainicjować handover z poziomu swojego profilu w chmurze IronFlock:

Otwórz Profil → Instancje na ironflock.com.
Kliknij Zresetuj odcisk sprzętu przy instancji, którą chcesz przenieść.

Handover wymaga, aby aktualnie powiązany Appliance był online. Chmura łączy się z nim z powrotem, prosi go o lokalne unieważnienie, i dopiero wtedy czyści odcisk sprzętu po stronie chmury. Ten handshake gwarantuje, że stary Appliance nie może działać dalej, podczas gdy nowy się rejestruje — co zapobiega przypadkowemu podwójnemu wykorzystaniu tej samej licencji.

Gdy odblokowanie zakończy się sukcesem:

Skonfiguruj nowy sprzęt zgodnie z krokami w sekcji Instalacja, używając tego samego Instance Key.
Nowy Appliance weryfikuje licencję, powiązuje swój odcisk sprzętowy i staje się aktywnym urządzeniem.

Gdy stary sprzęt jest uszkodzony lub niedostępny

Jeśli wcześniej powiązany Appliance jest niedziałający lub w inny sposób nieosiągalny, handshake zakończy się przekroczeniem czasu, a interfejs chmurowy wyświetli appliance_unreachable_contact_support. W takim przypadku skontaktuj się z zespołem IronFlock — możemy ręcznie wyczyścić powiązanie po zweryfikowaniu własności.

Wskazówka: uruchom handover zanim wycofasz stary sprzęt, dopóki jest on jeszcze online. Proces jest znacznie szybszy — zarówno dla ciebie, jak i naszego zespołu wsparcia — gdy stary Appliance jest nadal osiągalny.