Файлы · main · twelve / apricot2 · Mos.Hub

sudo apt update
sudo apt install ffmpeg python3 python3-venv python3-dev

# Для монтирования SMB-источников
sudo apt install cifs-utils

# Для Kerberos / GSSAPI (только при auth_protocol: kerberos в конфиге SMB)
sudo apt install gcc libkrb5-dev
# Установка Homebrew (если ещё не установлен)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Установка Python
brew install ffmpeg python
winget install Gyan.FFmpeg Python.Python.3.12
python --version
git clone https://github.com/ykmn/apricot2
cd apricot2
# 1. Создать окружение (один раз)
python3 -m venv .venv        # Linux / macOS
python  -m venv .venv        # Windows

# 2. Активировать окружение (каждый раз перед работой с проектом)
source .venv/bin/activate    # Linux / macOS
.venv\Scripts\activate       # Windows (cmd)
.venv\Scripts\Activate.ps1   # Windows (PowerShell)

# 3. Установить зависимости
pip install -r requirements.txt
# Для Kerberos / GSSAPI (только при auth_protocol: kerberos в конфиге SMB)
pip install -r requirements-kerberos.txt
config/                          # Рабочая конфигурация (создаётся вами)
├── settings.yaml               # Глобальные настройки
├── secret.yaml                 # Учётные данные SMB
├── ldap.yaml                   # Авторизация (опционально — если файл отсутствует, авторизация отключена)
├── users.yaml                  # Локальные пользователи (если Local: true в ldap.yaml)
├── stations/
│   ├── retro_fm.yaml           # Одна станция = один файл
│   └── europa_plus.yaml
└── playlogs/
    ├── retro_fm.yaml          # Один плейлог для станции = один файл
    └── europa_plus.yaml

config.demo/                    # Демо-конфигурация
cp -r config.demo/ config/
# config/secret.yaml
authorization:
  - id: 1
    username: "logger"
    password: "password1"
    domain: "CORP"
  - id: 2
    username: "svc_radio"
    password: "another_pass"
    domain: "CONTOSO"
  - id: 3
    username: "user1"
    password: "..."
    domain: "EVILCORP"
    auth_protocol: "kerberos"   # кросс-доменный доступ: использует тикет OS
chmod 600 config/secret.yaml
# config/stations/retro_fm.yaml
id: retrofm
name: "Retro FM"

channels:
  - id: retrofm_pgm
    name: "Retro FM — PGM (mp3/64k)"
    smb:
      host: "fileserver.domain.local"   # имя или IP сервера
      share: "LOGGER"                   # имя сетевой шары
      path: "04 Retro/PGM1"           # подпапка внутри шары (необязательно)
      secret: 1                         # ссылка на запись в secret.yaml
    folder_format: "%Y-%m-%d"
    file_format: "%H-%M-%S"
    file_extension: "mp3"
    sample_rate: 48000
    playlogs:
      - retrofm
    playlogs_offset: 500       # смещение плейлога относительно аудио в мс (положительное — вперёд, отрицательное — назад; по умолчанию 0)
  - id: retrofm_fm
    name: "Retro FM — FM (mp3/64k)"
    smb:
      host: "fileserver.domain.local"
      share: "LOGGER"
      path: "04 Retro/FM"
      secret: 1
    folder_format: "%Y-%m-%d"
    file_format: "%H-%M-%S"
    file_extension: "mp3"
    sample_rate: 48000
    playlogs:
      - retrofm
    playlogs_offset: 750
  smb:
    host: "fileserver"
    share: "LOGGER"
    path: "04 Retro/PGM1"
    username: "logger"
    password: "passw"
    # или password_env: "MY_VAR"
    domain: "CONTOSO"
