Обновлено 15 октября 2026 г.
Финансы и учет

Firefly III

Приложение для учета личных финансов на своем сервере: расходы по нескольким счетам, переводы и месячные бюджеты. Развернули 6.7.9 на Fatmetal Cloud Server, замерили потребление и проверили учет денег.

Проверено на версии v6.7.9, 15 октября 2026~13 минутFatmetal Team

Весь функционал ядра бесплатен, платных модулей нет. Сервер и администрирование оплачиваются отдельно.

Личные финансыAGPL-3.0-or-later4 контейнераВерсия 6.7.9 запущена

Вердикт

Подходит
  • У вас несколько своих счетов: нужно отличать покупки от переводов в накопления.
  • Вы задаете лимит трат на месяц и хотите видеть остаток по бюджету.
  • Одинаковые расходы нужно раскладывать по категориям автоматически.
Не подходит
  • Нужна автоматическая синхронизация с российским банком.
  • Нужен общий кошелек с отдельными семейными логинами.
  • Нужна именно конвертная методика YNAB.
Рекомендуем: CPU2-RAM4-DISK50Сложность: mediumУстановка: около 7 минутГлавный риск: первым владельцем становится первый зарегистрировавшийсяПрод-готовность: после регистрации владельца, MFA и резервного копирования
Что это

Как учитывать расходы с нескольких счетов

Перевод в накопления оставляет деньги вашими и не увеличивает расходы месяца. Поэтому Firefly III различает покупки и движение денег между вашими счетами.

Для этого у каждой операции есть источник и назначение. Зарплата идет от работодателя на основной счет, покупка - с него в супермаркет, перевод - на другой ваш счет.

Бюджет здесь означает лимит расходов за период. Категория отвечает, на что ушли деньги, а правило присваивает ее по условию. Например, описание содержит «Продукты» - назначить категорию «Еда».

В октябре мы записали доход 80 000 рублей, покупку на 3 500 и перевод 10 000 между счетами. Баланс периода составил 76 500 рублей; перевод в нем не стал расходом.

PHP / LaravelMariaDBDocker ComposeCaddycron
https://finance.example.com
Сводка октября: расходы отдельно от переводов между своими счетами
Сводка октября: расходы отдельно от переводов между своими счетами. Firefly III 6.7.9.
Переобход

Что изменилось с прошлого разбора

Прежняя статья описывала 6.6.6. В ветке 6.7 Twig заменен на Blade, обновлен AdminLTE, переделаны формы операций, список транзакций и страница OAuth-токенов.

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

Cron теперь возвращает результаты по пользователям. Сохранен статический токен ровно из 32 символов. Движок выражений правил выключен по умолчанию; обычное правило назначения категории работает без него.

В 6.7.2-6.7.9 исправлялись регрессии интерфейса, валют и сверки счетов. Исправления безопасности вынесены в раздел «Уязвимости прошлых версий»: это отдельная причина уйти с 6.6.6.

https://finance.example.com
Новая форма редактирования расхода с бюджетом и категорией
Новая форма редактирования расхода с бюджетом и категорией. Firefly III 6.7.9.
Сравнение

Чем отличается от YNAB

Firefly III отвечает на вопрос «где деньги и на что они потрачены». YNAB предлагает распределять имеющиеся деньги по задачам. Похожий месячный бюджет не делает эти модели взаимозаменяемыми.

КритерийFirefly IIIYNAB
ОплатаПрограмма бесплатна; оплачивается сервер$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-доступ и домен, который уже указывает на сервер. На нашем стенде установка заняла около семи минут; из них две минуты ушли на образы.

  1. Подготовьте 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
  2. Задайте адрес и секреты

    Замените ваш-домен своим именем. Ключ приложения и токен 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
  3. Создайте 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
  4. Включите 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 в журнале аудита. Так можно проверить автоматизацию на одной покупке до массового заполнения учета.

https://finance.example.com
Месячный бюджет: из лимита 20 000 рублей осталось 16 500
Месячный бюджет: из лимита 20 000 рублей осталось 16 500. Firefly III 6.7.9.
https://finance.example.com
Правило присваивает категорию по описанию операции
Правило присваивает категорию по описанию операции. Firefly III 6.7.9.
Замеры

Сколько ресурсов нужно для личного учета

ПоказательНаш результат
Память в простое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 учитывается отдельно: ее нельзя считать свободным файловым кешем. Эти данные относятся к личному учету.

https://finance.example.com
Отчет по ста операциям: переводы не увеличивают доходы и расходы
Отчет по ста операциям: переводы не увеличивают доходы и расходы. Firefly III 6.7.9.

Проверено на версии v6.7.9, 15 октября 2026. На новых версиях результаты могут отличаться.

Диагностика

Где может сломаться

Выбранное значение transactions.0.type недопустимо

Причина. В форме остался неизвестный тип счета или выбор еще загружается.

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

too many certificates (5) already issued

Причина. Для имени исчерпана недельная квота 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
i

При ошибке 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-h9vcHigh≤6.6.66.7.0Заблокированный пользователь с прежним API-токеном мог снять собственную блокировку.
GHSA-6jq6-x4cx-qvcmMedium≤6.6.26.6.3Имя копилки могло выполнить JavaScript в журнале операции.
GHSA-4gm4-c4mh-4p7wMedium<6.1.176.1.17OAuth позволял обойти MFA при знании пароля.
GHSA-29w6-c52g-m8jcMedium<6.1.7Не указаноФормулы в CSV могли исполняться при открытии таблицы.
GHSA-5q8v-j673-m5v4Low6.4.23-6.5.06.5.1API выдавал сведения о других пользователях.
Релиз 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 строит учет счетов и расходов, а не обязательное распределение каждого имеющегося рубля по конвертам. Выбор модели важнее сходства экранов.

FAQ

Частые вопросы

Почему перевод не считается покупкой?

У него два ваших счета. В проверенном отчете переводы сохранили общий остаток и не увеличили ни доходы, ни расходы.

Можно ли вести рубли?

Да. Включите 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 ₽/мес.

Запустить Firefly III →
Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.