shop10/README.md

Shop

Интернет-магазин на Node.js с локальной базой SQLite.

Возможности

• Каталог товаров с категориями и поиском
• Корзина и оформление заказа
• Регистрация и вход пользователей
• История заказов в личном кабинете

Требования

• Node.js 18+
• npm
• На Linux для сборки better-sqlite3: build-essential, python3

---

Быстрый развёртывание на Ubuntu

Скопируйте блок целиком на чистый сервер Ubuntu 22.04 / 24.04 (от root или через sudo):

# 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 https://git.evilfox.cc/test/shop10.git 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://ваш-домен.

В .env для production задайте (уже есть в .env.example):

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)

Чтобы магазин работал после перезагрузки сервера:

cat > /etc/systemd/system/shop.service << 'EOF'
[Unit]
Description=Shop Node.js
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/shop
EnvironmentFile=/opt/shop/.env
ExecStart=/usr/bin/node src/server.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

# Права на каталог (если клонировали в /opt/shop)
chown -R www-data:www-data /opt/shop

systemctl daemon-reload
systemctl enable shop
systemctl start shop
systemctl status shop

Логи: journalctl -u shop -f

---

Caddy — SSL и reverse proxy (рекомендуется)

Caddy автоматически выпускает и продлевает сертификаты Let's Encrypt.

Перед установкой:

1. Домен указывает на IP сервера (A-запись).
2. Открыты порты 80 и 443 в файрволе.
3. Служба shop запущена и слушает 127.0.0.1:3000.

Установка Caddy на Ubuntu

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.

# Замените shop.example.com и email на свои
cp /opt/shop/caddy/Caddyfile.example /etc/caddy/Caddyfile
nano /etc/caddy/Caddyfile

Пример /etc/caddy/Caddyfile:

{
	email admin@example.com
}

shop.example.com {
	encode gzip zstd
	reverse_proxy 127.0.0.1:3000
}

Проверка и перезапуск:

caddy validate --config /etc/caddy/Caddyfile
systemctl enable caddy
systemctl reload caddy
systemctl status caddy

Сайт: https://shop.example.com

Логи Caddy: journalctl -u caddy -f

Файрвол (ufw)

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)

Типичные проблемы

Симптом	Решение
502 Bad Gateway	systemctl status shop, проверьте curl http://127.0.0.1:3000
Нет сертификата	DNS, порты 80/443, верный домен в Caddyfile
Редирект-цикл / нет cookies	В .env: TRUST_PROXY=1, NODE_ENV=production

---

Обновление с Git

cd /opt/shop
systemctl stop shop
git pull
npm install --omit=dev
systemctl start shop
# Caddy перезагружать не нужно, если Caddyfile не менялся

---

Локальная разработка

npm install
cp .env.example .env
npm run dev

Сайт: 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). Делайте резервные копии:

cp -a data/shop.db data/shop.db.bak

Структура проекта

caddy/
  Caddyfile.example   — пример reverse proxy + SSL
src/
  server.js           — точка входа
  db.js               — схема SQLite
  seed.js             — демо-данные
  routes/             — маршруты
  views/              — шаблоны EJS
  public/css/         — стили

Репозиторий

git clone https://git.evilfox.cc/test/shop10.git