FreshRSS на VPS в Docker: установка, compose, бэкап и типичные ошибки
Ленты не исчезли — они просто перестали попадаться на глаза. Блоги, документация проектов, changelog'и на GitHub, форумы и подкасты по-прежнему отдают RSS, но обходить десяток сайтов вручную — потерянный час в день. Облачные читалки решают проблему частично: у Feedly бесплатно сотня лент, у Inoreader похожая модель, а список источников и история чтения лежат на чужом сервере.
FreshRSS — открытая альтернатива на PHP для собственного сервера. Никаких лимитов на ленты и пользователей, скромные требования к ресурсам, совместимость с Google Reader API и Fever API: читать можно из Reeder, FeedMe, Fluent Reader, ReadYou, а не только из веб-интерфейса. Плата за независимость одна — обновлять и бэкапить инстанс придётся самому. Для сервиса, который открывают раз в день, это разумный обмен.
Что понадобится
- Сервер. 1 vCPU и 512 МБ–1 ГБ RAM: приложение лёгкое, ресурсы уходят в основном на разбор XML при обновлении. Для 200+ активных лент гигабайта хватает. Подойдёт младший тариф — например, из подборки Docker VPS, если планируете контейнерную установку.
- Ubuntu 24.04 — PHP 8.3 есть в штатных репозиториях, отдельный PPA не нужен. Официально поддерживаются PHP 8.1+ и любая из MySQL/MariaDB/PostgreSQL/SQLite.
- Домен или поддомен. Отдельный домен не обязателен:
rss.example.comна том же сервере работает нормально. - Стек на выбор: nginx + PHP 8.3-fpm + MariaDB + cron либо официальный образ
freshrss/freshrssсо встроенной SQLite или отдельным Postgres.
SQLite спокойно держит одного-двух пользователей и до пары сотен лент — отдельная СУБД не нужна. MariaDB имеет смысл, когда лент много, читаете с нескольких устройств одновременно или заводите несколько аккаунтов на одном инстансе.
Установка пошагово
Шаг 1. База системы.
apt update && apt upgrade -y
apt install -y curl git unzip software-properties-common
Шаг 2. PHP и расширения.
apt install -y php8.3-fpm php8.3-cli php8.3-mysql php8.3-curl \
php8.3-gd php8.3-intl php8.3-mbstring php8.3-xml php8.3-zip php8.3-sqlite3
systemctl status php8.3-fpm
Расширения нужны не «на всякий случай»: gd рисует favicon лент, intl сортирует заголовки на разных языках, curl тянет RSS/Atom, xml и mbstring разбирают ответы.
Шаг 3. MariaDB: база и отдельный пользователь.
apt install -y mariadb-server
mysql_secure_installation
На вопросы отвечайте «да»: убрать анонимных пользователей, запретить удалённый вход root, удалить тестовую базу. Дальше — база и пользователь, приложение не должно ходить под root:
CREATE DATABASE freshrss CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'freshrss'@'localhost' IDENTIFIED BY 'длинный-пароль';
GRANT ALL PRIVILEGES ON freshrss.* TO 'freshrss'@'localhost';
FLUSH PRIVILEGES;
utf8mb4 обязателен: на utf8 заголовки с эмодзи и иероглифами превращаются в кракозябры.
Шаг 4. Код и права.
git clone https://github.com/FreshRSS/FreshRSS.git /var/www/freshrss
cd /var/www/freshrss
git checkout $(git describe --tags $(git rev-list --tags --max-count=1))
chown -R www-data:www-data /var/www/freshrss
chmod -R 755 /var/www/freshrss
Git удобнее архива: обновление сводится к git pull внутри стабильного тега. git describe подставляет последний релиз вместо ветки edge, где иногда остаются недоделанные коммиты.
Шаг 5. nginx. Конфиг /etc/nginx/sites-available/freshrss.conf. Корень сайта — подпапка p внутри репозитория, а не его корень.
server {
listen 80;
server_name rss.example.com;
root /var/www/freshrss/p;
index index.php;
client_max_body_size 16M;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
location ~ /\. {
deny all;
}
location ~ ^/(\.git|\.env|cli|data|extensions/.*/config) {
deny all;
}
}
Последний блок закрывает служебные каталоги с конфигами и данными от скачивания по прямому URL. Активация:
ln -s /etc/nginx/sites-available/freshrss.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
Шаг 6. HTTPS. Логин и пароль уходят при каждом входе, поэтому сертификат здесь не опция:
apt install -y certbot python3-certbot-nginx
certbot --nginx -d rss.example.com
Certbot допишет listen 443 ssl и редирект с 80-го; продление работает через systemd-таймер из пакета.
Шаг 7. Мастер установки. Откройте домен: мастер спросит язык, параметры БД (тип MySQL, хост localhost, база freshrss, созданный пользователь) и логин администратора FreshRSS — это отдельная учётка, с MariaDB не связанная. Первая лента: «Управление подписками → Добавить фид», адрес главной страницы подойдёт — фид ищется автоматически. Старые подписки переносятся OPML-файлом через «Импорт/экспорт»: папки категорий сохранятся, история прочитанного — нет.
Шаг 8. Автообновление лент. Сам FreshRSS источники не опрашивает, нужен внешний планировщик:
crontab -u www-data -e
*/15 * * * * /usr/bin/php /var/www/freshrss/app/actualize_script.php > /dev/null 2>&1
Задача обязательно от www-data, а не от root: иначе скрипт падает по правам на data/ или создаёт файлы с неправильным владельцем. Для нескольких пользователей на одном инстансе есть параметр --user=имя.
Docker Compose
Для личного использования достаточно SQLite:
services:
freshrss:
image: freshrss/freshrss:latest
container_name: freshrss
restart: unless-stopped
ports:
- "8080:80"
environment:
TZ: Europe/Moscow
CRON_MIN: "3,33"
volumes:
- freshrss_data:/var/www/FreshRSS/data
- freshrss_extensions:/var/www/FreshRSS/extensions
volumes:
freshrss_data:
freshrss_extensions:
CRON_MIN включает cron внутри контейнера: обновление на 3-й и 33-й минуте каждого часа. Без него ленты обновляются только при заходе в интерфейс. Для десятков лент и нескольких пользователей данные лучше сразу вынести в PostgreSQL:
services:
db:
image: postgres:16-alpine
container_name: freshrss-db
restart: unless-stopped
environment:
POSTGRES_USER: freshrss
POSTGRES_PASSWORD: сгенерируйте_свой_пароль
POSTGRES_DB: freshrss
volumes:
- freshrss_db:/var/lib/postgresql/data
freshrss:
image: freshrss/freshrss:latest
container_name: freshrss
restart: unless-stopped
depends_on:
- db
ports:
- "8080:80"
environment:
TZ: Europe/Moscow
CRON_MIN: "3,33"
volumes:
- freshrss_data:/var/www/FreshRSS/data
- freshrss_extensions:/var/www/FreshRSS/extensions
volumes:
freshrss_db:
freshrss_data:
freshrss_extensions:
Порт базы наружу не публикуется: в мастере настройки хост — имя сервиса db. Пароль в POSTGRES_PASSWORD задайте до первого запуска, после инициализации тома сменить его без пересоздания сложнее.
docker compose up -d
docker compose logs -f freshrss
По http://IP:8080 без шифрования ходить не стоит — пароль уйдёт открытым текстом. Проще поставить перед контейнером Caddy, он сам получает сертификат:
rss.ваш-домен.ru {
reverse_proxy freshrss:80
}
Когда домен поднялся по HTTPS, укажите этот адрес как базовый URL в профиле — иначе мобильные клиенты стучатся во внутренний адрес контейнера.
Частые ошибки и решения
Белый экран или 500. Смотрите tail -50 /var/log/php8.3-fpm.log и лог nginx. В девяти случаях из десяти не хватает расширения (curl, xml, intl, gd, mbstring, zip), реже виноват низкий memory_limit: на некоторых образах это 64M, а импорт OPML и обновление лент в него упираются — поднимите до 256M в /etc/php/8.3/fpm/php.ini.
Ленты не обновляются сами. Две проверки: задача в crontab именно у www-data и в «Настройки → Обновление ленты» выбран режим «Через планировщик (cron)». Что cron отрабатывает, видно по grep CRON /var/log/syslog | grep actualize; пусто — демон не видит задачу (опечатка в пути к PHP).
Impossible to connect при добавлении ленты. Причин три: исходящий файрвол на сервере, устаревший или самоподписанный сертификат источника (curl -I -v, флаг -k — только для диагностики) и антибот с проверкой User-Agent или JS — такую ленту FreshRSS не потянет в принципе, это ограничение источника, а не баг.
Permission denied при записи в data. После клонирования от root права не те: chown -R www-data:www-data /var/www/FreshRSS/data. В Docker причина другая — несовпадение UID каталога на хосте и процесса в контейнере (обычно 1000); права правятся снаружи, а chmod 777 изнутри — костыль, который забывают убрать. На AlmaLinux и CentOS проверьте SELinux: ausearch -m avc -ts recent, при находках — semanage fcontext с типом httpd_sys_rw_content_t и restorecon -R.
database is locked. SQLite не рассчитана на конкурентную запись: cron обновляет ленты, вы читаете — и появляются ошибки. Разовые совпадения терпеть можно, регулярные означают переезд на MySQL/MariaDB или PostgreSQL. Практичнее не ковырять базу вручную, а поднять второй профиль подключения через /i/ и перенести подписки OPML-файлом.
Мобильный клиент не подключается по API. Сначала включите API в профиле и задайте отдельный API-пароль — он не совпадает с паролем от веб-интерфейса, это самая частая причина «неверный логин». Если не помогло, проверьте reverse-proxy: без X-Forwarded-Proto FreshRSS генерирует ссылки на API с http вместо https, и клиент отваливается по TLS.
Бэкап и обновление
При установке пакетами бэкап — дамп базы плюс каталог data/ с настройками и кэшем иконок:
mysqldump freshrss > freshrss-backup-$(date +%F).sql
tar czf freshrss-data-$(date +%F).tgz /var/www/freshrss/data
На новом сервере восстановите дамп, распакуйте data/ поверх свежего клона и не забудьте chown — иначе получите тот самый «permission denied». Обновление: переключиться на новый тег и снова выставить владельца на data/. Забытый пароль администратора меняется из CLI: php ./cli/user-password-change.php --user логин --password новый-пароль, из каталога установки и от имени веб-сервера.
В Docker бэкапятся тома: freshrss_data для SQLite либо freshrss_db вместе с freshrss_data для Postgres. Дамп базы:
docker compose exec db pg_dump -U freshrss freshrss > freshrss-backup-$(date +%F).sql
Обновление образа — docker compose pull и docker compose up -d. Миграции FreshRSS применяет сам при старте, но перед мажорной версией дамп сделать не помешает.
Итог
Остаётся импортировать OPML, включить API под свои клиенты и настроить пару расширений — правила фильтрации мусорных источников и автоматические теги. Через сутки проверьте логи на ошибки обновления и добавьте мониторинг доступности: иначе об упавшем инстансе узнаете через неделю.
Под агрегатор хватает младшего сервера, так что переплачивать за конфигурацию смысла нет — сравнить варианты по цене и локациям можно в каталоге VPS для этого проекта. Если рядом планируются другие сервисы (Git, мониторинг, боты), берите с запасом по RAM: FreshRSS уживается с ними на одном хосте за общим reverse-proxy.