Files
MangaBom/DEPLOY.md
2026-11-02 04:08:02 +03:00

75 lines
6.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Перенос MANGABOM на свой сервер
Для текущего OMV (192.168.0.181), автоматического обновления библиотеки и публичного адреса без домена используй [SERVER.md](SERVER.md) и compose.server.yaml. Ниже сохранены способы обычной статической публикации.
Это самостоятельный статический сайт. Для размещения не нужны Node.js, npm, Python, база данных или ChatGPT. Все картинки, шрифты, стили и JavaScript включены в архив. Доступ через ChatGPT на своём сервере не требуется.
## Самый простой вариант: существующий веб-сервер
1. Распакуй архив.
2. Скопируй **содержимое `dist/`** в корень сайта своего домена. Именно содержимое, а не всю папку проекта: `index.html` должен оказаться в document root.
3. Настрой обычную раздачу статических файлов через Nginx, Apache, Caddy либо панель хостинга.
4. Открой домен и проверь `serials.html`, `login.html` и `schedule.html` напрямую.
Страницы используют относительные ссылки. Можно размещать сайт как в корне домена, так и в отдельном каталоге. Для файлов с расширением `.html` не нужно SPA-перенаправление на главную. Отсутствующий файл должен возвращать 404.
## Docker + Nginx / Nginx Proxy Manager
В папке с `compose.yaml` выполни:
```bash
docker compose up -d --build
```
Контейнер раздаёт сайт на `127.0.0.1:8080`. Эта привязка намеренно доступна только с самого сервера. Настрой существующий reverse proxy на этот адрес и включи HTTPS для домена.
Если Nginx Proxy Manager работает в другом контейнере, `127.0.0.1` внутри него относится к нему самому. Подключи оба контейнера к общей Docker-сети и направь Proxy Host на `mangabom:80`, либо используй доступный из NPM адрес хоста. Не меняй привязку на публичную без необходимости.
Конфигурация Nginx находится в `deploy/nginx.conf`. Для обычной установки без Docker замени `root /usr/share/nginx/html` на путь к своей папке `dist` и укажи свой домен в `server_name`.
## Локальный просмотр
Из корня проекта, если установлен Python:
```bash
python3 -m http.server 8080 --directory dist
```
Открой `http://localhost:8080`. Не проверяй работу localStorage через `file://`: нужен HTTP/HTTPS.
## Что хранится у читателя
Избранное, демо-профиль, голос, настройки и черновик обращения лежат в localStorage с префиксом `mangabom.`. При смене домена старые данные браузера автоматически не переносятся. На другом устройстве будет отдельное состояние.
## Что не является подключённым сервисом
- Вход — локальный демо-режим, не настоящая авторизация.
- Поддержка не принимает платежи; подписка не оформляется.
- Обратная связь сохраняет черновик, но не отправляет его.
- Голосование не передаёт голоса на сервер и не считает общий рейтинг.
- Читалка работает на статических изображениях. Перед публикацией обнови `dist/manga/library.json` командой `update-library.cmd`. Аккаунты и синхронизация прогресса между устройствами пока не подключены.
- Юридические страницы — проекты для согласования, а не готовые документы сервиса.
Для серверной авторизации, синхронизации, платежей, отправки обращений и общего голосования потребуется отдельный backend. Для читалки backend не нужен.
## Изменение исходников
Готовые файлы можно редактировать непосредственно в `dist/`. Для генерации страниц из шаблона используй:
```bash
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
python scripts/build-product.py
```
Шаблон главной — `scripts/product-home-template.html`; данные сериалов и содержимое внутренних страниц — `scripts/build-product.py`. Стили — `dist/styles.css`, поведение — `dist/app.js`.
**Важно:** генерация перезаписывает HTML-страницы. Изменения текстов и разметки вноси в шаблон и генератор, если планируешь повторно их запускать. CSS и JavaScript генератор не перезаписывает. `scripts/build-pages.py` и `scripts/home-template.html` сохранены как прежняя версия заглушек; для текущей версии не запускай этот генератор.
## После переноса
Проверь все пункты `REVIEW.md`. Ссылки в переданном чек-листе сделаны относительными и ведут к локальным файлам `dist/`.
Не размещай в публичном document root папки `scripts/`, исходные шаблоны и файлы конфигурации. Публикуется только `dist/`.