From 7bb1d5b49474fdffd423ccadfbaadeeb4733a059 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=A4=D0=B5=D0=B4=D0=BE=D1=80=D0=BE=D0=B2=20=D0=94=D0=BC?= =?UTF-8?q?=D0=B8=D1=82=D1=80=D0=B8=D0=B8=CC=86?= Date: Thu, 1 Oct 2026 16:29:13 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=BD=D0=BE=D1=81=20la?= =?UTF-8?q?mpac-docker/*=20=D0=B2=20=D0=BA=D0=BE=D1=80=D0=B5=D0=BD=D1=8C?= =?UTF-8?q?=20=D1=80=D0=B5=D0=BF=D0=BE=D0=B7=D0=B8=D1=82=D0=BE=D1=80=D0=B8?= =?UTF-8?q?=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - config/, modules/, cache/, database/ теперь в корне - обновлены пути в docker-compose.yaml, .gitignore, README.md, AGENT.md --- .gitignore | 6 +-- AGENT.md | 22 ++++----- README.md | 47 +++++++++---------- {lampac-docker/config => config}/init.conf | 0 docker-compose.yaml | 18 +++---- .../AdminPanel/manifest.json | 0 .../LampaWeb/plugins/extensions.json | 0 .../modules => modules}/Music/manifest.json | 0 .../Tg-notify.bot/manifest.json | 0 .../modules => modules}/Tracks/manifest.json | 0 10 files changed, 46 insertions(+), 47 deletions(-) rename {lampac-docker/config => config}/init.conf (100%) rename {lampac-docker/modules => modules}/AdminPanel/manifest.json (100%) rename {lampac-docker/modules => modules}/LampaWeb/plugins/extensions.json (100%) rename {lampac-docker/modules => modules}/Music/manifest.json (100%) rename {lampac-docker/modules => modules}/Tg-notify.bot/manifest.json (100%) rename {lampac-docker/modules => modules}/Tracks/manifest.json (100%) diff --git a/.gitignore b/.gitignore index da5884f..7a86136 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,9 @@ # Секреты -lampac-docker/config/passwd +config/passwd # Локальные данные и кеш -lampac-docker/cache/ -lampac-docker/database/ +cache/ +database/ # Медиа DLNA (том ./dlna -> /lampac/data/dlna) dlna/ diff --git a/AGENT.md b/AGENT.md index 808839c..437207c 100644 --- a/AGENT.md +++ b/AGENT.md @@ -17,12 +17,12 @@ | Файл | Назначение | Правила | | --- | --- | --- | | `docker-compose.yaml` | Единственный compose-файл | тома обязательны; фиксированной сети/subnet нет (дефолтная сеть compose) | -| `lampac-docker/config/init.conf` | Конфиг сервера (JSON) | hot-reload для большинства ключей (кроме `BaseModule.SkipModules` — нужен рестарт); строго валидный JSON | -| `lampac-docker/config/passwd` | Пароль root, **секрет** | не выводить в чат/логи/коммиты, в `.gitignore` | -| `lampac-docker/modules/*/manifest.json` | Manifest-оверрайды (`enable: true`) | монтируются поверх `/lampac/module//manifest.json`; для модулей, у которых в образе `enable: false` (сейчас: `Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel`) | -| `lampac-docker/modules/LampaWeb/plugins/extensions.json` | Каталог магазина плагинов (`/extensions`) | override образного файла, добавлена секция «Lampac» (DLNA); после правки сбросить кеш `lampac-docker/cache/static/63/` | -| `lampac-docker/cache/` | Кеш | монтируется в `/lampac/cache` | -| `lampac-docker/database/` | SQLite-БД (Sync, TimeCode, SISI) | монтируется в `/lampac/database`, не удалять | +| `config/init.conf` | Конфиг сервера (JSON) | hot-reload для большинства ключей (кроме `BaseModule.SkipModules` — нужен рестарт); строго валидный JSON | +| `config/passwd` | Пароль root, **секрет** | не выводить в чат/логи/коммиты, в `.gitignore` | +| `modules/*/manifest.json` | Manifest-оверрайды (`enable: true`) | монтируются поверх `/lampac/module//manifest.json`; для модулей, у которых в образе `enable: false` (сейчас: `Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel`) | +| `modules/LampaWeb/plugins/extensions.json` | Каталог магазина плагинов (`/extensions`) | override образного файла, добавлена секция «Lampac» (DLNA); после правки сбросить кеш `cache/static/63/` | +| `cache/` | Кеш | монтируется в `/lampac/cache` | +| `database/` | SQLite-БД (Sync, TimeCode, SISI) | монтируется в `/lampac/database`, не удалять | | `dlna/` | Медиа/превью DLNA | монтируется в `/lampac/data/dlna`, не удалять | | `.gitignore` | Игнорируемые пути | в игноре: `config/passwd` (секрет), `cache/`, `database/`, `dlna/`, `.DS_Store`; остальное (init.conf, modules/, compose, доки) — переносимое | | `README.md` / `AGENT.md` | Документация | обновлять при любых изменениях развёртывания | @@ -45,13 +45,13 @@ curl -fsS -o /dev/null -w '%{http_code}\n' http://localhost:9118/online.js # о 1. **Отвечать по-русски.** 2. После любых изменений в проекте — дополнять `README.md` и `AGENT.md`. -3. Конфиг менять только в `lampac-docker/config/init.conf`; валидность проверять: `python3 -m json.tool lampac-docker/config/init.conf`. -4. Включение/выключение модулей — через `BaseModule.SkipModules` в `init.conf` (добавить имя = выключить; имя = имя папки в `/lampac/module/`, группы вроде `OnlineAnime` выключаются целиком). `SkipModules` **не hot-reload** — после правки нужен `docker compose restart lampac`. Модули, у которых в образе `manifest.json: enable: false` (`Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel`), включаются только manifest-оверрайдом: копия манифеста с `enable: true` в `lampac-docker/modules//manifest.json` + монтирование в compose. Список модулей: https://docs.lampac.dev/modules/overview +3. Конфиг менять только в `config/init.conf`; валидность проверять: `python3 -m json.tool config/init.conf`. +4. Включение/выключение модулей — через `BaseModule.SkipModules` в `init.conf` (добавить имя = выключить; имя = имя папки в `/lampac/module/`, группы вроде `OnlineAnime` выключаются целиком). `SkipModules` **не hot-reload** — после правки нужен `docker compose restart lampac`. Модули, у которых в образе `manifest.json: enable: false` (`Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel`), включаются только manifest-оверрайдом: копия манифеста с `enable: true` в `modules//manifest.json` + монтирование в compose. Список модулей: https://docs.lampac.dev/modules/overview - Текущее состояние: выключены `OnlineAnime`, `OnlineUKR`, `OnlinePaid`, `OnlineGEO`, `Transcoding`, `WebLog`; включены все остальные (TorrServer, Sync/TimeCode/Storage/SyncEvents, Catalog, JacRed, DLNA, SISI, Tracks, Music, Tg-notify.bot, AdminPanel). - Плагины Lampa: `/online.js`, `/sisi.js`, `/dlna.js` и т.д. Большинство Lampac сам подключает клиенту через `/lampainit.js` (см. ниже про `initPlugins`); при необходимости плагин можно добавить вручную по URL. - **Два уровня включения модуля:** (1) `SkipModules`/manifest — модуль скомпилирован и работает на сервере; (2) `LampaWeb.initPlugins.` в `init.conf` — плагин попадает в список, который `/lampainit.js` добавляет клиенту Lampa (`Lampa.Plugins.add`). Без второго флага сервер отвечает, но пункт в Lampa не появится (так было с `dlna` — флаг `initPlugins.dlna` добавлен в init.conf). Дефолты флагов — в `current.conf` секция `LampaWeb.initPlugins`. - - **Магазин плагинов** в Lampa (Настройки → Плагины) читает `/extensions` → `LampaWeb/plugins/extensions.json` (каталог образа). Свои записи добавляются через override-файл в `lampac-docker/modules/LampaWeb/plugins/extensions.json` (монтирован в compose). Ответ кешируется `Staticache` на диске: `lampac-docker/cache/static//` — после правки удалить соответствующий файл (`grep -rl secuses lampac-docker/cache/static/`) или весь каталог static, затем перезапросить. -5. Новые пользовательские модули класть в `lampac-docker/mods//` (монтировать в `/lampac/mods/`), переопределения плагинов — `lampac-docker/plugins/lampainit.js` → `/lampac/plugins/override/lampainit.js`. + - **Магазин плагинов** в Lampa (Настройки → Плагины) читает `/extensions` → `LampaWeb/plugins/extensions.json` (каталог образа). Свои записи добавляются через override-файл в `modules/LampaWeb/plugins/extensions.json` (монтирован в compose). Ответ кешируется `Staticache` на диске: `cache/static//` — после правки удалить соответствующий файл (`grep -rl secuses cache/static/`) или весь каталог static, затем перезапросить. +5. Новые пользовательские модули класть в `mods//` (монтировать в `/lampac/mods/`), переопределения плагинов — `plugins/lampainit.js` → `/lampac/plugins/override/lampainit.js`. 6. Не раскрывать пароль из `passwd`, не коммитить его, не выводить в логи. 7. Не открывать порт 9118 в интернет без файрвола/reverse proxy; модули `DLNA`, `Tracks`, `Transcoding`, `GStreamer`, `Catalog` не предназначены для публичного доступа. 8. Образ пиннить по тегу при необходимости воспроизводимости (в compose сейчас `:latest`). @@ -75,7 +75,7 @@ curl -fsS -o /dev/null -w '%{http_code}\n' http://localhost:9118/online.js # о ## Troubleshooting - **Контейнер нестабилен / Chromium падает** — проверить `shm_size: 1024mb` в compose (обязательно для Playwright). -- **Не стартует после правки init.conf** — проверить JSON: `python3 -m json.tool lampac-docker/config/init.conf`; бэкапы в `/lampac/database/backup/init/`. +- **Не стартует после правки init.conf** — проверить JSON: `python3 -m json.tool config/init.conf`; бэкапы в `/lampac/database/backup/init/`. - **Модуль не загрузился** — смотреть `docker compose logs lampac | grep -E "skip compilation|loaded module"`; для модулей с `enable: false` в образе проверить manifest-оверрайд и его монтирование в compose. - **Tg-notify молчит** — нужен `bot_token` в секции `TelegramBot` init.conf (без него long polling не стартует, в логе предупреждение). - **Занят порт 9118** — `lsof -i :9118` или сменить порт в `init.conf` (`listen.port`) и в `ports` compose-файла одновременно. diff --git a/README.md b/README.md index ae88513..8310a3c 100644 --- a/README.md +++ b/README.md @@ -23,18 +23,17 @@ ```text Lampac/ ├── docker-compose.yaml # Единственный compose-файл (порт 9118) -├── lampac-docker/ -│ ├── config/ -│ │ ├── init.conf # Конфигурация сервера (JSON, hot-reload) -│ │ └── passwd # Пароль root (СЕКРЕТ, не коммитить) -│ ├── modules/ # Overridе-файлы, монтируемые поверх файлов образа -│ │ ├── Tracks/manifest.json -│ │ ├── Music/manifest.json -│ │ ├── Tg-notify.bot/manifest.json -│ │ ├── AdminPanel/manifest.json -│ │ └── LampaWeb/plugins/extensions.json # каталог магазина плагинов (+DLNA) -│ ├── cache/ # Кеш (монтируется в /lampac/cache) -│ └── database/ # SQLite-БД: Sync, TimeCode, SISI (→ /lampac/database) +├── config/ +│ ├── init.conf # Конфигурация сервера (JSON, hot-reload) +│ └── passwd # Пароль root (СЕКРЕТ, не коммитить) +├── modules/ # Overridе-файлы, монтируемые поверх файлов образа +│ ├── Tracks/manifest.json +│ ├── Music/manifest.json +│ ├── Tg-notify.bot/manifest.json +│ ├── AdminPanel/manifest.json +│ └── LampaWeb/plugins/extensions.json # каталог магазина плагинов (+DLNA) +├── cache/ # Кеш (монтируется в /lampac/cache) +├── database/ # SQLite-БД: Sync, TimeCode, SISI (→ /lampac/database) ├── dlna/ # Данные DLNA (медиа/превью, → /lampac/data/dlna) ├── README.md # Эта документация ├── AGENT.md # Инструкции для AI-агента @@ -75,7 +74,7 @@ docker compose ps ## Конфигурация -### `lampac-docker/config/init.conf` +### `config/init.conf` Основной конфиг (JSON). **Перечитывается автоматически без перезапуска** контейнера (watcher каждую секунду, бэкапы — внутри контейнера в `/lampac/database/backup/init/`). После правки достаточно сохранить файл. @@ -103,7 +102,7 @@ docker compose ps **Включены дополнительно к стартовому набору:** - `Catalog`, `JacRed`, `Sync` (вместе с `Storage`, `SyncEvents`, `TimeCode`), `TorrServer`, `DLNA`, `SISI` — убраны из `SkipModules`. -- `Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel` — включены через manifest-оверрайды в `lampac-docker/modules/*/manifest.json` (в образе у них `enable: false`; файлы монтируются поверх `/lampac/module//manifest.json`). +- `Tracks`, `Music`, `Tg-notify.bot`, `AdminPanel` — включены через manifest-оверрайды в `modules/*/manifest.json` (в образе у них `enable: false`; файлы монтируются поверх `/lampac/module//manifest.json`). Чтобы выключить/включить любой другой модуль — добавьте или уберите его имя в `SkipModules` (имя = имя папки в `/lampac/module/`, включая группы вроде `OnlineAnime`). Изменение применяется после `docker compose restart lampac` (SkipModules не hot-reload). Убрать из списка группу `Sync` целиком отключит и `TimeCode`/`Storage`/`SyncEvents`. @@ -138,17 +137,17 @@ docker compose ps После правки перезагрузите страницу Lampa — `lampainit.js` сам добавит плагин (`Lampa.Plugins.add`) и он появится в Настройки → Плагины (со статусом включён). Ручное добавление по ссылке тоже работает: `http://IP_МАШИНЫ:9118/dlna.js`. Прямой UI модуля — `http://IP_МАШИНЫ:9118/dlna`. -**В магазине плагинов** (Настройки → Плагины/«Магазин») каталог отдаётся из `/extensions` — файла `LampaWeb/plugins/extensions.json` внутри образа, где DLNA по умолчанию нет. Добавлена запись через override: `lampac-docker/modules/LampaWeb/plugins/extensions.json` (секция «Lampac» в начале каталога) монтируется поверх образного файла. Магазин кешируется (`Staticache`) — после правки этого файла кеш надо сбросить: удалить `lampac-docker/cache/static/63/*` (каталог по хешу URL) или перезапустить контейнер. +**В магазине плагинов** (Настройки → Плагины/«Магазин») каталог отдаётся из `/extensions` — файла `LampaWeb/plugins/extensions.json` внутри образа, где DLNA по умолчанию нет. Добавлена запись через override: `modules/LampaWeb/plugins/extensions.json` (секция «Lampac» в начале каталога) монтируется поверх образного файла. Магазин кешируется (`Staticache`) — после правки этого файла кеш надо сбросить: удалить `cache/static/63/*` (каталог по хешу URL) или перезапустить контейнер. ### AdminPanel Веб-админка Lampac: правка `init.conf`/`current.conf`, пользователи `users.json`. -- Вход: `http://IP_МАШИНЫ:9118/adminpanel/auth` — пароль из `lampac-docker/config/passwd` (cookie `accspasswd`, живёт 180 дней). +- Вход: `http://IP_МАШИНЫ:9118/adminpanel/auth` — пароль из `config/passwd` (cookie `accspasswd`, живёт 180 дней). - Панель: `http://IP_МАШИНЫ:9118/adminpanel` (без входа — 302 на страницу auth). - Доступ к админке не открывайте в интернет без защиты — см. README модуля AdminPanel. -### `lampac-docker/config/passwd` +### `config/passwd` Пароль учётной записи `root` в одну строку (используется для служебных функций и WebLog). Сгенерирован при установке; для смены отредактируйте файл и перезапустите контейнер: `docker compose restart lampac`. @@ -169,20 +168,20 @@ docker compose up -d ```bash docker-compose.yaml -lampac-docker/config/init.conf # вся конфигурация -lampac-docker/config/passwd # СЕКРЕТ — переносить вне git (scp/rsync) -lampac-docker/modules/ # override-файлы (manifest ×4, extensions.json) +config/init.conf # вся конфигурация +config/passwd # СЕКРЕТ — переносить вне git (scp/rsync) +modules/ # override-файлы (manifest ×4, extensions.json) README.md AGENT.md .gitignore ``` **Копировать по желанию** (данные пользователя, иначе создадутся заново): ```bash -lampac-docker/database/ # закладки Sync, позиции TimeCode, SISI, библиотека Music +database/ # закладки Sync, позиции TimeCode, SISI, библиотека Music dlna/ # медиа/превью DLNA ``` -**Не копировать** — регенерируется автоматически: `lampac-docker/cache/`, содержимое `/lampac/data` внутри контейнера (GeoLite2, ffmpeg/ffprobe, бинарник TorrServer, Lampa UI). +**Не копировать** — регенерируется автоматически: `cache/`, содержимое `/lampac/data` внутри контейнера (GeoLite2, ffmpeg/ffprobe, бинарник TorrServer, Lampa UI). Порядок переноса: скопировать файлы → `docker compose up -d` → health-check: `curl "http://localhost:9118/version?type=hash"`. Порт 9118 и пути в compose относительные — правок не требуется. @@ -201,7 +200,7 @@ docker compose pull && docker compose up -d # обновление до све - Порт 9118 проброшен на все интерфейсы — при выходе в интернет закройте его файрволом или поднимите reverse proxy с аутентификацией. Внутренний порт TorrServer (9085) не проброшен вовсе: он доступен только контейнеру, внешний доступ к TorrServer идёт исключительно через `/ts/` на 9118. - Модули `DLNA`, `Tracks`, `Transcoding`, `GStreamer`, `Catalog` не экранируют входящие запросы — не открывайте их публично без защиты. -- `lampac-docker/config/passwd` содержит секрет — файл добавлен в `.gitignore`. +- `config/passwd` содержит секрет — файл добавлен в `.gitignore`. ## Git-репозиторий @@ -214,7 +213,7 @@ git commit -m "описание" git push origin main ``` -В git попадают только: `docker-compose.yaml`, `lampac-docker/config/init.conf`, `lampac-docker/modules/**`, `README.md`, `AGENT.md`, `.gitignore`. Секреты (`passwd`), `cache/`, `database/`, `dlna/` — в `.gitignore`. +В git попадают только: `docker-compose.yaml`, `config/init.conf`, `modules/**`, `README.md`, `AGENT.md`, `.gitignore`. Секреты (`passwd`), `cache/`, `database/`, `dlna/` — в `.gitignore`. ## Ссылки diff --git a/lampac-docker/config/init.conf b/config/init.conf similarity index 100% rename from lampac-docker/config/init.conf rename to config/init.conf diff --git a/docker-compose.yaml b/docker-compose.yaml index 28f381e..cf710c9 100644 --- a/docker-compose.yaml +++ b/docker-compose.yaml @@ -13,13 +13,13 @@ services: options: tag: "{{.Name}}" volumes: - - ./lampac-docker/config/passwd:/lampac/passwd - - ./lampac-docker/config/init.conf:/lampac/init.conf - - ./lampac-docker/cache:/lampac/cache - - ./lampac-docker/database:/lampac/database - - ./lampac-docker/modules/Tracks/manifest.json:/lampac/module/Tracks/manifest.json:ro - - ./lampac-docker/modules/Music/manifest.json:/lampac/module/Music/manifest.json:ro - - ./lampac-docker/modules/Tg-notify.bot/manifest.json:/lampac/module/Tg-notify.bot/manifest.json:ro - - ./lampac-docker/modules/AdminPanel/manifest.json:/lampac/module/AdminPanel/manifest.json:ro - - ./lampac-docker/modules/LampaWeb/plugins/extensions.json:/lampac/module/LampaWeb/plugins/extensions.json:ro + - ./config/passwd:/lampac/passwd + - ./config/init.conf:/lampac/init.conf + - ./cache:/lampac/cache + - ./database:/lampac/database + - ./modules/Tracks/manifest.json:/lampac/module/Tracks/manifest.json:ro + - ./modules/Music/manifest.json:/lampac/module/Music/manifest.json:ro + - ./modules/Tg-notify.bot/manifest.json:/lampac/module/Tg-notify.bot/manifest.json:ro + - ./modules/AdminPanel/manifest.json:/lampac/module/AdminPanel/manifest.json:ro + - ./modules/LampaWeb/plugins/extensions.json:/lampac/module/LampaWeb/plugins/extensions.json:ro - ./dlna:/lampac/data/dlna diff --git a/lampac-docker/modules/AdminPanel/manifest.json b/modules/AdminPanel/manifest.json similarity index 100% rename from lampac-docker/modules/AdminPanel/manifest.json rename to modules/AdminPanel/manifest.json diff --git a/lampac-docker/modules/LampaWeb/plugins/extensions.json b/modules/LampaWeb/plugins/extensions.json similarity index 100% rename from lampac-docker/modules/LampaWeb/plugins/extensions.json rename to modules/LampaWeb/plugins/extensions.json diff --git a/lampac-docker/modules/Music/manifest.json b/modules/Music/manifest.json similarity index 100% rename from lampac-docker/modules/Music/manifest.json rename to modules/Music/manifest.json diff --git a/lampac-docker/modules/Tg-notify.bot/manifest.json b/modules/Tg-notify.bot/manifest.json similarity index 100% rename from lampac-docker/modules/Tg-notify.bot/manifest.json rename to modules/Tg-notify.bot/manifest.json diff --git a/lampac-docker/modules/Tracks/manifest.json b/modules/Tracks/manifest.json similarity index 100% rename from lampac-docker/modules/Tracks/manifest.json rename to modules/Tracks/manifest.json