channels:
  - id: retro_fm_pgm_hq
    name: "Retro FM — PGM-HQ (wav/48000)"
    local_path: "/mnt/retro_fm/PGM-HQ"   # Linux/Mac
    # local_path: "Z:\\PGM-HQ"           # Windows (буква диска и двойные слеши в пути к папке)
    folder_format: "%Y-%m-%d"
    file_format: "%H-%M-%S"
    file_extension: "wav"
    sample_rate: 48000
    playlogs:
      - retrofm
  file_extension: "mp3"
  bitrate: "64k"    # 32k, 64k, 128k, 192k, 320k
# config/playlogs/retro_fm.yaml
id: retrofm             # это название указывайте в config/stations/retro_fm.yaml
name: "Retro FM — Плейлог"

sources:
  - priority: 1
    local_path: "/mnt/air-1/Digispot II/DJin/PLAYLOG"        # основная эфирная машина с подключенного диска
    file_mask: "%Y-%m-%d.log"
    encoding: "windows-1251"
    delimiter: ","
    header_skip_prefix: "FIELD LIST"          # первый столбец строки-заголовка (пропустить)
  - priority: 2
    smb:                                     # резервная машина через SMB
      host: "air-2.domain.local"
      share: "Digispot II"                   # имя сетевой шары
      path: "DJin/PLAYLOG"                   # подпапка внутри шары (пусто = корень)
      secret: 1                              # логин-пароль для входа в шару из списка секретов
    file_mask: "%Y-%m-%d.log"
    encoding: "windows-1251"
    delimiter: ","
    header_skip_prefix: "FIELD LIST"

# Маппинг полей файла во внутренние поля приложения
fields:
  datetime:  "EventTime"      # объединённое поле даты и времени
  title:     "ElemName"       # название трека / элемента
  artist:    "ElemArtist"     # исполнитель (если пусто — только ElemName)
  cls:       "ElemClass"      # класс: M/J/C/P/N
  db_id:     "ElemDbId"       # ID в базе данных → всплывает при наведении
  id_number: "ElemIdNumber"   # порядковый номер → всплывает при наведении
  duration:  "ElemLength"     # длина элемента в формате MM:SS.mmm (опционально)

class_colors:
  M: "#1565c0"
  J: "#558b2f"
  C: "#e65100"
  P: "#6a1b9a"
  N: "#37474f"
  default: "#424242"

class_names:
  M: "Музыка"
  J: "Джингл"
  C: "Реклама"
  P: "Передача"
  N: "Новости"
[auth] WARNING: config/users.yaml not found. Temporary admin credentials — login: admin  password: xK9mQz…
[auth] Create config/users.yaml to set permanent credentials.
Local: true   # включить локальную авторизацию
LDAP:  false  # доменная авторизация отключена
users:
  - username: admin
    password: yourStrongPassword     # открытый текст (не рекомендуется)
    password_pbkdf2: "$pbkdf2$sha256$600000$<salt>$<hash>".  # хэш пароля PBKDF2-SHA256
    is_admin: true    # доступ к функциям управления в меню

  - username: user
    password_pbkdf2: "$pbkdf2$sha256$600000$<salt>$<hash>".  # хэш пароля PBKDF2-SHA256
    is_admin: false   # только навигация и экспорт
python tools/hash_password.py
users:
  - username: admin
    password_pbkdf2: "$pbkdf2$sha256$600000$<salt>$<hash>"
    is_admin: true
pip install ldap3 pycryptodome
LDAP:   true
server: "ldap://dc01.corp.local"   # URL LDAP-сервера
domain: "CORP"                     # NetBIOS-имя домена (для NTLM-привязки)
base_dn: "DC=corp,DC=local"        # Корень поиска в каталоге

# Сервисный аккаунт AD для поиска пользователей (read-only).
# Ссылается на запись в secret.yaml по полю id.
# Рекомендуется: без него диагностика ошибок менее точная.
bind_secret: 10

# Группы с правами администратора (полный доступ + меню управления).
# Любой авторизованный доменный пользователь получает доступ на просмотр автоматически.
admin_groups:
  - "CN=RadioAdmins,OU=Groups,DC=corp,DC=local"
