Manual:Caddy/Depanare
Caddy.STS - Depanare
Versiune documentata: Caddy.STS Setup 0.4.3.
Inainte de orice interventie, folositi Diagnostic. Acesta inventariaza serviciile Caddy, porturile, backendul Mobile.Api, certificatul si regula Windows Firewall proprie.
Nu utilizati "Instalare NOUA" peste o instalatie existenta pentru a incerca sa o reparati. Nu stergeti fisierele de configurare sau datele si certificatele Caddy.
Serviciul CaddySTS nu porneste
- Verificati starea serviciului Windows
CaddySTS. - Verificati daca portul HTTPS este ocupat de alt program.
- Verificati existenta executabilului si a configuratiei administrate.
- Cititi mesajele din Diagnostic si jurnalul Windows.
sc query CaddySTS netstat -ano | findstr :443
Portul 443 este exemplul folosit de modul public. Nu opriti servicii straine Caddy si nu modificati serviciul RDP pentru depanare.
Mobile.Api nu raspunde
Verificati separat serviciul Mobile.Api. Pentru un backend local pe portul 5277:
curl http://127.0.0.1:5277/test
Daca serviciul API nu raspunde local, rezolvati mai intai problema Mobile.Api. Caddy nu poate publica un backend indisponibil.
HTTPS merge local, dar nu din Internet
In modul Public, verificati IP-ul public si portul HTTPS 443, regula Windows Firewall, routerul/NAT, eventualul firewall al furnizorului si antivirusul. Faceti testul dintr-o retea externa, de exemplu de pe un telefon cu Wi-Fi dezactivat.
Nu deschideti portul Mobile.Api direct catre Internet. Publicarea se face prin HTTPS.
Acces LAN indisponibil
- Confirmati adresa IPv4 privata si portul HTTPS.
- Verificati conectivitatea dispozitivului cu serverul.
- Verificati ca adresa dispozitivului apartine uneia dintre retelele CIDR autorizate.
- Verificati separarea retelelor Wi-Fi si VLAN, daca exista.
- Verificati certificatul radacina public instalat si acceptat de dispozitiv.
Nu extindeti regula firewall la orice adresa daca accesul trebuie limitat la LAN.
Regula Windows Firewall lipseste sau este dezactivata
Daca serviciul propriu si configuratia sunt identificate sigur, Diagnostic poate propune crearea sau repararea regulii proprii. Dialogul cere confirmare Da / Nu, cu Nu implicit.
La alegerea Nu, nu se aplica repararea. La alegerea Da, aplicatia incearca operatia si raporteaza rezultatul. Daca identitatea regulii este ambigua sau apartine altui executabil, repararea automata este refuzata.
Pentru exemplul cu portul 443:
Get-NetFirewallRule -Name "CaddySTS-HTTPS-443" | Select-Object Name,Enabled,Direction,Action
O regula Windows corecta nu garanteaza trecerea traficului prin firewallul furnizorului, router sau antivirus.
Browserul afiseaza eroare de certificat
Nu ignorati avertismentul HTTPS.
- In modul public, verificati certificatul prezentat, IP-ul accesat si data expirarii. Verificati si conditiile de reinnoire.
- In modul LAN, verificati daca dispozitivul are instalat certificatul radacina public al CA Caddy si daca acesta este considerat de incredere.
- Nu stergeti autoritatea de certificare sau cheile private existente ca metoda de depanare.
Reinnoirea automata a certificatelor publice trebuie verificata operational; functionarea la instalare nu reprezinta dovada reinnoirii ulterioare.
Instalare NOUA refuzata
Aplicatia poate refuza instalarea daca exista un alt serviciu sau proces Caddy, date existente, un port ocupat ori un executabil care nu trece verificarea. Acest refuz protejeaza instalatiile existente.
Cititi mesajul din Diagnostic si remediati cauza fara stergerea sau suprascrierea serviciilor altor aplicatii.
Recomandari
Pastrati copii de siguranta pentru configuratia HTTPS si datele persistente; verificati separat serviciul CaddySTS, Mobile.Api si reteaua. Dupa o actualizare a kitului, reluati Diagnostic si verificarea HTTPS.