🚀
blog.cat.ssl

SSL для приложения на Node.js: через Nginx или напрямую

20.11.2026
← Все статьи

Когда приложение на Node.js выходит в интернет, вопрос SSL решается немного иначе, чем у PHP-сайтов. У PHP-сайта сертификатом управляет веб-сервер или хостинг-панель, а приложение на Node.js часто само является HTTP-сервером и обычно слушает порт вроде 3000. Поэтому возникает выбор, где включать HTTPS: поставить перед приложением Nginx или подключить сертификат прямо внутри Node.js. В статье разберём оба пути с практическими настройками и объясним, какой из них когда подходит.

Два подхода и их различия

В первом варианте Nginx работает обратным прокси: он занимает порты 80 и 443, работает с сертификатом и передаёт запросы приложению Node.js на внутренний порт по обычному HTTP. Приложение при этом ничего не знает о шифровании. Во втором варианте встроенный модуль https в Node.js читает файлы сертификата и сам слушает порт 443. Промежуточный слой исчезает, но права на порт, доступ к ключу и продление сертификата теперь ложатся на вас.

КритерийЧерез NginxНапрямую в Node.js
Продление сертификатаCertbot делает самНужны hook и перезагрузка
Несколько приложений на сервереПросто, разделение по имениСложно, 443 в одном процессе
Статика, сжатие, ограниченияГотово в NginxНужно делать в коде
Дополнительный компонентУстанавливается NginxНе нужен

На практике для большинства проектов вариант с Nginx удобнее и безопаснее. Прямое подключение подходит для небольших внутренних сервисов, тестовых сред или случаев, когда установить Nginx нельзя.

Путь первый: обратный прокси Nginx

Сначала для приложения выбирается поддомен, например app.example.uz, и его A-запись направляется на IP-адрес сервера. Затем в Nginx создаётся обычный HTTP-блок. Заголовки Upgrade и Connection нужны для работы WebSocket, а X-Forwarded-Proto сообщает приложению, что исходный запрос пришёл по HTTPS.

server {
    listen 80;
    server_name app.example.uz;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

После проверки конфигурации и перезагрузки Nginx плагин Certbot для Nginx получает сертификат, сам добавляет блок для порта 443 и предлагает перенаправление с HTTP на HTTPS. Продление тоже выполняется автоматически через системный таймер Certbot, который сам перезагружает Nginx.

sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d app.example.uz

Приложение должно знать, что оно за прокси

За Nginx приложение Node.js видит все запросы с адреса 127.0.0.1 по обычному HTTP. Если в Express не настроить trust proxy, значение req.secure будет неверным, cookie с флагом secure могут не отправляться, а вместо реального IP клиента будет записываться адрес прокси. Важно также слушать только локальный адрес, иначе к порту 3000 можно будет обратиться из интернета напрямую и без шифрования.

const express = require('express');
const app = express();
app.set('trust proxy', 'loopback');
app.listen(3000, '127.0.0.1');

Путь второй: сертификат прямо в Node.js

Если вы решили обойтись без Nginx, приложение само читает сертификат и ключ из файлов и запускает HTTPS-сервер. В примере ниже важен метод setSecureContext: он позволяет загрузить новый сертификат без остановки сервера, и мы привязываем его к сигналу SIGHUP.

const https = require('https');
const fs = require('fs');
const app = require('./app');

const dir = '/etc/myapp/ssl';
const load = () => ({
  key: fs.readFileSync(`${dir}/privkey.pem`),
  cert: fs.readFileSync(`${dir}/fullchain.pem`),
});

const server = https.createServer(load(), app);
server.listen(443);

process.on('SIGHUP', () => server.setSecureContext(load()));

Здесь есть два практических препятствия. Первое — порт: в Linux порты ниже 1024 может слушать только root, а запускать приложение от root опасно. Одно из решений — выдать исполняемому файлу Node.js только право занимать низкие порты. Учтите, что после обновления Node.js это право, возможно, придётся выдать заново.

sudo setcap 'cap_net_bind_service=+ep' "$(readlink -f "$(which node)")"

Второе препятствие — доступ к файлу ключа. Ключи Let's Encrypt хранятся в /etc/letsencrypt с правами только для root. Вместо того чтобы открывать приложению весь каталог, безопаснее через deploy hook Certbot копировать ключ в отдельный каталог, принадлежащий пользователю приложения, и затем отправлять процессу сигнал.

#!/bin/sh
# /etc/letsencrypt/renewal-hooks/deploy/myapp.sh
D=/etc/letsencrypt/live/app.example.uz
[ "$RENEWED_LINEAGE" = "$D" ] || exit 0
install -o myapp -g myapp -m 600 "$D/privkey.pem" /etc/myapp/ssl/privkey.pem
install -o myapp -g myapp -m 644 "$D/fullchain.pem" /etc/myapp/ssl/fullchain.pem
systemctl kill -s HUP myapp.service

Сделайте скрипт исполняемым через chmod +x, в первый раз скопируйте файлы вручную и запустите приложение. После этого при каждом продлении приложение будет получать новый сертификат без перезапуска.

Практический пример: API службы доставки

Небольшая служба доставки в Ташкенте написала на Node.js API для приложения курьеров и запустила его на VPS по адресу app.misol.uz. Сначала разработчик запускал Express прямо на порту 443 от root и продлевал сертификат вручную. Через три месяца сертификат истёк, и мобильное приложение курьеров перестало подключаться к API. После этого архитектуру изменили: API стал работать на 127.0.0.1:3000 от обычного пользователя, перед ним поставили Nginx, сертификат начал продлеваться автоматически через Certbot, а в Express включили trust proxy. Когда позже на тот же сервер добавили панель администратора, понадобилось лишь написать для неё новый блок server.

Проверка результата

При любом способе проверьте из командной строки, что сертификат установлен правильно, и посмотрите его срок. curl покажет заголовки ответа, а openssl — владельца сертификата и срок действия.

curl -I https://app.example.uz
openssl s_client -connect app.example.uz:443 -servername app.example.uz </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -dates

Если вы планируете запускать приложение не на VPS, а на виртуальном хостинге, поддержка Node.js и способ подключения SSL зависят от тарифа. Клиенты sayt.uz могут уточнить эти возможности в личном кабинете или через техническую поддержку.

Похожие статьи

📧 SSL для mail.домен.uz: как убрать предупреждение о сертификате в Outlook ⏳ Лимиты Let's Encrypt: ошибка «too many certificates» и как её решить 📜 Certificate Transparency: как работают открытые журналы SSL-сертификатов 🏢 SSL для внутренних (интранет) сайтов: как защитить офисные системы
🌐 Язык
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English