Update auf 3.5.0 Bad Request (400)

Nachdem ich auf 3.5.0 ein Update gemacht habe lief mein Paperless nicht mehr (Bad Request (400)

Claude sagt dazu:
Mein Paperless läuft jetzt wieder.

PR #14735 in 3.5.0 hat das Standard-Verhalten von ALLOWED_HOSTS geändert: Sobald PAPERLESS_URL gesetzt ist, beschränkt sich ALLOWED_HOSTS jetzt auf den Hostnamen aus der PAPERLESS_URL plus localhost. Vorher war der Standard * (alle Hosts erlaubt), unabhängig davon ob PAPERLESS_URL gesetzt war oder nicht. github

Das bedeutet: Alles, was Paperless mit einem anderen Hostnamen/einer anderen IP anspricht (z.B. lokale IP-Adresse, interner Docker-Hostname, Reverse-Proxy), bekommt jetzt einen 400 DisallowedHost-Fehler von Django.


Fix: PAPERLESS_ALLOWED_HOSTS explizit setzen

In deiner docker-compose.env oder den Umgebungsvariablen hinzufügen:

env

PAPERLESS_ALLOWED_HOSTS=deinhost.domain.tld,192.168.1.x,localhost,127.0.0.1

Oder wenn du mehrere Zugriffswege hast (lokale IP, Subdomain, etc.):

env

PAPERLESS_ALLOWED_HOSTS=*

Der Wildcard * entspricht dem alten Verhalten vor 3.5.0 und ist für ein privates Heimnetz völlig akzeptabel.


Typische Szenarien für den Fehler:

Situation Problem
Zugriff per lokaler IP (z.B. 192.168.1.x) aber PAPERLESS_URL = externe Domain IP ist nicht in ALLOWED_HOSTS
Reverse Proxy übergibt internen Hostnamen Hostname stimmt nicht mit PAPERLESS_URL überein
Paperless-AI oder andere Tools greifen per Container-Name auf die API zu Container-Name nicht erlaubt
Health-Probes (Kubernetes/Docker) per Pod-IP IP nicht in ALLOWED_HOSTS

Vollständiges Beispiel für eine typische Heiminstallation mit externem Zugriff:

env

PAPERLESS_URL=https://paperless.deine-domain.de
PAPERLESS_ALLOWED_HOSTS=paperless.deine-domain.de,192.168.1.x,localhost,127.0.0.1
PAPERLESS_CSRF_TRUSTED_ORIGINS=https://paperless.deine-domain.de

bash

docker compose down && docker compose up -d

Bei mir funktioniert es nach dem Update via VPN.

Musste aber auch herausfinden das ich diese Parameter nicht gesetzt habe oder irgendwann verworfen.

War das so Bestandteil der Masterclass im erweiterten Sinn mit Erreichbarkeit via vpn oder so ?

Kann mich nicht mehr wirklich dran erinnern.

PAPERLESS_URL= hatte ich gesetzt. Ab der Version 3.5 muss dann auch noch PAPERLESS_ALLOWED_HOSTS= gesetzt werden sonst bekam ich diesen Bad Request (400)
Also wenn PAPERLESS_URL nicht bei dir vorkommt sollte kein Bad Request kommen

Dann ist das geklärt wieso es bei mir trotzdem geht.

Hab eben nachgeguckt, nichts davon gesetzt und war wohl auch nur in dem Teil der Masterclass den ich übersprungen hab wegen Proxy und gedöns.