Хостването на Actual Budget на Managed VPS означава бюджетите ви и тяхната синхронизация да остават на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Actual Budget е инструмент за лични финанси, който работи първо локално, разпространяван с лиценз MIT. Това ръководство следва официалната му документация: ролята на сървъра, инсталиране с Docker Compose, HTTPS, паролата на сървъра, OpenID, шифроването от край до край, банковата синхронизация, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 17 ноември 2026 г.Време за четене: 14 минути
SharedArrayBuffer, който браузърите включват само на страница, предоставена през HTTPS. Обратен прокси се грижи за това.docker compose pull.Actual Budget е инструмент за лични финанси, който работи първо локално, написан на Node.js, а README го описва като изцяло безплатен и с отворен код. Той пази всички ваши данни на всяко от устройствата ви и ги синхронизира във фонов режим със сървъра, който сте избрали: приложението работи дори без връзка, а промените ви стигат до другите ви устройства веднага щом мрежата се върне.
Проектът се състои от клиент и сървър. Сървърът не е задължителен, но документацията настоятелно го препоръчва, защото отключва няколко функции:
| Функция | Без сървър | Със сървър |
|---|---|---|
| Бюджети, отчети, графици | Да | Да |
| Импортиране на транзакции от файл | Да | Да |
| Импортиране и експортиране на файлове с бюджети | Да | Да |
| Приложението в браузър и на телефон | Да | |
| Синхронизация между устройствата | Да | |
| Банкова синхронизация | Да | |
| API на Actual | Да |
Actual Budget се разпространява с лиценза MIT, с авторски права на James Long. Текстът дава безплатно на всеки, който получи копие, правото да използва, копира, променя, слива, публикува, разпространява, преотстъпва и продава копия от него.
Има едно условие: бележката за авторските права и текстът на лиценза придружават всички копия или съществени части на софтуера. Можете следователно да пускате образа, публикуван от проекта, за себе си, семейството или фирмата си, без да купувате лиценз.
Проектът публикува сървъра като Docker образ, actualbudget/actual-server в Docker Hub, и същия образ в регистъра на GitHub, ghcr.io/actualbudget/actual. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, взет от файла, предоставен в хранилището:
services:
actual_server:
image: docker.io/actualbudget/actual-server:latest
container_name: actual_server
restart: unless-stopped
ports:
- 127.0.0.1:5006:5006
volumes:
- ./actual-data:/data
healthcheck:
test: ['CMD-SHELL', 'node scripts/health-check.js']
interval: 60s
timeout: 10s
retries: 3
start_period: 20s
docker compose up -d
127.0.0.1, той е достъпен само през обратния прокси на същия сървър, който добавя HTTPS.actual-data пази всичко, което сървърът съхранява. Той създава в нея две подпапки, server-files и user-files, а документацията посочва, че това монтиране запазва данните ви, когато контейнерът бъде изтрит.latest следва последната официална версия, а документацията го препоръчва за повечето потребители. latest-alpine дава същата версия върху по-лека основа Alpine, а етикет като 26.11.0 фиксира версия. Етикетите nightly следват разработката, с всяка промяна в основния ѝ клон.Името на домейна ви сочи към сървъра със записи A и AAAA, а посетителите пристигат на портове 80 и 443. Докато HTTPS не е на мястото си, приложението не се отваря: преминете направо към следващия раздел.
Проектът не дава числа за паметта и процесора. Размерът зависи от броя на бюджетите, тяхната история и броя на устройствата, които се синхронизират. На Managed VPS ни опишете как го използвате и ще ви препоръчаме подходящия размер.
Actual Budget разчита на SharedArrayBuffer, технология на браузъра, която документацията му описва като задължителна: без нея приложението не стартира. Браузърите я включват само на изолирана страница, което изисква две условия:
localhost.Cross-Origin-Embedder-Policy със стойност require-corp и Cross-Origin-Opener-Policy със стойност same-origin. Официалният сървър винаги ги поставя сам.За да изложите Actual в интернет, документацията моли да го поставите зад обратен прокси с HTTPS. Сървърът може и сам да предоставя HTTPS със сертификат, който му дадете, чрез ACTUAL_HTTPS_KEY и ACTUAL_HTTPS_CERT: документацията описва този път за сървър, който остава извън интернет.
Документацията представя Caddy като лесен обратен прокси, който сам получава и подновява сертификатите си. Ето нейния пример, адаптиран за Caddy, инсталиран на сървъра:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Този блок следва конфигурацията за Nginx от документацията, сведена до порт 80, за да остави на Certbot да постави HTTPS. Той скрива двете заглавки, изпратени от Actual, и ги поставя отново, веднъж: документацията предупреждава, че дублирана заглавка обезсилва политиката, и тогава приложението спира с грешката SharedArrayBufferMissing.
server {
listen 80;
listen [::]:80;
server_name budget.example.com;
client_max_body_size 0;
location / {
proxy_pass http://127.0.0.1:5006;
proxy_hide_header Cross-Origin-Embedder-Policy;
proxy_hide_header Cross-Origin-Opener-Policy;
add_header Cross-Origin-Embedder-Policy "require-corp" always;
add_header Cross-Origin-Opener-Policy "same-origin" always;
add_header Origin-Agent-Cluster "?1" always;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
client_max_body_size 0 премахва ограничението за размер на Nginx, както в примера от документацията, за да стигне голям файл с бюджет до сървъра. След това Certbot поставя сертификата и се грижи да го подновява:
sudo certbot --nginx
Отворете адреса си през https, в нов раздел, а не чрез презареждане на страница, която е показала грешка, както съветва документацията. Появява се началният екран на Actual: HTTPS и заглавките са на мястото си.
При първото стартиране началният екран ви моли да изберете парола за сървъра: тя защитава достъпа до бюджетите ви. Докато не е зададена, този екран се показва на първия, който отвори адреса. Затова го отворете веднага щом HTTPS заработи и изберете дълга парола, използвана само за този сървър.
Сървърът пази тази парола хеширана, с argon2, във файла account.sqlite на server-files, заедно със списъка на файловете с бюджети, които познава, и активния токен на сесията.
Документацията предоставя команда, която задава нова парола, без да докосва файловете или данните ви. Тя я иска два пъти:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password по подразбиране, openid за доставчик на идентичност или header.x-actual-password. Документацията предупреждава, че грешна настройка на тази стъпка може да направи инстанцията достъпна за целия интернет: запазете я за тези услуги.ACTUAL_ALLOWED_LOGIN_METHODS, списък, разделен със запетаи.За удостоверяване, по-надеждно от парола, документацията препоръчва доставчик на OpenID: повечето от тях предлагат двуфакторно удостоверяване. Това е и начинът да отворите сървъра за няколко потребители. Справочникът за конфигурацията представя този метод като предварителна версия.
https://budget.example.com/openid/callback.Същата конфигурация може да отиде и в config.json или в променливи на средата, с адрес за откриване, когато доставчикът публикува такъв:
environment:
ACTUAL_OPENID_DISCOVERY_URL: "https://auth.example.com/.well-known/openid-configuration"
ACTUAL_OPENID_CLIENT_ID: "actual"
ACTUAL_OPENID_CLIENT_SECRET: ${ACTUAL_OPENID_CLIENT_SECRET}
ACTUAL_OPENID_SERVER_HOSTNAME: "https://budget.example.com"
Тайната отива във файл .env до compose.yaml. От версия 26.10.0 ACTUAL_OPENID_CLIENT_SECRET_FILE може също да я чете от файл, което подхожда на тайните на Docker.
"authMethod": "oauth2", в config.json.ACTUAL_USER_CREATION_MODE със стойност login ги създава при първото им влизане.ACTUAL_OPENID_ENFORCE със стойност true го прави единствения приеман метод за влизане.ACTUAL_TOKEN_EXPIRATION е never по подразбиране. Тя може да следва тази на доставчика, с openid-provider, или продължителност в секунди.Освен паролата на сървъра всеки бюджет може да бъде шифрован от край до край. Тогава данните му се шифроват на вашето устройство, с ключ, изведен от втора парола, преди да го напуснат: сървърът само предава промени, които не може да прочете.
Документацията е категорична: забравена парола за шифроване не може да бъде възстановена. Ако все още съществува локално копие на бюджета, можете да генерирате нов ключ, което нулира синхронизацията. Шифроването не може и да се изключи: връщането към нешифрован файл минава през експорт, после импорт.
| Защита | Какво дава | Къде се настройва |
|---|---|---|
| HTTPS | Шифрова пътя между устройствата ви и сървъра и позволява на приложението да стартира | Обратният прокси |
| Парола на сървъра | Ограничава достъпа до бюджетите, хеширана с argon2 на сървъра | При първото стартиране, после в настройките |
| OpenID | Двуфакторното удостоверяване на доставчика ви и по един акаунт на човек | При доставчика, после в настройките |
| Шифроване от край до край | Прави бюджетите нечетими за сървъра и за неговите резервни копия | Във всеки бюджет |
| Шифроване на диска | Защитава локалното копие, което според документацията не е шифровано | На всяко от устройствата ви |
Шифроването от край до край покрива данните на бюджетите. Данните за достъп за банковата синхронизация се пазят на сървъра, в account.sqlite, извън това шифроване: защитете съответно достъпа до сървъра и до неговите резервни копия.
Actual импортира транзакциите ви от файл, без никаква настройка. Той може и да ги изтегля директно от банката ви, чрез доставчик на банкови данни. Тази синхронизация не е задължителна, изисква сървъра и разчита на вашите собствени данни за достъп: откривате акаунт при доставчика и създавате там ключовете, които давате на Actual. Тези ключове се пазят на сървъра и ги въвеждате само веднъж.
| Доставчик | Обхванати банки, според документацията | Състояние във версия 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Северноамерикански банки | Поддържан; данни за достъп за всеки бюджет поотделно са възможни от 26.11.0 |
| GoCardless Bank Account Data | Европейски банки | Поддържан за съществуващите акаунти: GoCardless не приема нови акаунти от юли 2025 г. |
| Pluggy.ai | Бразилски банки | Поддържан |
| Enable Banking | Европейски банки | Експериментална функция |
| Akahu | Новозеландски банки | Експериментална функция |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Публичните мостове SimpleFIN не изискват никаква настройка.Всяко устройство пази пълно копие на бюджетите ви, а сървърът пази друго. Доброто резервно копие покрива и двете: папката с данни на сървъра и експорт на всеки бюджет.
| Елемент | Какво пази | За архивиране |
|---|---|---|
server-files/account.sqlite | Хешираната парола, списъка на бюджетите, сесиите, акаунтите OpenID и банковите данни за достъп | Задължително, шифровано |
user-files/ | Файловете с бюджети, като двоични файлове | Задължително |
config.json | Конфигурацията на сървъра, ако сте създали такава | Препоръчително, шифровано |
| Експортът на всеки бюджет | Zip файл с базата db.sqlite и metadata.json | Препоръчително |
Всичко, което сървърът пази, се намира в actual-data. При спрян сървър тя може да се копира наведнъж, с базите SQLite в покой:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Планирайте това копие на сървъра, шифровайте го и пазете едно другаде. Поставено на диска на сървъра, то влиза и в нощните му резервни копия.
От отворен бюджет: Settings, раздел Data, Export data. Файлът може да се пази, където пожелаете, и се отваря отново без сървър. Документацията използва този експорт, за да се върне от шифрован бюджет към нешифрован файл: той съдържа данните ви в явен вид, затова го пазете на сигурно място.
Стар бюджет дава голям експорт, защото Actual пази всяка промяна във файла. Тогава документацията съветва Reset sync, в разширените настройки, преди експорта: историята се уплътнява в един файл, а размерът рязко намалява.
На другите си устройства изберете после този бюджет в списъка с файлове: той се изтегля, после се синхронизира. Настолните приложения пазят и собствени автоматични резервни копия, по едно за всеки от последните десет дни на използване и няколко за текущия ден.
Документацията дава командата, от папката на compose.yaml. Папката с данни остава на мястото си:
docker compose pull
docker compose up -d
Версиите се номерират по година и месец: 26.11.0 излезе на 1 ноември 2026 г., а последните версии се публикуват в началото на всеки месец. Четете бележките им преди обновяване и експортирайте бюджетите си непосредствено преди това, както препоръчва документацията. Бележките отбелязват промените, които трябва да предвидите, като списъка на разрешените мрежи SimpleFIN в 26.11.0 или преминаването на образа Ubuntu към Node.js 24 в 26.9.0, което го премахна от 32-битовите процесори ARM в полза на образа Alpine.
nightly: връщането от nightly към latest може да направи бюджет нечетим за стабилната версия. Документацията описва поправката и иска резервни копия на бюджетите ви при тези етикети.Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Actual Budget остава ваш софтуер, с неговите настройки и вашите бюджети.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция |
| Actual Budget | Проактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Достъпът и бюджетите | Сървърът, който ги носи, наблюдаван и архивиран | Паролата на сървъра, OpenID, потребителите и шифроването от край до край |
| Банковата синхронизация | Сървърът, който пази данните ѝ за достъп, наблюдаван и архивиран | Изборът на доставчик, неговите ключове и свързаните сметки |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Експортите на бюджетите ви и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Actual Budget, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Actual Budget се разпространява с лиценз MIT: можете свободно да го използвате, променяте и разпространявате, за себе си или за фирма, стига бележката за авторските права и за лиценза да остава в копията. Остава цената на сървъра, на който работи.
Настолните приложения работят самостоятелно. Сървърът, който документацията настоятелно препоръчва, добавя уеб и мобилното приложение, синхронизацията между устройствата, банковата синхронизация и API. Всяко устройство пази пълно копие на бюджетите ви, синхронизирано със сървъра.
Създайте compose.yaml с образа actualbudget/actual-server, порт 5006, публикуван на 127.0.0.1, и папка с данни, монтирана на /data, после изпълнете docker compose up -d. След това поставете пред него обратен прокси с HTTPS и отворете адреса си, за да изберете паролата на сървъра.
Приложението се нуждае от SharedArrayBuffer, който браузърите включват само на страница, предоставена през HTTPS със заглавките Cross-Origin-Embedder-Policy и Cross-Origin-Opener-Policy. Сървърът поставя тези заглавки; обратният прокси осигурява HTTPS. Само достъпът през localhost минава без него.
Предоставяйте инстанцията през HTTPS, изберете силна парола на сървъра или използвайте OpenID с двуфакторно удостоверяване и включете шифроването от край до край: сървърът вече не може да чете бюджетите ви. Пазете тази втора парола на сигурно място, защото тя не може да бъде възстановена.
Да, чрез доставчик на банкови данни, с вашите собствени данни за достъп: SimpleFIN Bridge, GoCardless Bank Account Data за съществуващите акаунти, Pluggy.ai, както и Enable Banking и Akahu като експериментални функции. Синхронизацията изисква сървъра и може да работи автоматично от версия 26.11.0.
Копирайте папката с данни на сървъра при спрян сървър: server-files съдържа акаунтите и данните за достъп, user-files бюджетите. Експортирайте и всеки бюджет от Settings, Export data, и пазете тези копия шифровани. Експорт се възстановява с Import file.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.