Klienci Legacy
HandyCafe może zarządzać instalacjami klientów V3 i V4 obok nowoczesnych klientów na tym samym serwerze. Klienci legacy pojawiają się w Panelu Administracyjnym jako osobny typ karty, z ograniczonym zestawem akcji, które odpowiadają temu, co wspiera oryginalny protokół.
Zanim zobaczysz klientów legacy w Panelu Administracyjnym, włącz wsparcie w czasie rzeczywistym w Ustawienia > Klienci Legacy.
Jak Wyglądają Klienci Legacy
Klienci legacy łączą się z serwerem za pomocą oryginalnego protokołu multicast UDP. Nie używają mDNS jak nowocześni klienci. Zamiast tego serwer odkrywa ich na dwa sposoby:
| Ścieżka Odkrywania | Wyzwalacz |
|---|---|
| TCP Login | Klient wysyła LoginRequest na porcie poleceń TCP. Serwer rejestruje peer i emituje zdarzenie połączenia. |
| UDP Ping | Klient rozsyła ramkę Ping w grupie multicast. Serwer odbiera ją, aktualizuje rekord peer i emituje zdarzenie online. |
Stan per-MAC jest przechowywany w sklepie klientów legacy z IP, nazwą hosta, zalogowanym użytkownikiem, wersją klienta, timerami sesji i znacznikiem czasu ostatniego widzenia. Każda przychodząca ramka resetuje timer nieaktywności. Jeśli timer uruchomi się bez ruchu (domyślnie 10 sekund), klient jest oznaczany jako offline. Rekord pozostaje w bazie danych, aby historia nie została utracona.
Karta Klienta Legacy
Każdy klient legacy jest wyświetlany jako karta odrębna od kart nowoczesnych klientów. Nagłówek pokazuje nazwę wyświetlaną (nazwę hosta, jeśli dostępna, MAC, jeśli nie), odznakę online lub offline z kolorem i etykietą statusu.
Kolory i Etykiety Statusu
| Status | Kolor | Znaczenie |
|---|---|---|
| Online | Zielony | Aktywna sesja jest uruchomiona. |
| Idle | Cyjan | Klient jest połączony i oczekuje. Brak aktywnej sesji. |
| Paused | Bursztynowy | Sesja jest wstrzymana. Rozliczanie jest zatrzymane. |
| Busy | Fioletowy | Klient przetwarza żądanie. |
| Payment | Różany | Klient jest w trakcie płatności. |
| Admin | Indygo | Klient jest w trybie administracyjnym lub konserwacyjnym. |
| Offline | Szary | Brak ostatniego ruchu. Akcje są wyłączone, dopóki klient nie powróci online. |
| Timed | Niebieski | Sesja z ograniczonym czasem jest uruchomiona z terminem. |
Zegar Sesji
Gdy sesja jest aktywna, karta wyświetla blok zegara:
- Czas rozpoczęcia.
- Czas zakończenia (dla sesji z ograniczonym czasem).
- Wykorzystane minuty.
- Pozostałe minuty z odliczaniem na żywo.
- Naliczone koszty.
Informacje o Tożsamości
Karta zawsze pokazuje:
- Adres MAC.
- Adres IP.
- Wersję klienta (na przykład "3.4.01").
- Zalogowanego użytkownika, jeśli jest.
Pasek Akcji
Gdy klient jest online, pasek akcji poniżej informacji o tożsamości oferuje dostępne operacje.
Kontrola Sesji
| Przycisk | Widoczny Gdy | Zachowanie |
|---|---|---|
| Login | Status to idle | Otwiera dialog logowania urządzenia. Wybierz minuty i metodę płatności. Serwer wysyła polecenie Login z wybranymi wartościami. Sesja rozpoczyna się na kliencie. |
| Logout | Status to online, timed, paused, busy, lub payment | Jeśli sesja jest postpaid, dialog płatności zbiera kwotę i metodę. Transakcja jest zapisywana w księdze. Serwer wysyła polecenie Logout. Sesja zamyka się na kliencie. |
Dodaj Czas
Otwiera wybór minut. Akceptuje wartości dodatnie (przedłużenie) lub ujemne (odjęcie). Maksymalna wielkość to 10 000 minut w każdą stronę. Działa zarówno dla sesji prepaid, jak i postpaid.
Jeśli skonfigurowałeś wartości minutowe w ustawieniach cenowych, karta pokazuje również rząd przycisków z ustawieniami wstępnymi. Dotknij ustawienia wstępnego, aby zastosować wartość bez otwierania wybieraka.
Zrzut Ekranu
Żąda zrzutu ekranu na żywo od klienta legacy przez port transferu plików. Przebieg jest następujący:
- Serwer wysyła polecenie żądania zrzutu ekranu.
- Klient otwiera krótkotrwały nasłuch TCP na efemerycznym porcie.
- Serwer łączy się, wysyła 9-bajtowy nagłówek transferu plików i czeka.
- Klient przechwytuje ekran, koduje go jako skompresowany BMP i przesyła z powrotem.
- Serwer dekompresuje BMP i zapisuje go w folderze
legacy_screenshotsw katalogu danych HandyCafe. - Otwiera się przeglądarka zrzutów ekranu z nowym obrazem.
Jeśli klient nie odpowie w czasie (domyślnie 30 sekund na połączenie, 20 sekund na dane), żądanie kończy się niepowodzeniem i pojawia się komunikat o błędzie. Możesz spróbować ponownie natychmiast.
Akcje Zasilania
| Akcja | Potwierdzenie | Efekt |
|---|---|---|
| Logoff | Brak | Wylogowuje użytkownika Windows na maszynie klienta. Sesja Windows kończy się, ale komputer pozostaje włączony. |
| Reboot | Tak | Wysyła polecenie restartu. Maszyna klienta uruchamia się ponownie. |
| Shutdown | Tak | Wysyła polecenie wyłączenia. Maszyna klienta wyłącza się. |
Reboot i Shutdown pokazują dialog potwierdzenia, aby zapobiec przypadkowym akcjom zasilania.
Nieobsługiwane Operacje
Klienci legacy nie obsługują wszystkich funkcji dostępnych na nowoczesnych klientach HandyCafe. Kluczowe braki:
- Brak regulacji pauzy w trakcie sesji. Zmiany czasu wprowadzone podczas pauzy są kolejkowane, ale klient może je zignorować. Najpierw wznowić sesję, zastosować zmianę, a następnie ponownie wstrzymać, jeśli to konieczne.
- Brak trybu Admin przez polecenie serwera. Wewnętrzny status admina klienta nie może być przełączany z serwera. Tryb admina jest kontrolowany tylko na maszynie klienta.
- Brak rejestracji licencji z serwera. Serwer odzwierciedla bajty licencji, które widzi w ramkach klienta, ale nie może przesłać nowej licencji do klienta. Zarejestruj klienta lokalnie.
- Brak integracji portfela członkowskiego dla sesji rozpoczętych na klientach legacy. Płatności są rejestrowane jako zwykłe wiersze
transactionsztransaction_type=sessionsi MAC klienta. Nowoczesne przepływy portfela nie mają zastosowania. - Brak zdalnego pulpitu. Funkcja zdalnego pulpitu używa ścieżki strumieniowania UDP, która nie jest obecna w klientach legacy.
- Brak synchronizacji plików push. Sync Explorer przesyła pliki tylko przez nowoczesny protokół.
Dla pełnej funkcjonalności, migruj do nowoczesnych klientów HandyCafe, gdy to możliwe.
Zachowanie Offline
Gdy czas nieaktywności wygasa, karta przygasa, odznaka statusu zmienia się na szarą, a każdy przycisk akcji jest wyłączony. Rekord klienta pozostaje w sklepie, więc historia, MAC, nazwa hosta i dane ostatniego widzenia są zachowane. Gdy klient powróci online (nowy ping UDP lub login TCP), karta ożywa i akcje stają się ponownie dostępne.
Rekord nie jest automatycznie usuwany. Aby trwale usunąć starego klienta, edytuj go z bazy danych administracyjnej lub usuń za pomocą odpowiedniego narzędzia administracyjnego.
Wskazówki
- Utrzymuj czas nieaktywności na poziomie 10 sekund, chyba że wiesz, że twoi klienci legacy wysyłają sygnały wolniej. Krótszy czas nieprawidłowo oznacza zdrowych klientów jako offline podczas krótkich zakłóceń sieci.
- Jeśli klient legacy wydaje się online, ale nie odpowiada na polecenia, potwierdź Wariant Protokołu w Ustawieniach. Niezgodność między wariantem serwera (STE vs Standard) a wersją klienta powoduje ciche odrzucanie poleceń.
- Zrzuty ekranu z klientów legacy to skompresowane BMP, które są większe niż nowoczesne zrzuty PNG. Przechowuj folder
legacy_screenshotsna dysku z odpowiednią ilością wolnego miejsca, jeśli wykonujesz wiele zrzutów. - Używaj Dodaj Czas z przyciskami ustawień wstępnych podczas zmian. Jedno dotknięcie przedłuża sesję o zdefiniowany przyrost, co jest szybsze niż ręczne wpisywanie minut.
- Stopniowo wycofuj klientów legacy. Migruj jedną partię na raz, potwierdź, że nowi klienci działają identycznie w Panelu Administracyjnym, a dopiero potem wycofaj starych.