Firefly III
Приложение для учета личных финансов на своем сервере: расходы по нескольким счетам, переводы и месячные бюджеты. Развернули 6.7.9 на Fatmetal Cloud Server, замерили потребление и проверили учет денег.
Весь функционал ядра бесплатен, платных модулей нет. Сервер и администрирование оплачиваются отдельно.
Вердикт
- У вас несколько своих счетов: нужно отличать покупки от переводов в накопления.
- Вы задаете лимит трат на месяц и хотите видеть остаток по бюджету.
- Одинаковые расходы нужно раскладывать по категориям автоматически.
- Нужна автоматическая синхронизация с российским банком.
- Нужен общий кошелек с отдельными семейными логинами.
- Нужна именно конвертная методика YNAB.
Как учитывать расходы с нескольких счетов
Перевод в накопления оставляет деньги вашими и не увеличивает расходы месяца. Поэтому Firefly III различает покупки и движение денег между вашими счетами.
Для этого у каждой операции есть источник и назначение. Зарплата идет от работодателя на основной счет, покупка - с него в супермаркет, перевод - на другой ваш счет.
Бюджет здесь означает лимит расходов за период. Категория отвечает, на что ушли деньги, а правило присваивает ее по условию. Например, описание содержит «Продукты» - назначить категорию «Еда».
В октябре мы записали доход 80 000 рублей, покупку на 3 500 и перевод 10 000 между счетами. Баланс периода составил 76 500 рублей; перевод в нем не стал расходом.
Что изменилось с прошлого разбора
Прежняя статья описывала 6.6.6. В ветке 6.7 Twig заменен на Blade, обновлен AdminLTE, переделаны формы операций, список транзакций и страница OAuth-токенов.
На новой форме тип операции определяется выбранными счетами. Выбирайте источник и назначение из подсказок, дожидайтесь загрузки счета: простого текста в поле недостаточно.
Cron теперь возвращает результаты по пользователям. Сохранен статический токен ровно из 32 символов. Движок выражений правил выключен по умолчанию; обычное правило назначения категории работает без него.
В 6.7.2-6.7.9 исправлялись регрессии интерфейса, валют и сверки счетов. Исправления безопасности вынесены в раздел «Уязвимости прошлых версий»: это отдельная причина уйти с 6.6.6.
Чем отличается от YNAB
Firefly III отвечает на вопрос «где деньги и на что они потрачены». YNAB предлагает распределять имеющиеся деньги по задачам. Похожий месячный бюджет не делает эти модели взаимозаменяемыми.
| Критерий | Firefly III | YNAB |
|---|---|---|
| Оплата | Программа бесплатна; оплачивается сервер | $14,99 в месяц или $109 в год |
| Размещение | Ваш сервер | Облако вендора |
| Бюджет | Лимиты расходов по периодам | Распределение денег по задачам |
| Валюты | Счета и операции в разных валютах | Одна валюта на spending plan |
| Пользователи | Отдельные учеты, без общего кошелька | Подписка до шести человек |
Цены и условия YNAB проверены 15 октября 2026 по прайсу. Российские карты Visa не работают за пределами страны (сообщение Visa): для подписки предусмотрите принимаемый сервисом способ оплаты.
Если у вас уже налажена собственная таблица, преимущество Firefly - в связях между счетами, правилах и отчетах. Сами записи переносить из привычного процесса все равно придется.
Стек и тариф для личного учета
Схема состоит из четырех служб. Приложение обслуживает интерфейс и API, MariaDB хранит операции, cron запускает повторяющиеся задачи, Caddy принимает внешний HTTPS и передает запросы приложению.
Ядро слушает только 127.0.0.1:8080, база наружу не публикуется. Данные лежат в постоянных томах: удаление контейнера не удаляет учет.
Для этого состава рекомендуем CPU2-RAM4-DISK50: 2 vCPU, 4 ГБ памяти, 50 ГБ диска. Тариф вместил ОС, приложение и сценарий со 103 операциями. Численный минимум памяти в изученной документации вендора не найден.
На стенде Ubuntu 24.04.4, Docker 29.9.1 и Compose 5.6.0. Закреплены Firefly III 6.7.9, MariaDB 11.8.9, Alpine 3.24.2 и Caddy 2.11.7: очередной перезапуск не должен случайно обновить базу.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe от 585 ₽/мес
Развертывание на Fatmetal Cloud Server
Нужны чистая Ubuntu, SSH-доступ и домен, который уже указывает на сервер. На нашем стенде установка заняла около семи минут; из них две минуты ушли на образы.
Подготовьте Ubuntu 24.04
Войдите по SSH и перейдите в root командой sudo -i. Команды ниже рассчитаны на x86-64. Откройте TCP 80/443 и направьте A-запись своего домена на сервер.
apt-get update apt-get install -y ca-certificates curl openssl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc printf 'deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable\n' > /etc/apt/sources.list.d/docker.list apt-get update apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-pluginЗадайте адрес и секреты
Замените ваш-домен своим именем. Ключ приложения и токен cron получатся по 32 символа. Эти команды выполняются один раз: при обновлении ключи сохраняйте.
mkdir -p /opt/firefly && cd /opt/firefly umask 077 DOMAIN=ваш-домен APP_KEY=$(openssl rand -hex 16) DB_PASSWORD=$(openssl rand -hex 24) CRON_TOKEN=$(openssl rand -hex 16) printf 'APP_KEY=%s\nAPP_URL=https://%s\nDB_PASSWORD=%s\nSTATIC_CRON_TOKEN=%s\nTZ=Europe/Moscow\nDEFAULT_LANGUAGE=ru_RU\nTRUSTED_PROXIES=**\nDB_CONNECTION=mysql\nDB_HOST=db\nDB_PORT=3306\nDB_DATABASE=firefly\nDB_USERNAME=firefly\nAPP_ENV=production\nAPP_DEBUG=false\nMAIL_MAILER=log\n' "$APP_KEY" "$DOMAIN" "$DB_PASSWORD" "$CRON_TOKEN" > .env printf 'MARIADB_RANDOM_ROOT_PASSWORD=yes\nMARIADB_DATABASE=firefly\nMARIADB_USER=firefly\nMARIADB_PASSWORD=%s\n' "$DB_PASSWORD" > .db.envСоздайте compose-файл
Это официальный состав app + db + cron с проверкой готовности базы и Caddy перед приложением. Том загрузок нужен для вложений; внутренние порты остаются закрыты.
cat > docker-compose.yml <<'EOF' name: firefly services: app: image: fireflyiii/core:version-6.7.9 container_name: firefly_iii_core restart: unless-stopped env_file: .env ports: ["127.0.0.1:8080:8080"] volumes: ["firefly_upload:/var/www/html/storage/upload"] depends_on: {db: {condition: service_healthy}} db: image: mariadb:11.8.9 container_name: firefly_iii_db restart: unless-stopped env_file: .db.env volumes: ["firefly_db:/var/lib/mysql"] healthcheck: {test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"], interval: 5s, timeout: 5s, retries: 60} cron: image: alpine:3.24.2 container_name: firefly_iii_cron restart: unless-stopped env_file: .env volumes: ["./cron.sh:/usr/local/bin/firefly-cron:ro"] command: ["sh", "-c", "apk add --no-cache tzdata && ln -sf /usr/share/zoneinfo/$$TZ /etc/localtime && echo '0 3 * * * /usr/local/bin/firefly-cron >/dev/null 2>&1' | crontab - && exec crond -f -L /dev/stdout"] caddy: image: caddy:2.11.7 container_name: firefly-caddy restart: unless-stopped ports: ["80:80", "443:443", "443:443/udp"] volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "caddy_data:/data", "caddy_config:/config"] volumes: {firefly_upload: {}, firefly_db: {}, caddy_data: {}, caddy_config: {}} EOFВключите cron и HTTPS
Настройте ежедневный запуск задач и автоматический сертификат Caddy.
printf '#!/bin/sh\nexec wget -qO- "http://app:8080/api/v1/cron/${STATIC_CRON_TOKEN}"\n' > cron.sh chmod 700 cron.sh printf '%s {\n reverse_proxy app:8080\n}\n' "$DOMAIN" > Caddyfile docker compose pull docker compose up -d --wait --wait-timeout 240 curl -fsS -o /dev/null -w '%{http_code}\n' https://ваш-домен/login
Cron работает в 03:00 по Москве. Отдельный скрипт читает токен из окружения: в текст задания он не попадает. Первый запуск выполняет миграции базы.
Откройте HTTPS-адрес сразу после запуска. Зарегистрируйте владельца с паролем не короче 16 символов, затем пройдите начальную настройку счетов. Дальнейшую регистрацию закрывает включенный режим одного пользователя.
Для рублей сначала включите Russian ruble в «Валюты», затем выберите RUB в «Финансовые администраторы» и в своих счетах. Смена валюты не конвертирует уже сохраненную начальную проводку.
Настройте бюджет и правило
Создайте бюджет «Продукты», задайте фиксированную сумму 20 000 рублей и период «Ежемесячно». Сохраненный расход на 3 500 оставляет 16 500 рублей до конца месяца.
Затем создайте правило на событие создания транзакции. Условие - описание содержит «Продукты», действие - установить категорию «Еда». У покупки выберите этот бюджет и оставьте «Применить правила» включенным.
На карточке сохраненной операции видны категория, бюджет и запись Rule #1 в журнале аудита. Так можно проверить автоматизацию на одной покупке до массового заполнения учета.
Сколько ресурсов нужно для личного учета
| Показатель | Наш результат |
|---|---|
| Память в простое | 151 МиБ anon + 48 МиБ общей памяти |
| Пик сценария | 228 МиБ anon + 49 МиБ общей памяти |
| Образы без сжатия | 1,77 ГБ суммарно |
| Корень после установки | 4,15 ГиБ занято |
| Скачивание и распаковка образов | 126 секунд |
| Повторный запуск с данными | 25 секунд до ответа, 28 до healthy |
| Отклик страницы входа | 98 мс |
| Отклик авторизованной сводки | 196 мс |
После трех ручных операций добавили еще сто за август и сентябрь: 96 расходов, два дохода и два перевода. Правила отработали; память anon после сценария выросла до 201 МиБ.
Отчет показал 160 000 рублей дохода и 99 960 расходов. Экспорт всех 103 записей в CSV занял 0,42 секунды, файл получился 39 КБ. По этой нагрузке менять рекомендованный тариф не требуется.
Цифры сняты на нашем стенде CPU2-RAM4-DISK50. Общая память PHP учитывается отдельно: ее нельзя считать свободным файловым кешем. Эти данные относятся к личному учету.
Проверено на версии v6.7.9, 15 октября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. В форме остался неизвестный тип счета или выбор еще загружается.
Решение. Выберите существующие источник и назначение из подсказок, дождитесь обновления формы. Если контрагента нет, сначала создайте счет расходов или доходов.
Причина. Для имени исчерпана недельная квота Let's Encrypt. С этим столкнулись на переиспользуемом адресе стенда.
Решение. Посмотрите указанное время retry after и журнал Caddy; повторные заказы сертификата квоту не сбросят. Для нового собственного домена направьте DNS на сервер и замените имя в Caddyfile.
docker compose logs --tail=50 caddy
docker compose exec -T caddy caddy reload --config /etc/caddy/CaddyfileПри ошибке TLS не отключайте проверку сертификатов у пользователей. Временное исключение на тестовом стенде не является настройкой рабочего сервера.
Пустая форма или неверный протокол ссылок за прокси - повод проверить APP_URL и TRUSTED_PROXIES. В этой схеме приложение доступно только через доверенный Caddy.
Закройте доступ и обновляйте ядро
Первую регистрацию выполните сами. В «Настройки системы → Конфигурация» проверьте режим одного пользователя. В профиле включите MFA: неверный код на стенде был отвергнут, действующий TOTP открыл сессию.
Движок выражений оставьте выключенным: он разрешает динамические действия правил и увеличивает возможности пользователя на сервере. Для назначения категорий включать его не нужно.
Для обновления сначала сделайте резервную копию, затем поменяйте только тег образа app на нужную версию. MariaDB обновляйте отдельно, после проверки совместимости и восстановления копии.
cd /opt/firefly
docker compose pull app
docker compose up -d --no-deps app
docker compose logs --tail=50 appПосле обновления войдите в интерфейс, откройте последнюю операцию и выполните cron. Его успешный JSON содержит результат для вашего пользователя; слишком ранний повтор пропускается без ошибки.
docker exec firefly_iii_cron /usr/local/bin/firefly-cronУязвимости прошлых версий
Инструкция устанавливает 6.7.9. Владельцам затронутых версий следует сделать копию данных и обновить ядро командами выше. High-уязвимость затрагивает прежнюю версию нашего разбора 6.6.6.
| Идентификатор | Серьезность | Затронуты | Исправлено | Последствие |
|---|---|---|---|---|
| GHSA-3wcx-g7jc-h9vc | High | ≤6.6.6 | 6.7.0 | Заблокированный пользователь с прежним API-токеном мог снять собственную блокировку. |
| GHSA-6jq6-x4cx-qvcm | Medium | ≤6.6.2 | 6.6.3 | Имя копилки могло выполнить JavaScript в журнале операции. |
| GHSA-4gm4-c4mh-4p7w | Medium | <6.1.17 | 6.1.17 | OAuth позволял обойти MFA при знании пароля. |
| GHSA-29w6-c52g-m8jc | Medium | <6.1.7 | Не указано | Формулы в CSV могли исполняться при открытии таблицы. |
| GHSA-5q8v-j673-m5v4 | Low | 6.4.23-6.5.0 | 6.5.1 | API выдавал сведения о других пользователях. |
| Релиз 6.7.0 | Не назначена | Не опубликованы | 6.7.0 | Ограничены ресурсоемкие запросы; исправлены выполнение shell через правила, действия до отказа MFA и запись секрета MFA в аудит. |
| Релиз 6.7.5 | Не назначена | Не опубликованы | 6.7.5 | Закрыт другой обход MFA через OAuth client ID, логин и пароль. |
| Релиз 6.7.8 | Не назначена | Не опубликованы | 6.7.8 | Статический токен перестал целиком записываться в лог. |
У исправлений из заметок релизов нет опубликованных CVE/GHSA и точного диапазона версий; сведения взяты из заметок соответствующих релизов. Исторический OAuth-бюллетень и исправление 6.7.5 - разные ошибки.
Сделайте и проверьте резервную копию
Копируйте базу, вложения и конфигурацию вместе. APP_KEY находится в .env; без прежнего ключа зашифрованные поля не прочитать. Перед снимком остановите приложение и cron, оставив базу работающей.
cd /opt/firefly && mkdir -p backup && chmod 700 backup
docker compose stop app cron
docker exec firefly_iii_db sh -c 'MYSQL_PWD="$MARIADB_PASSWORD" mariadb-dump -u "$MARIADB_USER" --single-transaction "$MARIADB_DATABASE"' > backup/firefly.sql
docker run --rm -v firefly_firefly_upload:/data:ro -v "$PWD/backup:/backup" alpine:3.24.2 tar czf /backup/upload.tgz -C /data .
cp .env .db.env docker-compose.yml Caddyfile cron.sh backup/
docker compose start app cronПеренесите каталог backup на другую машину и храните его с закрытым доступом: там финансовые записи и секреты. Локальная копия рядом с рабочими томами не спасает при потере VPS.
Для восстановления подготовьте Docker и каталог /opt/firefly, положите туда backup. При переносе на другой сервер перенаправьте A-запись домена на его адрес. Команды ниже заменяют содержимое базы данными копии; приложение до окончания импорта должно быть остановлено.
cd /opt/firefly
cp backup/.env backup/.db.env backup/docker-compose.yml backup/Caddyfile backup/cron.sh .
docker compose stop app cron
docker compose up -d --wait db
docker exec -i firefly_iii_db sh -c 'MYSQL_PWD="$MARIADB_PASSWORD" mariadb -u "$MARIADB_USER" "$MARIADB_DATABASE"' < backup/firefly.sql
docker run --rm -v firefly_firefly_upload:/data -v "$PWD/backup:/backup:ro" alpine:3.24.2 tar xzf /backup/upload.tgz -C /data .
docker compose up -d --wait --wait-timeout 240Проверьте вход, последнюю операцию и вложения. Только после этого считайте копирование рабочим. Одного наличия SQL-файла недостаточно: ключ и файлы могли остаться на старом сервере.
Что подключать к учету
- Свой SMTP. Для восстановления пароля задайте MAIL_MAILER=smtp, MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_ENCRYPTION=tls и MAIL_FROM в .env; затем пересоздайте app. Проверку сертификата оставьте включенной.
- REST API. В «Внешний доступ и токены» создается персональный токен для интеграции. Он дает широкий доступ к финансовым данным и показывается один раз: храните как пароль.
- Экспорт. «Экспорт данных → Экспорт всех транзакций» выдает CSV со счетами, бюджетами, категориями и суммами. Это удобный перенос записей, но не замена полной резервной копии.
Штатное письмо сброса пароля на стенде доставлено через SMTP с проверкой сертификата. По умолчанию в приведенной конфигурации письма пишутся в лог; для отправки нужен ваш почтовый сервер.
Когда это НЕ ваш выбор
Вы хотите подключить российский банк и забыть о ручном вводе
Готового автоимпорта из российских банков нет. CSV и банковские коннекторы относятся к отдельному Data Importer; он не входит в эту установку.
Супругам нужен общий учет с разными логинами
Отдельные пользователи ведут отдельные данные. Это не общий семейный кошелек с ролями и совместным редактированием счетов.
Вы ищете точное повторение YNAB
Firefly строит учет счетов и расходов, а не обязательное распределение каждого имеющегося рубля по конвертам. Выбор модели важнее сходства экранов.
Частые вопросы
Почему перевод не считается покупкой?
У него два ваших счета. В проверенном отчете переводы сохранили общий остаток и не увеличили ни доходы, ни расходы.
Можно ли вести рубли?
Да. Включите RUB в Валютах, выберите основную валюту финансовой администрации и валюты счетов. Заранее задайте валюту начального баланса.
Где поменять язык?
Начальная настройка и профиль позволяют выбрать русский. Перевод частичный: некоторые подписи остаются английскими.
Как проверить правила?
Создайте одну подходящую операцию и откройте ее карточку: видны назначенная категория и запись действия правила в журнале аудита.
Какой сервер выбрать?
Для проверенного личного учета рекомендуем CPU2-RAM4-DISK50. Сценарий со 103 операциями и экспортом не потребовал большего тарифа.
Какая лицензия у программы?
AGPL-3.0-or-later; текст находится в репозитории. Платного ключа для функций рассмотренной установки нет.
Итог
Firefly III подходит для учета своих счетов, месячных лимитов и повторяющихся расходов. Источник и назначение у каждой операции помогают отделить реальные покупки от движения денег между своими счетами.
Начните с одного месяца: задайте валюту, заведите счета, бюджет и правило. После этого проверьте отчет, включите MFA и настройте резервное копирование. В версии 6.7.9 обновленный интерфейс сочетается с исправлениями безопасности прошлой ветки.
Рекомендуемая конфигурация для установки:
2 vCPU · 4 ГБ RAM · 50 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Firefly III на этой конфигурации автоматически - от 585 ₽/мес.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.