Większość problemów widać w dwóch miejscach: w Podglądzie zdarzeń Windows (dzienniki Aplikacja i System), gdy usługa się nie uruchamia, oraz — gdy już można się zalogować — w Settings › Application logs w konsoli. Zacznij od nich.
Instalator lub usługa się nie uruchamia
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| „System Windows ochronił ten komputer” | SmartScreen, ponieważ instalator nie jest jeszcze podpisany cyfrowo. Sprawdź sumę SHA-256, a następnie Więcej informacji › Uruchom mimo to. |
| Instalator informuje, że port jest zajęty | Port zajmuje inny program. Znajdź go poleceniem Get-NetTCPConnection -LocalPort 8181 albo wybierz inny port w instalatorze. |
| Instalator zatrzymuje się podczas kopiowania plików | Pliki może blokować antywirus. Uruchom instalator ponownie; jeśli problem się powtarza, na czas instalacji dodaj C:\phaf\app do wyjątków antywirusa. |
Błąd Unexpected token lub JSON po edycji config.json | Plik jest nieprawidłowy: pojedynczy ukośnik wsteczny w ścieżce albo brakujący przecinek lub cudzysłów. Popraw go jak w kroku Instalacja i uruchom usługę ponownie. |
EPERM lub EACCES na C:\phaf\data | Konto usługi nie może zapisywać w folderze danych. Powtórz krok uprawnień do folderów. |
| Usługa ma stan „Uruchomiono”, ale nic nie odpowiada | Sprawdź Podgląd zdarzeń i czy port w config.json jest tym, który otwierasz. Usługa uruchamia phaf ponownie po awarii, więc szukaj powtarzających się błędów. |
Konsola się nie otwiera
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| Działa na serwerze, ale nie z innych komputerów | To oczekiwane bez proxy: phaf nasłuchuje tylko na 127.0.0.1. Skonfiguruj HTTPS z IIS lub nginx i otwórz port 443. |
| Błąd IIS 502.3 lub „bad gateway” | phaf nie działa albo reguła wskazuje zły port. Sprawdź na serwerze Invoke-WebRequest http://127.0.0.1:8181/. |
| Błąd IIS 404.11 lub 404.4 | W web.config brakuje allowDoubleEscaping albo proxy nie jest włączone w ARR. Powtórz krok 2. |
| Przesyłanie plików kończy się błędem 413 lub 404.13 | Zwiększ maxAllowedContentLength (IIS) lub client_max_body_size (nginx) do 64 MB. |
| Ostrzeżenie o certyfikacie w przeglądarce | Certyfikat nie pasuje do nazwy w pasku adresu albo jego urząd nie jest zaufany na komputerach użytkowników. |
| Każdy użytkownik ma adres IP serwera | Ustaw nagłówek proxy na X-Forwarded-For w Settings › Security › Network access. |
Brak dostępu
- „Account locked” — 5 błędnych haseł lub kodów blokuje konto na 15 minut. Odczekaj albo poproś innego administratora o sprawdzenie konta.
- Zablokowanie przez reguły IP — na serwerze otwórz
C:\phaf\data\profile.cfgw Notatniku jako administrator i popraw lub wyczyść linieTrustedIPiBlockedIPw sekcji[Application]. Zmiana działa od razu, bez restartu. - Utracone urządzenie dwuskładnikowe — inny administrator usuwa 2FA użytkownika w Settings › Users; użytkownik konfiguruje je ponownie przy następnym logowaniu.
- Jedyny administrator zapomniał hasła — skontaktuj się ze wsparciem. Aby tego uniknąć, utrzymuj dwóch administratorów.
Problemy z bazą danych
| Objaw | Przyczyna i rozwiązanie |
|---|---|
| Baner „baza danych jest niedostępna”; nic nie jest przetwarzane | phaf nie może połączyć się z bazą danych aplikacji i ponawia próbę co 30 sekund. Baner i Settings › Advanced › Database pokazują błąd. |
| Przekroczenie czasu połączenia z SQL Server | Wyłączony TCP/IP, zły port, zapora albo zatrzymana usługa SQL Server Browser dla instancji nazwanej. Przetestuj z serwera phaf: Test-NetConnection sql01 -Port 1433. |
| Login failed for user | Zły użytkownik lub hasło, wyłączony login albo instancja nie zezwala na uwierzytelnianie SQL Server. |
| Nie można odszyfrować hasła | Wartość ENC:v1: utworzono w innej instalacji. Zaszyfruj ją ponownie na tym serwerze (krok 3). |
Błąd certyfikatu przy "trustServerCertificate": false | Certyfikat SQL Server nie pasuje do nazwy w server albo jego urząd nie jest zaufany na serwerze phaf. Popraw certyfikat lub tymczasowo użyj true. |
| Brak uprawnienia CREATE TABLE | Login nie ma roli db_ddladmin w bazie phaf. |
phaf działa, ale nie przetwarza
- Baner Safe Mode — kliknij Leave Safe Mode w Settings › Advanced i usuń
"safeMode": truezconfig.json, jeśli tam jest. - Baner zajętości dysku — dysk danych przekroczył próg ustawiony w Settings › Alerts. Zwolnij miejsce lub powiększ dysk; przetwarzanie wznowi się samo.
- Niedostępne udziały sieciowe — lokalne konto usługi nie może otwierać udziałów domenowych. Uruchom usługę phaf na koncie domenowym z dostępem.
- Brak alertów e-mail — użyj Send test email w Settings › Alerts; pokazuje rozmowę SMTP krok po kroku.
Utracony klucz szyfrowania
Jeśli phaf.master_key zostanie utracony i nie ma kopii, phaf nie odczyta zapisanych nim haseł. Przepływy i ustawienia pozostaną, ale trzeba ponownie wpisać hasła wszystkich konektorów, połączeń i certyfikatów, ponownie zaszyfrować hasło do bazy danych, a użytkownicy muszą od nowa skonfigurować uwierzytelnianie dwuskładnikowe. Zawsze, gdy to możliwe, przywróć klucz z bezpiecznej kopii.
Kontakt ze wsparciem
Otwórz zgłoszenie do wsparcia, podając wersję phaf, wersję Windows Server, używaną bazę danych, błędy z Podglądu zdarzeń i odpowiednie wiersze z Settings › Application logs. Nigdy nie wysyłaj phaf.master_key, haseł z config.json ani zawartości folderu danych.