Mealie на VPS: установка через Docker Compose
Установите Mealie на собственный VPS: импортируйте рецепт по ссылке, настройте планы питания и списки покупок, nginx, TLS и резервное копирование через Docker Compose.
Что делает self-hosted менеджер рецептов
Self-hosted менеджер рецептов хранит рецепты в базе данных на принадлежащем вам сервере. Mealie — наиболее распространённый выбор для домашних пользователей. Вы вставляете адрес страницы с рецептом, а Mealie извлекает из неё ингредиенты, этапы приготовления, количество порций и время приготовления. Текст и рекламу сервис не сохраняет. В коллекцию попадает только сам рецепт.
Остальная часть приложения небольшая. Есть недельный план питания, куда можно добавлять рецепты, и список покупок, который формируется на основе этого плана. Каждый пользователь, который готовит, получает отдельную учётную запись. Приложение работает в одном контейнере и простаивает между запросами, поэтому с ним справится даже недорогой VPS.
В этом руководстве используется Docker Compose. Если термины services: и volumes: вам незнакомы, сначала прочитайте как устроены файлы Docker Compose, потому что всё ниже состоит из одного compose-файла и четырёх команд.
Установка Mealie с помощью Docker Compose
Mealie публикует свои образы в реестре контейнеров GitHub. По состоянию на 18 ноября 2026 года текущим стабильным тегом является v3.31.0, выпущенный 13 ноября. Этот релиз содержит исправления безопасности, и проект рекомендует всем обновиться. Фиксируйте версию, а не используйте latest: при latest случайное обновление docker compose pull в любой день может привести к миграции базы данных, к которой вы не готовы.
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.31.0
container_name: mealie
restart: always
ports:
- "127.0.0.1:9925:9000"
deploy:
resources:
limits:
memory: 1000M
volumes:
- mealie-data:/app/data/
environment:
ALLOW_SIGNUP: "false"
PUID: 1000
PGID: 1000
TZ: Europe/Amsterdam
BASE_URL: https://recipes.example.com
volumes:
mealie-data:Перед запуском стоит обратить внимание на две строки.
Порт записан как 127.0.0.1:9925:9000, а не как 9925:9000. Внутри контейнер слушает порт 9000, а хост пробрасывает на него 9925. Привязка этого отображения к адресу loopback означает, что Nginx может связаться с Mealie, а интернет — нет. Docker записывает свои правила в фильтр пакетов, поэтому обычный 9925:9000 будет доступен извне, даже если ваш брандмауэр сообщает, что порт закрыт. Этот нюанс стоит понять один раз: см. почему опубликованные порты Docker игнорируют ufw.
BASE_URL должен быть точным публичным адресом, который вы будете использовать, со схемой и без косой черты в конце. Mealie создает на его основе ссылки для сброса пароля и приглашения. Если установить его как http://localhost:9925, то приглашение, отправленное партнеру, будет содержать ссылку, которая работает только на самом сервере.
Запустите его и наблюдайте за первой загрузкой.
sudo docker compose up -d
sudo docker compose logs -f mealieПри первом запуске создается база данных SQLite и выполняются миграции, что занимает несколько секунд. Когда лог стабилизируется и перестанет выводить строки миграции, проверьте приложение локально.
curl -I http://127.0.0.1:9925Код 200 OK означает, что приложение работает. Если вы получили Connection refused, выполните sudo docker compose ps -a, чтобы проверить статус контейнера и код выхода. Контейнер, который остановился с кодом 137, получил SIGKILL; сам по себе этот код не показывает, что был превышен лимит памяти в 1000M. Принудительное завершение контейнера вручную также приводит к этому коду.
Первый вход в систему и отключение открытой регистрации
Учетная запись по умолчанию — changeme@example.com с паролем MyPassword. Войдите в систему под этими данными и немедленно измените их, так как эта пара указана в документации и поэтому известна всем сканерам.
Значение ALLOW_SIGNUP: "false" в файле compose задано намеренно. Если регистрация открыта, любой, кто найдет адрес, сможет создать учетную запись в вашей базе рецептов. Если она закрыта, вы добавляете пользователей через панель администратора, которая генерирует ссылку-приглашение для отправки пользователю. Эта ссылка формируется на основе BASE_URL, поэтому данное значение важно. Если вы планируете запускать несколько приложений на одном сервере и хотите использовать единый пароль для всех, Mealie может передать аутентификацию внешнему провайдеру, например, собственному экземпляру Authentik.
Mealie распределяет пользователей по домохозяйствам, а домохозяйства объединяются в группы. Все участники одного домохозяйства совместно используют план питания и список покупок, что удобно для семьи. Коллекция рецептов имеет более широкую область действия: домохозяйства делятся своими рецептами, тегами и категориями со всеми остальными домохозяйствами в той же группе. Таким образом, отдельные домохозяйства на одном сервере ведут раздельные планы и списки, но готовят по одним и тем же рецептам, что подходит для совместного проживания, где вкусы участников не совпадают. Если пользователям нужны полностью изолированные коллекции, поместите их в разные группы, так как между группами данные не передаются.
Импортер — основная причина использования системы
Откройте коллекцию рецептов, выберите создание рецепта по URL и вставьте ссылку. Mealie загружает страницу и ищет структурированные данные рецепта — машиночитаемый блок, который большинство кулинарных сайтов встраивают для поисковых систем. При наличии этого блока импорт выполняется корректно и мгновенно.
Если вы настроите провайдера ИИ, вы также сможете выполнять импорт из изображения или обычного текста, который вы вставляете вручную; это позволяет импортировать фотографии страниц из кулинарных книг. Для импорта изображений требуется провайдер, способный распознавать графические данные. Без провайдера эти функции импорта недоступны. Они проходят по более медленному пути и требуют последующей проверки, так как рукописные дроби легко распознать неверно.
Массовый импорт запускается с того же экрана: вставьте список адресов (по одному на строку), и Mealie обработает их в фоновом режиме. Коллекция из 200 закладок переносится за один сеанс.
Планы питания и список покупок
Планировщик питания представляет собой календарь. Перетащите рецепт на нужный день, чтобы запланировать его. Добавьте запланированные рецепты в список покупок, чтобы собрать их ингредиенты. Чтобы объединить дубликаты, сначала добавьте продукты (Foods) и единицы измерения (Units) в разделе Manage Data, включите учет количества ингредиентов в каждом рецепте и распределите ингредиенты по этим продуктам и единицам измерения. В результате два рецепта, требующие лук, сформируют одну строку вместо двух.
Список — это интерактивная страница, которую удобно использовать на телефоне прямо в магазине. Поскольку данные хранятся на вашем собственном сервере, все члены семьи видят один и тот же список в режиме реального времени: если один человек отмечает молоко как купленное, оно сразу исчезает с экрана другого пользователя.
Размещение nginx и TLS перед приложением
В данной конфигурации Mealie работает по протоколу HTTP; он также поддерживает TLS через TLS_CERTIFICATE_PATH и TLS_PRIVATE_KEY_PATH. Выполняйте терминацию TLS на стороне nginx, расположенного перед приложением. Сначала направьте DNS A-запись на ваш сервер, так как процесс получения сертификата требует проверки доменного имени.
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
listen 80;
server_name recipes.example.com;
client_max_body_size 64M;
location / {
proxy_pass http://127.0.0.1:9925;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginxКоманда nginx -t с флагами syntax is ok и test is successful является проверочной. Выполняйте перезагрузку только после успешного прохождения проверки, так как перезагрузка с некорректной конфигурацией оставляет работать старую версию и скрывает ошибку до следующего перезапуска.
Директива client_max_body_size 64M необходима, так как значение по умолчанию в nginx составляет 1 MB. Загрузка фотографии рецепта или восстановление резервной копии через браузер отправляет запрос большего размера, и без этой строки вы получите ошибку 413 Request Entity Too Large от nginx, а не от Mealie, поэтому в логах приложения не будет никаких записей.
Затем выпустите сертификат. Этот этап и настройка таймера его обновления описаны в выпуске сертификата Let's Encrypt для nginx с помощью certbot.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot перепишет блок server для прослушивания порта 443 и добавит редирект с порта 80. Откройте сайт через https:// и убедитесь, что браузер принимает сертификат. Если Mealie загружается, но его внутренние ссылки перенаправляют вас на http://, значит, переменная BASE_URL всё ещё содержит http и требует исправления, после чего необходимо выполнить sudo docker compose up -d для пересоздания контейнера с новым значением.
Запуск Mealie по подпути, например example.com/recipes, не будет работать, так как фронтенд не поддерживает работу из подпути. Используйте поддомен.
Резервные копии и что на самом деле делает восстановление
Все данные Mealie находятся в /app/data/ внутри контейнера, что является томом mealie-data. Скопируйте этот том, и вы скопируете рецепты, изображения и базу данных вместе. Документация самого Mealie называет остановку контейнера и копирование этой папки лучшим способом резервного копирования установки на SQLite.
sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealieИмя тома содержит имя проекта в качестве префикса, а имя проекта — это каталог, содержащий файл compose. Из /srv/mealie том имеет имя mealie_mealie-data, поэтому первая команда — docker volume ls: используйте имя, которое она выведет, а не имя из этого руководства. Сначала важно остановить контейнер, так как SQLite достаточно часто находится в процессе записи, и «живая» копия может восстановиться нечитаемой.
У Mealie также есть собственная страница резервного копирования в панели администратора, которая записывает ZIP-архив, содержащий базу данных в виде database.json. Архив можно восстановить в экземпляр, работающий на той же или более новой версии Mealie. Чтобы перенести данные между серверами, используйте ту же зафиксированную версию на новой машине при копировании тома или восстановите архив в ту же или более новую версию. Восстановление является деструктивным по своей сути: оно удаляет текущую базу данных перед загрузкой архива, и это действие нельзя отменить. После завершения вы будете выведены из системы.
Ни одна копия не является резервной, пока она находится на том же сервере. Отправляйте архив куда-то еще по расписанию, для чего предназначено шифрованное резервное копирование вне сервера с помощью restic.
Обновление Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieИзмените закреплённую версию в файле, затем выполните pull и пересоздайте контейнер. Миграции запускаются при первом старте нового образа. Перед переходом на новую основную версию создайте копию тома, поскольку миграция, завершившаяся ошибкой на середине процесса, может оставить базу данных, которую предыдущий образ больше не откроет. Изучите примечания к выпуску для всех версий между текущей и новой.
Если импортер не работает
Некоторые сайты вообще не публикуют структурированные данные рецептов, и тогда Mealie импортирует только заголовок с пустым списком ингредиентов. Без настроенного ИИ-провайдера это нельзя исправить настройками, поэтому вставляйте текст рецепта вручную. Если провайдер настроен, Mealie передает содержимое страницы модели, когда скрапер ничего не находит, и результат требует такой же сверки с оригиналом, как и любой другой импорт через ИИ.
Другие сбои связаны с защитой от ботов на стороне сайта с рецептами, который вместо рецепта отвечает Mealie страницей проверки (challenge). Mealie уже имитирует браузер и меняет user agent, чтобы уменьшить вероятность этого. Если сайт все равно отказывает, задокументированные варианты — это направить скрапер через прокси с лучшей репутацией адреса или запустить экземпляр FlareSolverr, который решает задачу в настоящем браузере. Оба варианта опциональны и настраиваются через переменные окружения контейнера.
Импорт, который не работает из-за того, что ваш сервер вообще не может связаться с сайтом, — это другая проблема. Протестируйте доступность с сервера с помощью curl -I https://the-site.example/recipe и прочитайте строку состояния, прежде чем винить скрапер. Начиная с версии v3.26.0, Mealie также отказывается загружать данные с частных или внутренних адресов, поэтому страница рецепта, размещенная в вашей собственной сети, не импортируется, пока вы не добавите её хост в переменную окружения HTTP_ALLOW_LIST.
Где это уместно
Mealie — хорошее первое приложение для самостоятельного размещения в домашней сети, поскольку люди, с которыми вы живёте, будут им пользоваться без дополнительных просьб. По назначению оно похоже на собственную фототеку на базе Immich, но значительно легче и входит в более широкий список сервисов, которые стоит разместить самостоятельно в этом году. Один небольшой сервер может запускать оба приложения. Immich — не единственный кандидат на эту вторую задачу. Если вы ещё выбираете, требования к памяти и команды резервного копирования PhotoPrism и Immich заметно различаются, поэтому стоит ознакомиться с ними до того, как вы займёте оставшееся место на диске. Если домашнее хозяйство хранит планы и заметки не только рецептов и ужинов, самостоятельно размещаемое рабочее пространство AFFiNE снова настраивается через compose-файл, но ему требуются четыре контейнера и значительно больше памяти, чем Mealie. Сначала проверьте, сколько ресурсов осталось на сервере. Если домашнее хозяйство хочет отслеживать тренировки так же, как ужины, openGym хранит данные о тренировках и использует тот же закреплённый тег, compose-файл и сертификат, которые вы только что настроили. Для вечера после ужина есть отдельный вариант: Halcyon превращает существующую библиотеку Jellyfin в видеопрокат 1990-х годов, по которому можно перемещаться. Это ещё один небольшой контейнер перед уже работающим сервисом, а не новая база данных, для которой нужно настраивать резервное копирование. Не все приложения из этого семейства предназначены для домашнего использования. Если тот же подход потребуется применить для рабочих задач, самостоятельно размещаемый сервис поддержки Chatwoot снова использует закреплённый тег и сертификат, но требует Postgres, Redis и настроенной исходящей почты. Это значительно более требовательный сервис, чем хранилище рецептов, поэтому для него стоит выделить отдельный сервер.
FAQ
Почему импорт URL рецепта завершается ошибкой?
Есть две распространенные причины. Либо страница не публикует структурированные данные рецепта, поэтому парсер ничего не находит (и если не настроен ИИ-провайдер для чтения страницы, вы получите заголовок без ингредиентов), либо слой защиты от ботов перед сайтом возвращает страницу проверки вместо рецепта. Во втором случае Mealie можно направить на прокси с лучшей репутацией адреса или на собственный экземпляр FlareSolverr, который решает задачу в реальном браузере. Перед внесением изменений убедитесь, что ваш сервер вообще может получить доступ к странице с помощью curl -I.
Нужен ли мне PostgreSQL или достаточно SQLite?
SQLite достаточно для домашнего использования, и это стандартный вариант. Переходите на PostgreSQL, когда каталог данных находится на сетевом хранилище (NAS), так как SQLite через сетевую файловую систему вызывает ошибки блокировки базы данных и может повредить файл. При восстановлении в PostgreSQL пользователь базы данных должен быть суперпользователем, так как восстановление удаляет все перед загрузкой архива.
Могу ли я запустить Mealie без доменного имени?
Да, в своей сети. Установите BASE_URL на адрес, который вы будете вводить, например http://192.168.1.20:9925, измените отображение портов на 192.168.1.20:9925:9000, используя LAN-адрес вашего сервера, и пропустите Nginx. Выполните sudo docker compose up -d, чтобы применить оба изменения. Исходное отображение 127.0.0.1:9925:9000 принимает соединения только с хоста Docker. Ссылки для приглашения и сброса пароля создаются на основе BASE_URL, поэтому неверное значение приведет к созданию ссылок, которые никто не сможет открыть. Не открывайте доступ к нему из интернета через обычный HTTP, так как в этом случае логин передается в открытом виде.
Как дать членам семьи их собственные логины?
Оставьте ALLOW_SIGNUP установленным в "false" и добавляйте людей из панели администратора, что создаст ссылку-приглашение, которую вы им отправите. Поместите всех, кто делит кухню, в одно домохозяйство, чтобы они использовали общий план питания и список покупок. Рецепты в любом случае делятся с каждым домохозяйством в группе, поэтому людям, которым нужны отдельные коллекции, нужны отдельные группы.
Что произойдет с моими рецептами, если я перестану использовать Mealie?
Они останутся у вас. Резервная копия администратора записывает данные в формате JSON, также Mealie может экспортировать рецепты как JSON-файлы, которые остаются читаемыми в любом текстовом редакторе без какого-либо дополнительного ПО. Сделайте один экспорт до того, как он понадобится, и проверьте, что вы можете его открыть.