shop
358 lines
11 KiB
Markdown
358 lines
11 KiB
Markdown
# Shop
|
||
|
||
Интернет-магазин на **Node.js** с локальной базой **SQLite**.
|
||
|
||
## Возможности
|
||
|
||
- Каталог товаров с категориями и поиском
|
||
- Корзина и оформление заказа
|
||
- Регистрация и вход пользователей
|
||
- История заказов в личном кабинете
|
||
|
||
## Требования
|
||
|
||
- Node.js 18+
|
||
- npm
|
||
- На Linux для сборки `better-sqlite3`: `build-essential`, `python3`
|
||
|
||
---
|
||
|
||
## Быстрый развёртывание на Ubuntu
|
||
|
||
Скопируйте блок целиком на чистый сервер Ubuntu 22.04 / 24.04 (от root или через `sudo`):
|
||
|
||
```bash
|
||
# 1. Зависимости системы
|
||
apt update
|
||
apt install -y git curl build-essential python3
|
||
|
||
# 2. Node.js 20 LTS
|
||
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
|
||
apt install -y nodejs
|
||
|
||
# 3. Клонирование (подставьте URL вашего репозитория)
|
||
cd /opt
|
||
git clone <URL_РЕПОЗИТОРИЯ> shop
|
||
cd shop
|
||
|
||
# 4. Настройка окружения
|
||
cp .env.example .env
|
||
# Сгенерируйте секрет сессии:
|
||
sed -i "s/change-me-to-a-long-random-string/$(openssl rand -hex 32)/" .env
|
||
|
||
# 5. Установка приложения
|
||
npm install --omit=dev
|
||
|
||
# 6. Caddy (HTTPS + прокси) — см. раздел ниже; для проверки без домена:
|
||
npm start
|
||
```
|
||
|
||
Без Caddy сайт на **http://IP_СЕРВЕРА:3000**. С Caddy — **https://ваш-домен** (любой, указанный в `Caddyfile`).
|
||
|
||
В `.env` для production задайте (уже есть в `.env.example`):
|
||
|
||
```env
|
||
PORT=3000
|
||
HOST=127.0.0.1
|
||
NODE_ENV=production
|
||
TRUST_PROXY=1
|
||
SESSION_SECRET=ваш-длинный-секрет
|
||
```
|
||
|
||
`HOST=127.0.0.1` — Node слушает только localhost; снаружи доступ через Caddy.
|
||
|
||
При первом запуске создаются `data/shop.db`, `data/sessions.db` и демо-товары.
|
||
|
||
---
|
||
|
||
## Запуск как служба (systemd)
|
||
|
||
Чтобы магазин работал после перезагрузки сервера:
|
||
|
||
```bash
|
||
cp /opt/shop/deploy/shop.service /etc/systemd/system/shop.service
|
||
|
||
# Код обновляйте от root; НЕ делайте chown -R на весь /opt/shop (ломает git pull)
|
||
cd /opt/shop
|
||
git config --global --add safe.directory /opt/shop
|
||
git pull
|
||
npm install --omit=dev
|
||
|
||
# Запись только в data/ — для пользователя службы www-data
|
||
mkdir -p /opt/shop/data
|
||
chown -R www-data:www-data /opt/shop/data
|
||
chmod +x /opt/shop/scripts/diagnose-502.sh 2>/dev/null || true
|
||
|
||
systemctl daemon-reload
|
||
systemctl enable shop
|
||
systemctl start shop
|
||
systemctl status shop
|
||
|
||
# Backend должен ответить:
|
||
curl -s http://127.0.0.1:3000/health
|
||
# {"ok":true,"service":"shop"}
|
||
```
|
||
|
||
Логи: `journalctl -u shop -f`
|
||
|
||
---
|
||
|
||
## Проверка после установки
|
||
|
||
Перед настройкой Caddy убедитесь, что Node отвечает локально:
|
||
|
||
```bash
|
||
cd /opt/shop
|
||
systemctl restart shop
|
||
sleep 1
|
||
|
||
curl -s http://127.0.0.1:3000/health
|
||
# {"ok":true,"service":"shop"}
|
||
|
||
ss -tlnp | grep 3000
|
||
# LISTEN ... 127.0.0.1:3000 ... node
|
||
|
||
journalctl -u shop -n 5 --no-pager
|
||
# должна быть строка: Магазин: http://127.0.0.1:3000
|
||
```
|
||
|
||
Если в логе только «База уже содержит товары…» и служба сразу останавливается — обновите код: `git pull` (нужна актуальная версия `seed.js`).
|
||
|
||
После успешной проверки настройте Caddy и выполните:
|
||
|
||
```bash
|
||
systemctl reload caddy
|
||
```
|
||
|
||
Обновление на сервере одной командой:
|
||
|
||
```bash
|
||
bash /opt/shop/scripts/server-update.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Caddy — SSL и reverse proxy (рекомендуется)
|
||
|
||
[Caddy](https://caddyserver.com/) автоматически выпускает и продлевает сертификаты Let's Encrypt.
|
||
|
||
**Перед установкой:**
|
||
|
||
1. Домен указывает на IP сервера (A-запись).
|
||
2. Открыты порты **80** и **443** в файрволе.
|
||
3. Служба `shop` запущена и слушает `127.0.0.1:3000`.
|
||
|
||
### Установка Caddy на Ubuntu
|
||
|
||
```bash
|
||
apt install -y debian-keyring debian-archive-keyring apt-transport-https
|
||
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
|
||
| gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
|
||
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
|
||
| tee /etc/apt/sources.list.d/caddy-stable.list
|
||
apt update
|
||
apt install -y caddy
|
||
```
|
||
|
||
### Конфигурация
|
||
|
||
В репозитории лежит пример: `caddy/Caddyfile.example`.
|
||
|
||
```bash
|
||
# Замените shop.example.com и email на свои
|
||
cp /opt/shop/caddy/Caddyfile.example /etc/caddy/Caddyfile
|
||
nano /etc/caddy/Caddyfile
|
||
```
|
||
|
||
Пример `/etc/caddy/Caddyfile`:
|
||
|
||
```caddyfile
|
||
{
|
||
email admin@example.com
|
||
}
|
||
|
||
shop.example.com {
|
||
encode gzip zstd
|
||
reverse_proxy 127.0.0.1:3000
|
||
}
|
||
```
|
||
|
||
Проверка и перезапуск:
|
||
|
||
```bash
|
||
caddy validate --config /etc/caddy/Caddyfile
|
||
systemctl enable caddy
|
||
systemctl reload caddy
|
||
systemctl status caddy
|
||
```
|
||
|
||
Сайт откроется по домену из блока `Caddyfile` (в примере — `shop.example.com`).
|
||
|
||
Логи Caddy: `journalctl -u caddy -f`
|
||
|
||
### Файрвол (ufw)
|
||
|
||
```bash
|
||
ufw allow 22/tcp
|
||
ufw allow 80/tcp
|
||
ufw allow 443/tcp
|
||
ufw enable
|
||
```
|
||
|
||
Порт **3000** наружу не открывайте — к приложению ходят только через Caddy.
|
||
|
||
### Порядок запуска после перезагрузки
|
||
|
||
1. `shop` (Node.js на `127.0.0.1:3000`)
|
||
2. `caddy` (прокси + HTTPS)
|
||
|
||
### HTTP 502 при рабочем SSL
|
||
|
||
**SSL есть, 502 — значит Caddy жив, а Node на `127.0.0.1:3000` не отвечает.**
|
||
|
||
На сервере выполните:
|
||
|
||
```bash
|
||
bash /opt/shop/scripts/diagnose-502.sh
|
||
journalctl -u shop -n 50 --no-pager
|
||
curl -v http://127.0.0.1:3000/health
|
||
```
|
||
|
||
**Частые причины и исправление:**
|
||
|
||
| Причина | Что сделать |
|
||
|--------|-------------|
|
||
| Служба `shop` не запущена или падает | `systemctl restart shop`, смотрите логи `journalctl -u shop -f` |
|
||
| Нет `npm install` / сломан `better-sqlite3` | `cd /opt/shop && npm install --omit=dev` (нужны `build-essential`, `python3`) |
|
||
| Нет прав на `data/` у `www-data` | `mkdir -p /opt/shop/data && chown -R www-data:www-data /opt/shop/data` |
|
||
| `dubious ownership` / нет `git pull` | `chown -R root:root /opt/shop` + `safe.directory` (см. выше) |
|
||
| В `.env` нет `HOST`/`PORT` | `HOST=127.0.0.1`, `PORT=3000`, затем `systemctl restart shop` |
|
||
| Неверный путь к `node` в systemd | `which node` → подставьте в `ExecStart` в `/etc/systemd/system/shop.service` |
|
||
| Caddy стартовал раньше shop | `cp deploy/caddy-after-shop.conf /etc/systemd/system/caddy.service.d/shop.conf` и `daemon-reload` |
|
||
| В логе seed и сразу `Deactivated` | `git pull` — старый `seed.js` вызывал `process.exit` до старта сервера |
|
||
|
||
**Быстрое восстановление:**
|
||
|
||
```bash
|
||
cd /opt/shop
|
||
git config --global --add safe.directory /opt/shop
|
||
git pull
|
||
npm install --omit=dev
|
||
mkdir -p data
|
||
chown -R www-data:www-data /opt/shop/data
|
||
systemctl restart shop
|
||
curl -s http://127.0.0.1:3000/health # должен быть {"ok":true,...}
|
||
systemctl reload caddy
|
||
```
|
||
|
||
**Ошибка `dubious ownership` при `git pull`:**
|
||
|
||
Вы сделали `chown -R www-data` на весь каталог. Верните владельца репозиторию root и оставьте `data/` за www-data:
|
||
|
||
```bash
|
||
chown -R root:root /opt/shop
|
||
chown -R www-data:www-data /opt/shop/data
|
||
git config --global --add safe.directory /opt/shop
|
||
git pull
|
||
```
|
||
|
||
Пока `curl http://127.0.0.1:3000/health` не возвращает OK — HTTPS через Caddy будет отдавать 502.
|
||
|
||
### Другие проблемы
|
||
|
||
| Симптом | Решение |
|
||
|--------|---------|
|
||
| Нет сертификата | DNS, порты 80/443, верный домен в `Caddyfile` |
|
||
| Редирект-цикл / нет cookies | В `.env`: `TRUST_PROXY=1`, `NODE_ENV=production` |
|
||
|
||
---
|
||
|
||
## Обновление с Git
|
||
|
||
```bash
|
||
cd /opt/shop
|
||
bash scripts/server-update.sh
|
||
```
|
||
|
||
Или вручную:
|
||
|
||
```bash
|
||
cd /opt/shop
|
||
git config --global --add safe.directory /opt/shop
|
||
git pull
|
||
npm install --omit=dev
|
||
mkdir -p data && chown -R www-data:www-data data
|
||
systemctl restart shop
|
||
curl -s http://127.0.0.1:3000/health
|
||
systemctl reload caddy # если меняли Caddyfile
|
||
```
|
||
|
||
---
|
||
|
||
## Локальная разработка
|
||
|
||
```bash
|
||
npm install
|
||
cp .env.example .env
|
||
npm run dev
|
||
```
|
||
|
||
Сайт: [http://localhost:3000](http://localhost:3000)
|
||
|
||
## Переменные окружения
|
||
|
||
| Переменная | Описание | По умолчанию |
|
||
|------------------|---------------------------|----------------|
|
||
| `PORT` | Порт HTTP-сервера | `3000` |
|
||
| `HOST` | Адрес привязки | `0.0.0.0` (dev), `127.0.0.1` (prod) |
|
||
| `NODE_ENV` | Режим (`production` — secure cookies) | — |
|
||
| `TRUST_PROXY` | Доверять заголовкам Caddy (`1`) | — |
|
||
| `SESSION_SECRET` | Секрет для сессий | dev-значение |
|
||
|
||
## Скрипты npm
|
||
|
||
| Команда | Описание |
|
||
|----------------|----------------------------------|
|
||
| `npm start` | Запуск сервера (production) |
|
||
| `npm run dev` | Запуск с автоперезагрузкой |
|
||
| `npm run seed` | Заполнение каталога, если пуст |
|
||
|
||
## База данных
|
||
|
||
Локально в каталоге `data/`:
|
||
|
||
- `shop.db` — товары, пользователи, заказы
|
||
- `sessions.db` — сессии
|
||
|
||
Каталог `data/` в git не попадает (см. `.gitignore`). Делайте резервные копии:
|
||
|
||
```bash
|
||
cp -a data/shop.db data/shop.db.bak
|
||
```
|
||
|
||
## Структура проекта
|
||
|
||
```
|
||
caddy/
|
||
Caddyfile.example — пример reverse proxy + SSL
|
||
deploy/
|
||
shop.service — unit для systemd
|
||
scripts/
|
||
diagnose-502.sh — проверка при 502
|
||
server-update.sh — git pull + restart + health
|
||
src/
|
||
server.js — точка входа
|
||
db.js — схема SQLite
|
||
seed.js — демо-данные
|
||
routes/ — маршруты
|
||
views/ — шаблоны EJS
|
||
public/css/ — стили
|
||
```
|
||
|
||
## Репозиторий
|
||
|
||
```bash
|
||
git clone <URL_РЕПОЗИТОРИЯ> shop
|
||
cd shop
|
||
```
|