Files
XC_VM/docs/ru/administration/ssl-generation.md
T
Divarion-D 040143215a docs: Full Docsify documentation (EN + RU) and migration replacement
Full bilingual documentation for XC_VM has been added
with Docsify SPA and the outdated database migration has been replaced.

## Docsify

- docs/index.html — SPA entry point: en-us/ru-ru routing,
search, syntax highlighting (bash, PHP, SQL, nginx, JSON)

## EN Documentation

- docs/en/info/faq.md — FAQ (12 questions: streams, access, database, SSL, updates, permissions)
- docs/en/info/migration_guide.md — migration guide from other systems
- docs/en/info/update.md — step-by-step update via the web panel
- docs/en/info/watch_folder.md — Watch Folder: workflow, PTN/guessit parsers, configuration
- docs/en/updates_checklist.md — release preparation checklist

## RU Documentation (fully localized)

- docs/ru/README.md — Main Page
- docs/ru/_sidebar.md — Sidebar Navigation
- docs/ru/administration/ssl-generation.md — Self-Signed SSL Generation
- docs/ru/administration/update-system.md — Update Mechanism (PHP → Python → Post-Update)
- docs/ru/api/playlist.md — Playlist API with Error Codes
- docs/ru/api/system_api.md — System API (13 endpoints)
- docs/ru/api/xtreamcodes_api.md — XtreamCodes API (Authorization, Live, VOD, TV Series, EPG)
- docs/ru/builds/build_binaries.md — nginx build, nginx_rtmp, PHP-FPM, network
- docs/ru/builds/build_ffmpeg.md — Building FFmpeg 8.0 with NVENC/CUDA
- docs/ru/builds/build_system.md — MAIN vs. LB build system
- docs/ru/development/cli-tools.md — CLI: 26 commands, 25 crons, 8 daemons, database migrations
- docs/ru/info/faq.md — FAQ (12 questions)
- docs/ru/info/migration_guide.md — Migration guide
- docs/ru/info/update.md — Updating via the control panel
- docs/ru/info/watch_folder.md — Watch Folder
- docs/ru/updates_checklist.md — Release checklist

## Migrations

- Removed: 001_drop_watch_folders_plex_token.sql (Deprecated)
- Added: 001_update_crontab_filenames.sql — removes the .php suffix from filenames in the crontab table (switches to console.php commands)
2026-03-15 00:02:19 +03:00

6.1 KiB

🔒 Генерация SSL-сертификата для Nginx в XC_VM

В этом документе описан процесс создания самоподписанного SSL-сертификата. Следуйте шагам, чтобы настроить безопасное HTTPS-соединение.


📚 Навигация


📘 Введение

SSL (Secure Sockets Layer) используется для шифрования соединений между клиентом и сервером, обеспечивая безопасность данных и доверие пользователей. В этой инструкции показано, как создать самоподписанный SSL-сертификат для встроенного Nginx в проекте XC_VM.


🧭 Расположение конфигурации

Все SSL-файлы (ключ, сертификат и конфигурация) хранятся в директории:

/home/xc_vm/bin/nginx/conf

Перед началом работы перейдите в неё:

cd /home/xc_vm/bin/nginx/conf

🧱 Шаг 1. Создание приватного ключа

Сгенерируйте RSA-приватный ключ (2048 бит):

openssl genrsa -out server.key 2048

📄 После выполнения появится файл server.key, содержащий закрытый ключ. Храните его в секрете — этот файл используется для подписи SSL-сертификата.


⚙️ Шаг 2. Создание конфигурационного файла server.cnf

Создайте файл конфигурации с параметрами сертификата:

cat > server.cnf << EOF
[req]
distinguished_name = req_distinguished_name
x509_extensions = v3_req
prompt = no

[req_distinguished_name]
C = RU
ST = Moscow
L = Moscow
O = XC_VM
OU = XC_VM
CN = XC_VM

[v3_req]
keyUsage = keyEncipherment, dataEncipherment
extendedKeyUsage = serverAuth
subjectAltName = @alt_names

[alt_names]
DNS.1 = XC_VM
EOF

📘 Описание параметров:

Поле Значение Назначение
C RU Страна (Country)
ST Moscow Регион (State)
L Moscow Город (Locality)
O XC_VM Организация
OU XC_VM Отдел / подразделение
CN XC_VM Имя хоста (Common Name)
DNS.1 XC_VM Альтернативное имя домена (SAN)

💡 Совет: можно указать реальное доменное имя, например DNS.1 = example.com, чтобы избежать предупреждений в браузере.


🔑 Шаг 3. Генерация самоподписанного SSL-сертификата

Сгенерируйте сертификат с помощью созданного ключа и конфигурации:

openssl req -new -x509 -key server.key -out server.crt -days 3650 -config server.cnf

📆 Пояснения:

  • -new -x509 — создаёт новый самоподписанный сертификат.
  • -days 3650 — срок действия сертификата (10 лет).
  • -config server.cnf — использование конфигурационного файла.
  • Результатом будет файл server.crt.

📂 Итоговые файлы

После всех шагов в /home/xc_vm/bin/nginx/conf должны находиться:

Файл Назначение
server.key Приватный ключ
server.crt Самоподписанный SSL-сертификат
server.cnf Конфигурация сертификата

✅ Результат

Теперь ваш XC_VM Nginx сервер доступен по протоколу HTTPS, используя созданный самоподписанный сертификат. Браузеры могут предупреждать о «недоверенном сертификате» — это нормально для самоподписанных SSL.


⚠️ Примечания

  • Самоподписанные сертификаты подходят для внутреннего использования или тестирования.
  • Для публичных доменов используйте сертификаты от доверенных центров (например, Let's Encrypt).
  • При изменении доменного имени (CN или DNS.1) необходимо сгенерировать сертификат заново.
  • Чтобы проверить сертификат, выполните:
openssl x509 -in server.crt -text -noout