Перейти к основному содержанию
WaveFlow
ru

WaveFlow Server

Стабильная версияv2.2.1

Ваша музыка — где бы вы ни слушали.

Ваши файлы. Ваш сервер. Любой плеер.

Укажите WaveFlow Server папки, где хранится ваша музыка. Он соберёт медиатеку и будет играть её в браузере, на телефоне или в плеере WaveFlow, дома и в дороге, а когда связь слабая, сам понизит качество.

Скачать WaveFlow ServerКак установить

Docker · Windows · macOS · Linux · Raspberry Pi 4 и 5

Веб-плеер WaveFlow Server: подборки на основе вашей истории прослушивания над сеткой альбомов, навигация слева
Веб-плеер. Обложки из собственной библиотеки мейнтейнера, показаны только для примера.

Что он умеет

  1. Плеер прямо в браузере

    Ничего устанавливать не нужно: откройте адрес вашего сервера и слушайте на компьютере или телефоне. По HTTPS можно сохранять треки, чтобы слушать без сети.

  2. Работает с приложениями, которыми вы уже пользуетесь

    Музыкальные приложения с поддержкой Subsonic подключаются напрямую, а плеер WaveFlow синхронизирует медиатеку и историю прослушивания между вашими компьютерами.

  3. Знает, что за файлы у вас на самом деле

    Каждый файл в формате без потерь проходит анализ: если у FLAC обнаружены признаки сжатия с потерями, сервер это отмечает.

  4. Ничего не уплывает из-под ног

    При повторном сканировании медиатеки альбомы и исполнители сохраняют прежние идентификаторы, поэтому ссылки в ваших приложениях продолжают работать.

  5. Готово за минуту

    Одна программа и один файл базы данных. Запустите на своём компьютере или оставьте работать на домашнем сервере с Docker.

  6. Ваше и только ваше

    Ваши музыкальные файлы никогда не меняются. Ничего не покидает ваш сервер, пока вы не включите это, и у каждого в доме может быть своя учётная запись.

Текущее состояние

Стабилен с версии 2.0. Версия 2.2.1 последняя, новые версии продолжают выходить, а сервер может сообщить о новой, если вы разрешите проверку.

  • Docker Стабильная версия

    Один образ для amd64 и arm64: сервер, NAS или Raspberry Pi 4 или 5.

  • Windows · macOS · Linux Стабильная версия

    Архив: распакуйте и запустите на своём компьютере. FFmpeg включён, установка не нужна.

Ссылки

Веб-плеер

Плеер прямо в браузере

Ничего устанавливать не нужно: откройте адрес вашего сервера на компьютере или телефоне. Альбомы, исполнители, папки и жанры, поиск по мере ввода, очередь воспроизведения, синхронизированные тексты песен на весь экран и подборки по тому, что вы действительно слушаете.

Офлайн
Сохраняйте нужные треки и слушайте без подключения, в этом браузере и только в своей учётной записи. Браузеры разрешают это по HTTPS или на компьютере, где запущен сервер.
Можно установить
Добавьте на телефон как приложение: с управлением на экране блокировки, медиаклавишами и сочетаниями клавиш.
14 тем
Светлые и тёмные, под любую комнату и время суток.
9 языков
Английский, французский, немецкий, испанский, итальянский, японский, корейский, китайский (упрощённый и традиционный).
Сейчас играет в веб-плеере: большая обложка альбома, название и исполнитель, а под ними качество потока
Экран «Сейчас играет» с параметрами текущего потока

Работает с приложениями, которые у вас уже есть

WaveFlow Server понимает Subsonic и OpenSubsonic: открытый протокол, знакомый многим музыкальным приложениям. Добавьте сервер в приложение, указав его адрес, ваше имя пользователя и пароль приложения: без плагинов и без лишних установок.