authorization:
  - id: 10
    username: "ldap"          # read-only аккаунт в AD
    password: "ldap-view-password"
    domain: "CORP"
LDAP: true
domains:
  - name:        "CORP"
    server:      "ldap://dc01.corp.local"
    base_dn:     "DC=corp,DC=local"
    bind_secret: 10          # id сервисного аккаунта из secret.yaml

  - name:        "PARTNER"
    server:      "ldap://dc01.partner.local"
    base_dn:     "DC=partner,DC=local"
    bind_secret: 11

# Администраторы — применяется ко всем доменам (можно переопределить внутри каждого домена)
admin_groups:
  - "CN=RadioAdmins,OU=Groups,DC=corp,DC=local"
LDAP: true
server:      "ldap://gc.corp.local:3268"
base_dn:     "DC=corp,DC=local"
bind_secret: 10
admin_groups:
  - "CN=RadioAdmins,OU=Groups,DC=corp,DC=local"
LDAP:  true
Local: true
# ...остальные параметры LDAP...
server:
  host: "0.0.0.0"
  port: 8765
  session_ttl: 604800      # продолжительность cookie-сессии в секундах (604800 = 7 дней)
  log_screen: "INFO"       # минимальный уровень логов в консоль (DEBUG/INFO/WARNING/ERROR)
  log_file: "INFO"          # минимальный уровень логов в файл logs/YYYY-mm-dd.log
  ssl:
    enabled: false          # true — запустить сервер по HTTPS
    cert: "ssl/cert.crt"    # путь к сертификату (относительно корня проекта)
    key:  "ssl/server.key"  # путь к приватному ключу

watcher:
  poll_interval: 10         # интервал опроса SMB-шар в секундах

indexing:
  rescan_all_on_startup: false  # true — полное пересканирование всех аудиофайлов
                                 # (без дискового кеша, с передетектом битрейта)
                                 # при каждом запуске/перезапуске сервера

playlogs:
  today_refresh_interval: 1800  # обновление сегодняшнего плейлога (секунды, по умолчанию 30 мин)

export:
  default_format: "mp3"
  default_bitrate: "192k"
  retention_days: 3        # экспортированные файлы удаляются через N дней
  cleanup_time: "03:00"    # время ежедневной очистки папки export/ (HH:MM)

ffmpeg_path: "ffmpeg"      # путь к ffmpeg (или просто "ffmpeg" если он есть в PATH)

ui:
  timezone: "Europe/Moscow"
server:
  ssl:
    enabled: true
    cert: "ssl/cert.crt"    # путь к сертификату
    key:  "ssl/server.key"  # путь к приватному ключу
openssl req -x509 -newkey rsa:4096 -keyout ssl/server.key -out ssl/cert.crt \
  -days 365 -nodes -subj "/CN=localhost"
certbot certonly --standalone -d your.domain.com
# Затем скопируйте или сделайте symlink:
cp /etc/letsencrypt/live/your.domain.com/fullchain.pem ssl/cert.crt
cp /etc/letsencrypt/live/your.domain.com/privkey.pem   ssl/server.key
sudo apt install authbind
sudo touch /etc/authbind/byport/443
sudo chmod 500 /etc/authbind/byport/443
sudo chown logger /etc/authbind/byport/443

authbind --deep /home/logger/apricot2/.venv/bin/python3 apricot2.py
sudo setcap 'cap_net_bind_service=+ep' $(readlink -f /home/logger/apricot2/venv/bin/python3)
logger ALL=(root) NOPASSWD: /usr/sbin/mount.cifs
# Linux
sudo umount mounts/fileserver.domain.local/LOGGER

# macOS
umount mounts/fileserver.domain.local/LOGGER
# Активируйте окружение
source .venv/bin/activate    # Linux / macOS
.venv\Scripts\activate       # Windows (cmd)
.venv\Scripts\Activate.ps1   # Windows (PowerShell)

