# Linux/VPS: внутренний генератор PDF

Скопируйте проект в /opt/pdfmake-workshop, установите Node.js 24 LTS >=24.15 и npm ci --omit=dev --ignore-scripts. Установка dev-зависимостей нужна для build/test; готовая public уже собрана. Статику public можно раздавать Nginx/Caddy. Для CLI/API используйте отдельного системного пользователя. Приватные файлы не кладите в public.

```bash
sudo useradd --system --home /opt/pdfmake-workshop --shell /usr/sbin/nologin pdfmake
cd /opt/pdfmake-workshop
npm ci --omit=dev --ignore-scripts
command -v node
```
Если пользователь уже создан, повторять useradd не требуется. Ниже путь /usr/bin/node нужно заменить результатом command -v node. Не используйте путь к Node из личного nvm без обеспечения доступа службе.

Создайте /etc/systemd/system/pdfmake-workshop.service:
```ini
[Unit]
Description=Internal pdfmake invoice generator
After=network.target

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

[Install]
WantedBy=multi-user.target
```
```bash
sudo systemctl daemon-reload
sudo systemctl enable --now pdfmake-workshop
sudo systemctl status pdfmake-workshop --no-pager
sudo journalctl -u pdfmake-workshop -n 50 --no-pager
curl --fail-with-body -H 'Content-Type: application/json' --data-binary @fixtures/invoice.json http://127.0.0.1:8576/invoice -o /tmp/invoice-vps.pdf
```
512M — пример ограничения службы, не измеренный предел библиотеки. Выберите по нагрузочным замерам. API нельзя открыть наружу как есть: сначала основной backend проверяет сессию и право на заказ, получает цены из БД, затем вызывает loopback-генератор. Не доверяйте сумме из браузера. Настройте лимит запросов/тайм-аут на основном backend. Для массовых документов используйте очередь и отдельные workers.

## Nginx для публичной мастерской
```nginx
location /pdfmake-demo/ {
    alias /opt/pdfmake-workshop/public/;
    index index.html;
}
```
Общий include mime.types должен обслуживать .js как JavaScript. Публичный worker намеренно называется pdf.worker.min.js: некоторые серверы отдают .mjs как application/octet-stream и блокируют module worker. Проверяйте Content-Type фактического файла, а не только его расширение. После изменения выполняйте nginx -t и reload по правилам своего сервера.

## Контейнер для CLI
```bash
docker build -t aen-pdfmake-local .
docker run --rm --network none --read-only --tmpfs /tmp:rw,nosuid,size=32m aen-pdfmake-local
```
Команда проверяет генерацию во временный /tmp; при завершении файл удалится вместе с контейнером. Для сохранения выделите отдельный каталог вывода, дайте пользователю node право записи, примонтируйте его и передайте новый путь /output/invoice.pdf. В контейнере нет браузера или LibreOffice: pdfmake создаёт PDF самостоятельно. systemd/API и контейнер CLI — альтернативные способы запуска; не включайте оба без задачи.