Протокол
Subsonic · OpenSubsonic
Адрес
/rest/*Большинство приложений добавляют его сами: просто укажите адрес вашего сервера.
Пароль
У приложений свой пароль, отдельный от того, которым вы пользуетесь в браузере.
Приложения, проверенные с WaveFlow Server, и что каждое из них делало
ПриложениеПроверенные возможности
SymfoniumAndroidПросмотр, перемотка в Opus, MP3 и FLAC, избранное, оценки, закладки, тексты песен
FeishinWindowsПросмотр, папки, синхронизированные тексты, радио, плейлисты
DSubAndroidПапки, подкасты, очередь воспроизведения, плейлисты, общий доступ
JulietiPhoneПросмотр, перекодирование, очередь воспроизведения, плейлисты

Каждое приложение запускали вручную, а каждый результат проверяли на сервере, а не по экрану приложения. Последняя полная проверка закончилась 28 октября 2026 г., до выхода 2.0.0, поэтому не всё, что добавлено с тех пор, проверялось в этих приложениях.

Открыть таблицу совместимости

WaveFlow DesktopWindows · macOS · Linux

Синхронизирует медиатеку и историю прослушивания между вашими компьютерами через собственный API

Знает, что за файлы у вас на самом деле

В библиотеке, собранной за годы, бывают сюрпризы. WaveFlow Server изучает сами файлы и отдаёт каждому приложению тот звук, который оно способно воспроизвести.

Страница качества: lossless-файлы, проверенные по звуку, с числом файлов для каждого вердикта и, для каждого трека, границей высоких частот
Каждый lossless-файл измерен, а не принят на слово

  • Выявляет поддельный lossless

    Сервер анализирует звук каждого lossless-файла. Он отмечает FLAC с признаками сжатия с потерями, файлы с искусственно увеличенной битовой глубиной и файлы с искусственно повышенной частотой дискретизации.

  • Оригинал или полегче по дороге

    Играйте исходный файл или позвольте серверу на лету перекодировать его в MP3, Opus или AAC, когда соединение слабое. Приложение, которое перематывает по диапазону байтов, может не перемотать перекодировку, которая ещё не закончилась: дайте ему исходный файл.

  • Ровная громкость

    ReplayGain передаётся вашим приложениям вместе с каждым треком, а сервер может сам выровнять громкость перекодированного потока для приложения, которое этого не умеет.

Ваше и только ваше

Домашним сервером должны управлять только вы. WaveFlow Server устроен так с самого первого запуска.

Всё, с чем сервер может связаться

  • Ваши файлы остаются как есть

    Сканер и любое редактирование тегов не трогают ваши аудиофайлы. Если файл пропал, избранное, оценки и прослушивания сохраняются, пока он не вернётся.

  • Передача данных — только с вашего разрешения

    С настройками по умолчанию сервер сам ничего не отправляет. Тексты песен, картинки исполнителей, скробблинг и проверка обновлений ждут вашего согласия.

  • Своя учётная запись у каждого в доме

    Каждая учётная запись видит только те библиотеки, к которым относится. Пароли хешируются с помощью Argon2id, число попыток входа ограничено, чтобы пароль нельзя было подобрать, а одноразовый токен не даёт постороннему занять новый сервер.

  • Резервная копия одной командой

    Одна команда копирует базу данных вместе с ключом, а перед обновлением, которое меняет базу, сервер сам делает копию обоих, если вы не отключите это. Фотографии артистов, canvas и скачанные подкасты лежат рядом в папке данных: чтобы сохранить и их, делайте копию всей папки.

Готово за минуту

Один контейнер, один файл базы данных, один файл ключа. Без сервера баз данных, без кеша, больше ничего запускать не нужно, а FFmpeg уже внутри.

  1. Сохраните это как compose.yaml

    Замените /path/to/music на папку, где лежит ваша музыка. Сервер только читает её и ничего в ней не меняет.

    compose.yaml
    services:
  waveflow:
    image: ghcr.io/instazdll/waveflow-server:2.2.1
    restart: unless-stopped
    ports:
      - "4533:4533"
    environment:
      WAVEFLOW_DATA_DIR: /data
      WAVEFLOW_BIND: 0.0.0.0:4533
    volumes:
      - waveflow-data:/data
      - /path/to/music:/music:ro

volumes:
  waveflow-data:

  2. Запустите

    Docker скачает образ и запустит сервер в фоновом режиме.

    Terminal
    docker compose up -d

  3. Создайте учётную запись

    Откройте http://your-host:4533. На экране настройки создаётся учётная запись администратора, и запрашивается одноразовый токен, который сервер записал для вас:

    Terminal
    docker compose exec waveflow cat /data/setup-token

  4. Добавьте музыку

    Укажите имя только что созданной учётной записи (здесь это admin). Первое сканирование начнётся само.

    Terminal
    docker compose exec waveflow \
  waveflow-server library add --owner admin --name Music --path /music

Образ

ghcr.io/instazdll/waveflow-server

Собран для amd64 и arm64, поэтому работает на Raspberry Pi 4 или 5 с 64-разрядной системой. Каждый выпуск помечен своей версией, latest указывает на последний стабильный, а тот же образ есть и на Docker Hub.

  • linux/amd64
  • linux/arm64

Слушать не из дома

Сервер говорит по обычному HTTP, этого достаточно для сети, которой вы доверяете. Чтобы слушать откуда угодно, поставьте его за HTTPS: в репозитории есть готовая настройка с Caddy, который сам получает и продлевает сертификат.

Настройка с Caddy

Без Docker

У каждого выпуска есть и архив: распакуйте и запустите на своём компьютере. Установка не нужна, FFmpeg уже включён, а веб-плеер открывается сам. При первом запуске Windows и macOS покажут предупреждение; в README.txt внутри написано, на что нажать.

  • Windows · x86_64.zip
  • macOS · Apple silicon.zip
  • macOS · Intel.zip
  • Linux · x86_64.tar.gz
  • Linux · arm64.tar.gz

Контрольные суммы лежат в SHA256SUMS, в том же выпуске.

Скачать архив

Читать дальше

Семейство WaveFlow

Один способ слушать — на любом экране.

Всё начинается с плеера. Музыкальный сервер, приложение для телефона и редактор текстов песен созданы по одному принципу: ваши файлы — на ваших устройствах, и ничего не нужно платить.