Řešení problémů¶
Kamera ve skeneru nefunguje¶
Prohlížeč povolí kameru jen na https:// nebo localhost. Ověřte, že aplikace běží přes HTTPS, a v nastavení webu v prohlížeči povolte kameru.
CSRF chyba (403) po odeslání formuláře¶
V .env chybí doména v CSRF_TRUSTED_ORIGINS. Musí obsahovat plný origin včetně schématu, např. https://odbavto.example.cz. Za proxy musí být BEHIND_PROXY=True.
Bad Request (400)¶
Doména nebo IP, přes kterou aplikaci otevíráte, chybí v ALLOWED_HOSTS.
502 Bad Gateway za Caddy¶
- Kontejner
webneběží nebo ještě startuje (migrace):docker compose logs -f web. - Caddy není v síti
web, nebo se vCaddyfileneshoduje název kontejneru (<COMPOSE_PROJECT_NAME>-web:8000).
Skener „bliká“ připojeno / odpojeno¶
WebSocket se rozpadá každých ~5 s. REDIS_SOCKET_TIMEOUT musí být víc než 5 (výchozí 30). Po změně aplikaci restartujte.
WebUSB: tiskárna se nenabízí při párování (Windows)¶
Windows drží tiskárnu svým ovladačem. Nainstalujte WinUSB přes Zadig, viz Tiskárny. WebUSB funguje jen v Chrome a Edge.
Síťová tiskárna netiskne¶
Ověřte ping <IP> ze serveru a port 9100. U Brother QL viz řešení problémů Brother. Pokud server běží v cloudu, na tiskárnu v lokální síti nedosáhne. Použijte agenta.
Agent tiskne dvakrát¶
Běží dvě instance agenta se stejným tokenem pro stejnou tiskárnu. Nechte jen jednu.
Agent: NoBackendError (macOS / Linux)¶
Chybí knihovna libusb: brew install libusb (macOS) nebo sudo apt install libusb-1.0-0 (Linux).
Agent: Access denied (Linux)¶
Přístup k USB bez roota vyžaduje udev pravidlo. Případně nainstalujte tiskárnu do CUPS, agent pak tiskne přes lpr.
Direct: tiskárna netiskne (Windows)¶
Název tiskárny v aplikaci musí přesně odpovídat názvu ve Windows (Tiskárny a skenery). Seznam vypíše python agent.py --list-printers.
Hosteska vidí „Odbavování ještě není otevřen银
Akce nemá žádnou aktivní odbavovací frontu. Vytvořte nebo aktivujte frontu v Nastavení → Přístupy.
Překlad se nezobrazuje (lokální instalace)¶
Pak restartujte server a vyprázdněte mezipaměť prohlížeče.