Контроль над личными расходами, семейным бюджетом или финансами небольшого бизнеса — фундаментальный навык финансовой устойчивости. Долгое время золотым стандартом методологии бюджетирования с нулевым остатком (Zero-Based Budgeting) оставался сервис YNAB (You Need A Budget). Однако регулярные повышения тарифов (до $14.99 в месяц или $109 в год), блокировка оплаты российскими банковскими картами и риски утечек конфиденциальных данных о счетах заставили сообщество искать надежную независимую альтернативу.
Actual Budget — это мощная открытая система управления финансами с открытым исходным кодом (Open Source), признанная сообществом r/selfhosted главным мировым хитом среди финансовых приложений (более 30 000 звёзд на GitHub в официальном монорепозитории actualbudget/actual). Ключевое архитектурное преимущество Actual Budget — принцип Local-First и полноценное сквозное шифрование (End-to-End Encryption, E2EE). Вся расчетная логика и база данных SQLite работают непосредственно на вашем устройстве (в браузере или приложении), а сервер выполняет исключительно роль зашифрованного хранилища и синхронизирует изменения между клиентами в реальном времени. В этом практическом руководстве мы разберем развертывание Actual Budget на собственном VDS в Docker Compose, настройку защищенного обратного прокси Nginx с WebSocket и SSL, установку PWA-клиентов на смартфоны и импорт выписок из российских банков.
1. Концепция Local-First и Zero-Based бюджетирования: почему Actual Budget вытесняет YNAB
Методология бюджетирования с нулевым балансом кардинально отличается от пассивного учета расходов. Вместо того чтобы в конце месяца констатировать, куда ушли деньги, вы распределяете каждый поступивший рубль по конкретным фондам и категориям (аренда сервера, налоги, маркетинг, непредвиденные расходы, личные траты) еще до совершения покупок.
| Критерий | Облачные сервисы (YNAB SaaS) | Электронные таблицы (Excel / Google) | Self-Hosted Actual Budget |
|---|---|---|---|
| Стоимость | $109/год (недоступно для оплаты из РФ) | Бесплатно | Бесплатно (только минимальный VDS от 200–300 ₽/мес) |
| Приватность и доступ | Все транзакции видны облачному провайдеру | Риск случайного удаления формул или повреждения файла | Сквозное шифрование (E2EE): сервер хранит только шифротекст |
| Синхронизация устройств | Облачная через API вендора | Неудобно с мобильных устройств | Мгновенная по WebSockets + полная работа офлайн |
| Поддержка банков РФ | Отсутствует (интеграции только с банками США/ЕС) | Ручной ввод или написание сложных макросов | Прямой импорт выписок CSV/OFX (Т-Банк, Сбер, Альфа) с автоправилами |
| Мобильный опыт | Приложение из App Store / Google Play | Неудобный мобильный интерфейс | Полнофункциональное адаптивное PWA без риска блокировки магазинами |
💡 Совет инженера
Принцип Local-First гарантирует максимальную отзывчивость: любые фильтрации, пересчеты бюджетов за несколько лет и добавление операций происходят мгновенно, так как движок SQLite компилируется в WebAssembly прямо внутри браузера. Отсутствие постоянных сетевых задержек делает интерфейс Actual Budget визуально быстрее любого классического веб-сервиса.
2. Архитектура сквозного шифрования (E2EE) и минимальные требования к VDS
Архитектура Actual Budget разделена на две независимые части:
- Клиентское приложение (Web / Desktop / PWA): хранит локальную базу данных SQLite в памяти IndexedDB устройства, производит шифрование данных алгоритмом AES-256-GCM с формированием ключа на базе пароля по стандарту PBKDF2.
- Сервер синхронизации (actual-server): легковесный сервис на Node.js, который хранит метаданные пользователей, принимает зашифрованные дельты изменений (CRDT-сообщения) и пересылает их подключенным клиентам по протоколу WebSocket. Сам сервер синхронизации теперь разрабатывается и поддерживается непосредственно внутри основного монорепозитория
actualbudget/actual.
Так как сервер не занимается рендерингом страниц и расчетом финансовых формул, он потребляет микроскопическое количество системных ресурсов: в рабочем состоянии процесс занимает всего 80–150 МБ оперативной памяти. Это позволяет развернуть Actual Budget на самом доступном VDS или подселить его к уже существующим проектам без риска перегрузить сервер.
| Ресурс | Минимальные требования | Рекомендуемая конфигурация |
|---|---|---|
| Процессор (vCPU) | 1 vCPU (от 2.0 ГГц) |
1 vCPU (от 3.0 ГГц) |
| Оперативная память (RAM) | 512 МБ (+ 1 ГБ Swap) |
1 ГБ |
| Накопитель (NVMe) | 10 ГБ |
15–20 ГБ NVMe |
| Операционная система | Debian 12 / Ubuntu 22.04 LTS | Ubuntu 24.04 LTS (x86_64) |
Подготовим базовое серверное окружение, установим Docker и настроим системный фаервол UFW для защиты портов:
# Обновление индекса пакетов и системы
sudo apt update && sudo apt upgrade -y
# Установка необходимых утилит
sudo apt install -y curl wget git ufw ca-certificates gnupg
# Базовая настройка фаервола UFW: блокировка всего входящего трафика, кроме SSH и Web
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw --force enable
sudo ufw status verbose
# Установка Docker через официальный скрипт
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Добавление пользователя в группу docker
# Внимание: членство в группе docker предоставляет права, эквивалентные root на сервере
sudo usermod -aG docker $USER
newgrp docker
# Создание рабочего каталога для данных Actual Budget
sudo mkdir -p /opt/actual-budget/{actual-data,backup,logs}
sudo chown -R $USER:$USER /opt/actual-budget
cd /opt/actual-budget
# Назначение безопасных прав на директорию резервных копий
chmod 750 /opt/actual-budget/backup
Перед запуском сервиса убедитесь, что поддомен для учета финансов (например, budget.example.com) направлен A-записью на IP-адрес вашего виртуального сервера. Проверить статус DNS-записей можно через инструмент DNS Lookup на SysKit.
3. Манифест Docker Compose: запуск actual-server с лимитами и петлевой привязкой портов
Для развертывания сервера синхронизации мы фиксируем официальный стабильный релиз docker.io/actualbudget/actual-server:26.11.0. Указание точного номера версии гарантирует предсказуемость поведения системы и исключает несовместимость форматов баз при случайных автоматических обновлениях.
Создадим файл переменных окружения /opt/actual-budget/.env для тонкой настройки сервера:
# Создание файла переменных окружения
cat <<EOF > /opt/actual-budget/.env
# Порт внутреннего веб-сервера
ACTUAL_PORT=5006
# Лимит на размер импортируемых файлов выписок и вложений (в мегабайтах)
ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB=25
# Доверенные прокси-серверы для корректного определения реального IP клиента
ACTUAL_TRUSTED_PROXIES=127.0.0.1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16
EOF
# Защита прав доступа к конфигурационному файлу
chmod 600 /opt/actual-budget/.env
Теперь создадим файл /opt/actual-budget/docker-compose.yml. Обратите особое внимание на проброс портов: порт 5006 опубликован строго на адрес локальной петли 127.0.0.1:5006:5006. Это исключает несанкционированный публичный доступ к внутреннему сервису в обход сетевого фильтра UFW:
services:
actual-server:
image: docker.io/actualbudget/actual-server:26.11.0
container_name: actual-server
restart: unless-stopped
mem_limit: 512m
cpus: 1.0
ports:
# Публикация строго на 127.0.0.1: порт надежно защищен от прямого внешнего доступа
- "127.0.0.1:5006:5006"
environment:
- ACTUAL_PORT=${ACTUAL_PORT}
- ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB=${ACTUAL_UPLOAD_FILE_SIZE_LIMIT_MB}
- ACTUAL_TRUSTED_PROXIES=${ACTUAL_TRUSTED_PROXIES}
volumes:
# Постоянное хранилище зашифрованных баз данных и файлов синхронизации
- ./actual-data:/data
healthcheck:
test: ["CMD", "node", "-e", "require('http').get('http://127.0.0.1:5006', (r) => { process.exit(r.statusCode === 200 ? 0 : 1); })"]
interval: 20s
timeout: 5s
retries: 3
start_period: 15s
💡 Совет инженера
Директивы mem_limit: 512m и cpus: 1.0 заданы на верхнем уровне сервиса: в стандартном standalone-режиме Docker Compose (без кластера Docker Swarm) параметры из блока deploy.resources часто игнорируются демоном Docker, тогда как нативные директивы mem_limit гарантируют жесткое ограничение cgroups и защищают VDS от паники ядра.
Запустим контейнер в фоновом режиме:
# Запуск контейнера Actual Budget
docker compose up -d
# Проверка статуса запуска
docker compose ps
# Просмотр логов сервера
docker compose logs -f actual-server
Сервер синхронизации инициализирует структуру директорий /data/server-files и /data/user-files внутри примонтированного тома и начнет слушать входящие соединения.
4. Настройка обратного прокси Nginx, WebSocket и выпуск SSL Let's Encrypt
Actual Budget критически зависит от постоянных WebSocket-соединений: через них передаются криптографические дельты синхронизации между вкладками браузера и мобильными приложениями. Кроме того, современные стандарты веб-криптографии (Web Crypto API) и механизм Service Workers (для офлайн-работы PWA) принципиально требуют защищенного протокола HTTPS.
Создадим виртуальный хост Nginx для вашего поддомена (замените budget.example.com на ваш реальный домен):
# /etc/nginx/sites-available/budget.example.com.conf
server {
listen 80;
listen [::]:80;
server_name budget.example.com;
# Максимальный размер загружаемых банковских выписок в форматах CSV/OFX
client_max_body_size 25M;
location / {
proxy_pass http://127.0.0.1:5006;
proxy_http_version 1.1;
# Критически важно: поддержка постоянных соединений WebSocket
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# Передача параметров хоста и IP-адреса клиента
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;
# Таймауты для поддержания постоянной фоновой сессии синхронизации
proxy_connect_timeout 60s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
}
}
Активируем конфигурацию, проверим синтаксис и перезагрузим веб-сервер:
# Активация виртуального хоста в Nginx
sudo ln -sf /etc/nginx/sites-available/budget.example.com.conf /etc/nginx/sites-enabled/
# Проверка синтаксиса конфигурации
sudo nginx -t
# Перезапуск службы Nginx
sudo systemctl reload nginx
Теперь выпустим доверенный бесплатный SSL-сертификат Let's Encrypt с автоматическим перенаправлением с HTTP на HTTPS (обязательно укажите флаг --redirect):
# Установка Certbot и плагина для Nginx
sudo apt install -y certbot python3-certbot-nginx
# Выпуск сертификата с автоматическим 301-редиректом
sudo certbot --nginx --redirect -d budget.example.com
# Проверка статуса таймера автоматического продления
sudo systemctl status certbot.timer
После выпуска сертификата проверьте корректность настроек TLS через инструмент SSL Checker и удостоверьтесь в доступности портов 80 и 443 через утилиту Port Checker на SysKit.
5. Выбор надежного VDS под персональные и корпоративные финансы
Финансовая система требует круглосуточной доступности: возможность быстро внести транзакцию на кассе магазина, проверить лимит категории перед крупной покупкой или подвести итоги недели не должна зависеть от перебоев в сети или плановых работ провайдера. При выборе сервера под Actual Budget обратите внимание на ключевые критерии:
- Круглосуточный высокий аптайм (SLA 99.98%): Даже кратковременный даунтайм сервера не сломает локальную базу в вашем телефоне (благодаря архитектуре Local-First), однако вызовет задержку синхронизации данных между членами семьи или финансовым отделом компании. Дата-центры уровня Tier III гарантируют бесперебойное электропитание и резервирование интернет-магистралей.
- Низкие сетевые задержки (Ping): Чем ближе физический дата-центр к вашему фактическому местоположению (Москва, Санкт-Петербург), тем быстрее отрабатывает WebSocket-рукопожатие при открытии PWA-приложения на смартфоне.
- Доступная стоимость инфраструктуры: Поскольку Actual Budget крайне экономичен к ресурсам (потребляет менее 150 МБ RAM), для комфортной работы достаточно минимального тарифа VDS стоимостью 200–400 ₽ в месяц, что окупается в первый же месяц отказа от зарубежных подписок YNAB или CoinKeeper.
💡 Совет инженера
Для персонального или семейного учета отлично подойдет базовый сервер с 1 vCPU, 1 ГБ RAM и 15 ГБ NVMe. Если на этом же сервере вы планируете параллельно развернуть другие полезные self-hosted утилиты (например, менеджер паролей Vaultwarden или шифрованные бэкапы Kopia), выбирайте конфигурацию с 2 vCPU и 2–4 ГБ оперативной памяти.
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Экономичные и надежные виртуальные серверы с быстрым диском NVMe и аптаймом 99.98% для постоянной синхронизации PWA-клиентов.
Selectel — Корпоративные облачные серверы
Сертифицированная инфраструктура уровня Tier III с гарантированной доступностью и защитой персональных данных по 152-ФЗ.
Beget — Удобные VDS для бизнеса
Интуитивная панель управления, автоматические ежедневные бэкапы и мгновенный деплой Docker Compose за 1 минуту.
6. Настройка счетов и импорт выписок из банков РФ (Т-Банк, Сбер, Альфа)
Перейдите в браузере по адресу https://budget.example.com. При первом входе система предложит задать пароль сервера (Server Password), после чего откроется мастер создания первого бюджета. Выберите пункт Create new file и назовите бюджет (например, «Семейный бюджет» или «Финансы бизнеса»).
Первым делом активируем сквозное шифрование (E2EE). Перейдите в More → Settings → End-to-end encryption и нажмите Enable. Введите мастер-пароль шифрования. С этого момента все таблицы SQLite будут шифроваться на устройстве до передачи на сервер.
⚠️ Важное предупреждение
Обязательно сохраните мастер-пароль сквозного шифрования в надежном менеджере паролей. Так как сервер синхронизации оперирует исключительно зашифрованными блобами (Zero-Knowledge Architecture), в системе принципиально отсутствует функция сброса пароля или восстановления доступа. При утере ключа шифрования расшифровать данные на новом устройстве будет технически невозможно.
Создайте счета (Accounts):
- On-Budget Accounts: дебетовые карты, наличные и расчетные счета, деньги с которых участвуют в распределении по категориям.
- Off-Budget / Tracking Accounts: накопительные счета, инвестиционные портфели или кредиты, остатки по которым отслеживаются только для расчета чистого капитала (Net Worth).
Для загрузки истории операций перейдите в веб-банк вашего банка и сформируйте выписку в формате CSV или OFX/QIF:
| Банк РФ | Формат выгрузки | Особенности сопоставления колонок |
|---|---|---|
| Т-Банк (Тинькофф) | CSV (UTF-8) |
Колонка «Сумма операции» содержит отрицательные значения для расходов и положительные для доходов. Сопоставьте с полем Amount. |
| СберБанк | CSV (Windows-1251 / UTF-8) |
При кодировке Windows-1251 сохраните файл как UTF-8. Дата операции задается в формате DD.MM.YYYY. |
| Альфа-Банк | CSV / OFX / QIF |
При выгрузке в OFX импорт происходит автоматически; при выборе CSV сопоставьте дату, получателя и сумму с разделителем «точка с запятой». |
Нажмите Import внутри счета и выберите файл выписки. Actual Budget запоминает настройки колонок и в будущем автоматически определяет поля. С помощью раздела Rules настройте автоматические правила категоризации (например: если поле Payee содержит «Яндекс Маркет», автоматически присваивать категорию «Покупки для дома»).
7. Мобильные клиенты PWA для iOS и Android: работа офлайн и синхронизация
Actual Budget не требует скачивания тяжелых нативных приложений из магазинов Google Play или App Store, подверженных риску санкционных удалений. Интерфейс адаптирован как полнофункциональное прогрессивное веб-приложение (Progressive Web App, PWA).
Для установки мобильного клиента:
- На iPhone / iPad (iOS): Откройте
https://budget.example.comв браузере Safari, нажмите кнопку «Поделиться» (иконка квадрата со стрелкой вверх) и выберите пункт «На экран Домой». Приложение появится в виде отдельной иконки на рабочем столе и будет открываться в полноэкранном режиме без адресной строки браузера. - На Android: Откройте сайт в Google Chrome или Яндекс Браузере и нажмите всплывающую плашку «Добавить Actual на главный экран» (или выберите этот пункт в меню трех точек).
💡 Совет инженера
Мобильный клиент работает полностью офлайн. Если вы совершаете покупку в метро, цокольном этаже или за городом без мобильной связи, приложение мгновенно запишет операцию в локальную память IndexedDB и пересчитает баланс. Как только устройство подключится к сети, зашифрованные изменения автоматически синхронизируются с сервером по WebSocket.
Для совместного ведения бюджета (с супругом или бизнес-партнером) достаточно открыть адрес сервиса на втором устройстве, ввести пароль сервера и пароль E2EE-шифрования. Все изменения на обоих экранах будут синхронизироваться в реальном времени.
8. Автоматическое резервное копирование зашифрованных хранилищ с отправкой в Telegram
Хотя Actual Budget хранит полные копии баз на каждом подключенном клиентском устройстве, серверное резервное копирование необходимо для защиты от одновременной потери гаджетов. Чтобы исключить повреждение файлов базы данных SQLite и журналов предзаписи (Write-Ahead Logging, WAL) при синхронизации в момент копирования, скрипт использует кратковременную cgroup-паузу контейнера (docker pause). Это занимает доли секунды, гарантирует атомарный срез данных и страхуется механизмом trap от зависания контейнера.
Создадим Bash-скрипт /opt/actual-budget/backup/backup.sh:
#!/usr/bin/env bash
set -Eeuo pipefail
# Конфигурация путей
PROJECT_DIR="/opt/actual-budget"
DATA_DIR="${PROJECT_DIR}/actual-data"
BACKUP_DIR="${PROJECT_DIR}/backup"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_FILE="${BACKUP_DIR}/actual_budget_${TIMESTAMP}.tar.gz"
# Telegram-оповещения (опционально)
TELEGRAM_BOT_TOKEN="ВАШ_TELEGRAM_BOT_TOKEN"
TELEGRAM_CHAT_ID="ВАШ_TELEGRAM_CHAT_ID"
send_telegram() {
local message="$1"
if [[ -n "${TELEGRAM_BOT_TOKEN}" && -n "${TELEGRAM_CHAT_ID}" ]]; then
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
--data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
--data-urlencode "text=${message}" > /dev/null || true
fi
}
# Гарантированное возобновление работы контейнера при любом аварийном завершении
cleanup() {
docker unpause actual-server 2>/dev/null || true
}
trap cleanup EXIT
echo "=== Запуск резервного копирования Actual Budget: ${TIMESTAMP} ==="
# 1. Кратковременная пауза контейнера для атомарного и консистентного среза SQLite
docker pause actual-server
# 2. Создание сжатого архива данных пользователя и настроек сервера
tar -czf "${BACKUP_FILE}" -C "${PROJECT_DIR}" actual-data
chmod 600 "${BACKUP_FILE}"
# 3. Немедленное возобновление работы контейнера
docker unpause actual-server
trap - EXIT
BACKUP_SIZE=$(du -sh "${BACKUP_FILE}" | cut -f1)
echo "Архив успешно создан: ${BACKUP_FILE} (Размер: ${BACKUP_SIZE})"
# 4. Ротация старых копий (хранить архивы за последние 7 дней)
find "${BACKUP_DIR}" -type f -name "actual_budget_*.tar.gz" -mtime +7 -delete
# 5. Отправка подтверждения в Telegram с естественными переносами строк
MESSAGE="✅ Actual Budget Backup Успешно
Сервер: budget.example.com
Файл: $(basename "${BACKUP_FILE}")
Размер: ${BACKUP_SIZE}
Дата: $(date '+%Y-%m-%d %H:%M:%S')"
send_telegram "${MESSAGE}"
Назначим скрипту права на запуск и пропишем задание в crontab:
# Назначение безопасных прав выполнения
chmod 750 /opt/actual-budget/backup/backup.sh
# Добавление задачи в cron администратора (запуск каждую ночь в 03:00)
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/actual-budget/backup/backup.sh >> /opt/actual-budget/logs/backup.log 2>&1") | crontab -
Для настройки индивидуального графика архивации воспользуйтесь инструментом генератора выражений Cron на SysKit, а также шаблоном резервного копирования томов Docker.
9. Инженерный чек-лист проверки и ввод системы бюджетирования в эксплуатацию
Перед тем как переносить в Actual Budget все финансовые потоки компании или семьи, пройдитесь по финальному чек-листу проверки:
📋 Чек-лист готовности к production
- Безопасность портов и UFW: Порт
5006слушает строго интерфейс127.0.0.1, в фаерволе UFW открыты только порты22,80и443. - Проверка WebSocket: При открытии вкладки Network в инструментах разработчика браузера (фильтр
WS) соединение со шлюзом активно и передает сообщения синхронизации. - Валидность сертификата: Проверьте корректность цепочки шифрования HTTPS через онлайн-инструмент SSL Checker.
- Сквозное шифрование: В настройках бюджета статус E2EE имеет значение Enabled, мастер-пароль зафиксирован в надежном парольном хранилище.
- Офлайн-тест на смартфоне: Откройте PWA-приложение, переведите смартфон в режим полета (Flight Mode), добавьте тестовую транзакцию, отключите режим полета и убедитесь, что операция появилась на компьютере.
- Атомарный бэкап: Запустите тестовое выполнение
backup.sh, убедитесь в кратковременной паузе/распаузе контейнера и наличии архива в каталоге/opt/actual-budget/backup/.
Возьмите личные и корпоративные финансы под полный контроль
Откажитесь от дорогих облачных подписок и сохраняйте финансовую тайну на собственном надежном VDS с накопителями NVMe и каналом до 1 Гбит/с в российских дата-центрах.