Initial MANGABOM website
This commit is contained in:
74
DEPLOY.md
Normal file
74
DEPLOY.md
Normal file
@@ -0,0 +1,74 @@
|
||||
# Перенос 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/`.
|
||||
Reference in New Issue
Block a user