Vanlige problemer
Distribusjonsproblemer i Kanera er vanligvis konfigurasjon snarere enn kode: et domene som peker på feil tjeneste, en cookie-innstilling som ikke samsvarer med den offentlige nettadressen, eller en hemmelighet som endret seg mellom distribusjoner.
Arbeid gjennom en ny distribusjon i rekkefølge
For en distribusjon som aldri har fungert, sjekk disse i rekkefølge i stedet for å hoppe til symptomet:
- Bekreft at de nødvendige miljøvariablene er til stede. Se Konfigurer miljøfilen.
- Sjekk at PostgreSQL og Valkey er sunne.
- Sjekk API- og arbeidsloggene.
- Bekreft at endepunktene for folkehelsen svarer. Se Sjekk distribusjonen.
- Bekreft omvendt proxy-routing og klarerte offentlige nettadresser. Se Tjenester og rute.
- Test SMTP-, lagrings- og sikkerhetskopieringskonfigurasjon separat.
Hvert trinn avhenger av de over det, så en feil på trinn 4 er sjelden verdt feilsøking før trinn 2 passerer.
Symptomer og kontroller
| Problem | Hva du skal sjekke |
|---|---|
| Brukere logges ut etter innlogging. | Bekreft COOKIE_SECURE=true, COOKIE_DOMAIN, og WEB_ORIGIN Passer til det offentlige HTTPS-domenet. |
| Alle ble utskrevet etter en utplassering. | JWT_SECRET Endret. Gjenopprett forrige verdi. |
| Autentiseringskoder sluttet å fungere for alle registrerte brukere. | MFA_ENCRYPTION_KEY Endret. Gjenopprett forrige verdi. |
/api/health feiler på web-domenet. | Bekreft domeneruter til web Service på havnen 80Ikke direkte til api. |
| Offentlig API svarer ikke. | Bekreft domenet ruter til public-api på port 3001. |
| MCP svarer ikke. | Bekreft domenet ruter til mcp på port 3002, MCP_SERVER_PUBLIC_URL Punkter i offentligheten /mcp URL, og KANERA_PUBLIC_API_URL er http://public-api:3001 Inne i komponert. |
| MCP er sunt, men hver OAuth-forespørsel mislykkes. | Bekreft MCP_PUBLIC_URL Det er det eksakte publikum /mcp Ressurser og MCP_INTERNAL_SECRET er den samme ikke-JWT-verdien i public-api og mcp. Reconnection er nødvendig bare etter den eldre ubundet-token migrasjon, ikke etter lese / skrive policy oppdatering. |
| Grenseverdiene påvirker alle på en gang. | Bekreft API_TRUST_PROXY=true og PUBLIC_API_TRUST_PROXY=true Når det er en pålitelig proxy. |
| E-postbekreftelse blokkerer brukere. | Forlat EMAIL_VERIFICATION_ENABLED=false Når SMTP virker |
| Ingen e-post kommer i det hele tatt. | Sjekk SMTP-verdier og arbeideren logger. E-post sendes av worker Tjenesten, ikke API. |
| Opplastinger forsvinner etter omplassering. | Bekreft kanera_uploads er vedvarende eller konfigurere S3-kompatibel lagring. |
| Vedleggene er ikke lenger åpne. | MEDIA_SIGNING_SECRET endret, ugyldiggjør eksisterende signerte nettadresser. |
| Et chatmål eller en personlig webhook sluttet å fungere etter en distribusjon. | SECRETS_ENCRYPTION_KEY endret, slik at lagret legitimasjon ikke lenger kan dekrypteres. Gjenopprett forrige verdi. |
| Nettleser-push kan ikke aktiveres. | Bekreft HTTPS, så at en organisasjonsadministrator har aktivert organisasjonspush. Se E-post og varsler. |
| En bruker kan ikke lagre en ntfy- eller Gotify-adresse på det interne nettverket. | Private mottakere blir nektet KANERA_ALLOW_PRIVATE_NOTIFICATION_DESTINATIONS=true. |
Utplasseringsreferanse
Den implementeringsstøttede distribusjonsreferansen er DEPLOY.md.
For problemer inne i appen i stedet for distribusjonen – pålogging, tillatelser, varsler, integreringer, opplastinger – start fra Feilsøking.
Be om hjelp
Når du rapporterer et distribusjonsproblem, inkluderer du:
- Hva du prøvde å gjøre, og siden eller kontrollen du brukte.
- Hva du forventet og hva som skjedde i stedet.
- Relevante tjenestelogger med hemmeligheter fjernet.
- Om utplasseringen er ny eller tidligere i drift.
- Nettleser- og operativsystemversjoner når det er relevant.
E-post [email protected] for støtte eller Åpne et GitHub-problem for et reproduserbart programvare- eller dokumentasjonsproblem. Inkluder aldri passord, API-nøkler, tokens, kundedata eller private vedlegg.