# Linux/VPS: статическая мастерская и серверная генерация

Это шаблоны внедрения, а не заявление о развёртывании на вашем production сервере. Тесты архива выполняют настоящую генерацию на Node Windows/Linux. SSH-доступы или секреты в проект не входят.

## Статическая страница

Соберите `npm ci && npm test && npm run build` в каталоге релиза. Для живой браузерной мастерской нужен только public и ZIP исходников рядом; Node-процесс на сервере не требуется. Сохраните структуру ссылок, указывающую на `../pptxgenjs-project.zip`.

```bash
sudo install -d -o www-data -g www-data /var/www/pptx-lab/public
sudo cp -a public/. /var/www/pptx-lab/public/
sudo cp pptxgenjs-project.zip /var/www/pptx-lab/
sudo nginx -t
sudo systemctl reload nginx
```

Фрагмент внутри уже настроенного HTTPS server:

```nginx
location /pptx-lab/ {
    alias /var/www/pptx-lab/;
    index index.html;
    autoindex off;
    add_header X-Content-Type-Options nosniff;
}
```

Открывайте `/pptx-lab/public/`. Убедитесь, что глобальный mime.types включает JS/CSS/PNG; HTML вместо app.js означает неверный маршрут. Архив храните рядом только если его действительно можно распространять. Не публикуйте `.env`, node_modules, приватные отчёты и служебный API вместе со статикой.

## Внутренний Node-процесс

API слушает 127.0.0.1:8566 и предназначен для обращения авторизованного приложения на той же машине. Не добавляйте публичный reverse proxy без проверки пользователя и права на конкретные данные.

```bash
sudo useradd --system --home /opt/pptx-report --shell /usr/sbin/nologin pptx-report
sudo install -d -o pptx-report -g pptx-report /opt/pptx-report
# Разместить проверенные src, tools, package.json и package-lock.json в этом каталоге.
cd /opt/pptx-report
sudo -u pptx-report npm ci --omit=dev --ignore-scripts
```

`/etc/systemd/system/pptx-report.service`:

```ini
[Unit]
Description=Internal PPTX report generator
After=network.target

[Service]
Type=simple
User=pptx-report
Group=pptx-report
WorkingDirectory=/opt/pptx-report
Environment=NODE_ENV=production
Environment=PORT=8566
ExecStart=/usr/bin/node /opt/pptx-report/tools/api.mjs
Restart=on-failure
RestartSec=3
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
MemoryMax=512M
TasksMax=64

[Install]
WantedBy=multi-user.target
```

Проверьте `command -v node` и замените ExecStart фактическим абсолютным путём. Для NVM-пользователя системная служба не получает интерактивный shell автоматически. `MemoryMax` — пример эксплуатационного лимита, его подбирают по измерениям ваших отчётов; это не обещание потребления библиотеки.

```bash
sudo systemd-analyze verify /etc/systemd/system/pptx-report.service
sudo systemctl daemon-reload
sudo systemctl enable --now pptx-report
sudo systemctl status pptx-report --no-pager
sudo journalctl -u pptx-report -n 60 --no-pager
curl --fail-with-body -H 'Content-Type: application/json' --data-binary @fixtures/report.json http://127.0.0.1:8566/report -o result.pptx
```

Приложение должно получить данные отчёта само, проверить доступ и отправить валидированный JSON генератору. Не доверяйте идентификатору клиента, переданному посетителем. Ответ содержит `Cache-Control: no-store`; приватные скачивания также должны проходить авторизацию. Временный файл, если он нужен, создаётся под случайным серверным именем вне web-root, с ограниченным сроком хранения.

## Нагрузка и сбои

В примере одновременно принимаются две операции, третья получает429. Это учебная защита; сериализация PPTX всё равно занимает CPU и память одного процесса. Для тяжёлой регулярной выгрузки вынесите работу в отдельный процесс/Worker/очередь, храните статус и выдавайте результат по защищённой ссылке. Не обещайте отмену уже начатой внутренней сериализации, если библиотека её не поддерживает. Проверка24KiB защищает вход, но не заменяет эксплуатационный контроль.

Развёртывайте новый код в отдельном каталоге, выполняйте тесты и пробную генерацию, затем переключайте службу. При откате возвращайте предыдущий каталог и перезапускайте только этот unit. Перед обновлением PptxGenJS сохраните эталонные файлы и повторите визуальную проверку в реальном просмотрщике.
