From a911e13a9be5ac7d5ef4cbaf6323d5ddb243d676 Mon Sep 17 00:00:00 2001
From: test <test@bk.ru>
Date: Sun, 17 May 2026 07:08:15 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20Troubleshooting?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Troubleshooting.md | 88 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 Troubleshooting.md

diff --git a/Troubleshooting.md b/Troubleshooting.md
new file mode 100644
index 0000000..2539fe2
--- /dev/null
+++ b/Troubleshooting.md
@@ -0,0 +1,88 @@
+# Решение проблем
+
+## Диагностика одной командой
+
+```bash
+bash /opt/shop/scripts/diagnose-502.sh
+```
+
+---
+
+## HTTP 502 (Caddy / браузер)
+
+**SSL работает, страница 502** — Caddy жив, backend (Node) не отвечает.
+
+```bash
+curl -s http://127.0.0.1:3000/health
+systemctl status shop
+journalctl -u shop -n 30 --no-pager
+```
+
+Пока `/health` не OK — Caddy будет отдавать 502.
+
+---
+
+## ECONNREFUSED 127.0.0.1:5432
+
+PostgreSQL не запущен или не установлен.
+
+```bash
+bash /opt/shop/scripts/fix-db-connection.sh
+```
+
+Или вручную:
+
+```bash
+systemctl start postgresql
+pg_isready -h 127.0.0.1 -p 5432
+bash scripts/setup-postgres-ubuntu.sh
+```
+
+Проверьте `DATABASE_URL` в `/opt/shop/.env`.
+
+---
+
+## Служба shop сразу останавливается
+
+В логе только «База уже содержит товары» без строки `Магазин: http://...`:
+
+```bash
+cd /opt/shop && git pull   # нужен исправленный seed.js (v0.10.0+)
+systemctl restart shop
+```
+
+---
+
+## dubious ownership (git pull)
+
+Не делайте `chown -R www-data /opt/shop`.
+
+```bash
+chown -R root:root /opt/shop
+git config --global --add safe.directory /opt/shop
+git pull
+```
+
+---
+
+## Docker: контейнер app unhealthy
+
+```bash
+docker compose logs app
+docker compose logs postgres
+docker compose up -d --build
+```
+
+---
+
+## Docker: нет связи с БД
+
+Проверьте, что `DATABASE_URL` в compose указывает на хост `postgres`, а не `127.0.0.1` (внутри контейнера app).
+
+---
+
+## Полезные ссылки
+
+- [Установка Docker](Install-Docker)
+- [Установка без Docker](Install-Native)
+- [Репозиторий](https://git.evilfox.cc/test/shop10)