python apricot2.py

# Деактивация виртуального окружение
deactivate
sudo nano /etc/systemd/system/apricot2.service
[Unit]
Description=Абрикос 2 — веб-интерфейс контроля радиоэфира
After=network.target

[Service]
Type=simple
User=logger
WorkingDirectory=/home/logger/apricot2
ExecStart=/home/logger/apricot2/.venv/bin/python3 apricot2.py
Restart=always
RestartSec=2

# Логи доступны через: journalctl -u apricot2
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
ExecStart=/usr/bin/authbind --deep /home/logger/apricot2/.venv/bin/python3 apricot2.py
# Перечитать конфигурацию systemd
sudo systemctl daemon-reload

# Включить автозапуск при старте системы
sudo systemctl enable apricot2

# Запустить прямо сейчас
sudo systemctl start apricot2
sudo systemctl status apricot2     # статус и последние строки лога
sudo systemctl stop apricot2       # остановить
sudo systemctl restart apricot2    # перезапустить
sudo systemctl disable apricot2    # отключить автозапуск
# В реальном времени
journalctl -u apricot2 -f

# Последние 100 строк
journalctl -u apricot2 -n 100

# За сегодня
journalctl -u apricot2 --since today
logger ALL=(root) NOPASSWD: /sbin/mount.cifs
cd ~/apricot2 && git pull && sudo systemctl restart apricot2.service
apricot2/
├── app/
│   ├── main.py                # FastAPI-приложение, REST API, WebSocket, auth-middleware
│   ├── auth.py                # Авторизация: сессии, локальные пользователи, LDAP/AD
│   ├── config.py              # Загрузка YAML-конфигов, разрешение secret.yaml
│   ├── smb_client.py          # Единый слой доступа: локальный путь или SMB
│   ├── smb_mount.py           # Авто-монтирование SMB при запуске (Linux / macOS)
│   ├── file_index.py          # Индекс аудиофайлов в памяти, polling, кэш
│   ├── audio.py               # Стриминг и экспорт через ffmpeg (copy / transcode)
│   ├── audio_probe.py         # Автоопределение параметров через ffprobe
│   ├── cache.py               # Дисковый кэш аудио-индекса (cache_audio/*.json)
│   ├── playlist.py            # Чтение CSV-плейлогов
│   └── models.py              # Dataclass-модели
├── static/
│   ├── index.html             # Главная страница приложения
│   ├── login.html             # Страница входа (отдаётся при включённой авторизации)
│   ├── style.css
│   ├── timeline.js            # Многоуровневый таймлайн (canvas)
│   └── app.js                 # Главная логика UI
├── config/                    # Рабочая конфигурация (не в репозитории)
│   ├── settings.yaml          # Общие настройки сервера
│   ├── secret.yaml            # Логины и пароли для SMB
│   ├── ldap.yaml              # Авторизация (опционально; при отсутствии — авторизация отключена)
│   ├── users.yaml             # Локальные пользователи (опционально)
│   ├── detected_params.yaml   # Найденные параметры аудиофайлов (автогенерируется)
│   ├── stations/              # Конфигурации станций и каналов записи
│   │   ├── station1.yaml
│   │   └── station2.yaml
│   └── playlogs/              # Конфигурации плейлогов
│       ├── station1.yaml
│       └── station2.yaml
├── config.demo/               # Демо-конфигурация (пример для копирования в config/)
├── export/                    # Экспортированные файлы
├── mounts/                    # SMB-шары, смонтированные при запуске (Linux / macOS)
│   └── <host>/<share>/        # Каждая шара — отдельная папка
├── cache_audio/               # Кэш индекса аудиофайлов (автогенерируется)
├── cache_playlogs/            # Кэш плейлогов по датам (автогенерируется)
├── requirements.txt           # Зависимости Python
└── apricot2.py                # Точка запуска