Хостване на Actual Budget на Managed VPS: бюджетите ви на ваш сървър

Хостването на Actual Budget на Managed VPS означава бюджетите ви и тяхната синхронизация да остават на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Actual Budget е инструмент за лични финанси, който работи първо локално, разпространяван с лиценз MIT. Това ръководство следва официалната му документация: ролята на сървъра, инсталиране с Docker Compose, HTTPS, паролата на сървъра, OpenID, шифроването от край до край, банковата синхронизация, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 17 ноември 2026 г.Време за четене: 14 минути

Всички ръководства

Накратко

  1. Лицензът MIT позволява свободно да използвате, променяте и разпространявате Actual Budget, стига бележката за авторските права и за лиценза да остава в копията.
  2. Сървърът синхронизира бюджетите ви между устройствата ви и предоставя уеб приложението: инсталирайте го с Docker Compose, един образ и една папка с данни.
  3. HTTPS е задължителен: приложението се нуждае от SharedArrayBuffer, който браузърите включват само на страница, предоставена през HTTPS. Обратен прокси се грижи за това.
  4. Отворете адреса си веднага при първото стартиране на сървъра, за да изберете паролата на сървъра. OpenID добавя двуфакторното удостоверяване на вашия доставчик и няколко потребители.
  5. Незадължителното шифроване от край до край прави бюджетите ви нечетими за сървъра. Архивирайте папката с данни и експортирайте бюджетите си, после обновявайте с docker compose pull.

Какво прави Actual Budget и каква е ролята на неговия сървър

Actual Budget е инструмент за лични финанси, който работи първо локално, написан на Node.js, а README го описва като изцяло безплатен и с отворен код. Той пази всички ваши данни на всяко от устройствата ви и ги синхронизира във фонов режим със сървъра, който сте избрали: приложението работи дори без връзка, а промените ви стигат до другите ви устройства веднага щом мрежата се върне.

Проектът се състои от клиент и сървър. Сървърът не е задължителен, но документацията настоятелно го препоръчва, защото отключва няколко функции:

ФункцияБез сървърСъс сървър
Бюджети, отчети, графициДаДа
Импортиране на транзакции от файлДаДа
Импортиране и експортиране на файлове с бюджетиДаДа
Приложението в браузър и на телефонДа
Синхронизация между устройстватаДа
Банкова синхронизацияДа
API на ActualДа

Какво позволява лицензът MIT

Actual Budget се разпространява с лиценза MIT, с авторски права на James Long. Текстът дава безплатно на всеки, който получи копие, правото да използва, копира, променя, слива, публикува, разпространява, преотстъпва и продава копия от него.

Има едно условие: бележката за авторските права и текстът на лиценза придружават всички копия или съществени части на софтуера. Можете следователно да пускате образа, публикуван от проекта, за себе си, семейството или фирмата си, без да купувате лиценз.

Инсталиране с Docker Compose

Проектът публикува сървъра като Docker образ, actualbudget/actual-server в Docker Hub, и същия образ в регистъра на GitHub, ghcr.io/actualbudget/actual. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, взет от файла, предоставен в хранилището:

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

Името на домейна ви сочи към сървъра със записи A и AAAA, а посетителите пристигат на портове 80 и 443. Докато HTTPS не е на мястото си, приложението не се отваря: преминете направо към следващия раздел.

Проектът не дава числа за паметта и процесора. Размерът зависи от броя на бюджетите, тяхната история и броя на устройствата, които се синхронизират. На Managed VPS ни опишете как го използвате и ще ви препоръчаме подходящия размер.

HTTPS: условие, за да стартира приложението

Actual Budget разчита на SharedArrayBuffer, технология на браузъра, която документацията му описва като задължителна: без нея приложението не стартира. Браузърите я включват само на изолирана страница, което изисква две условия:

За да изложите Actual в интернет, документацията моли да го поставите зад обратен прокси с HTTPS. Сървърът може и сам да предоставя HTTPS със сертификат, който му дадете, чрез ACTUAL_HTTPS_KEY и ACTUAL_HTTPS_CERT: документацията описва този път за сървър, който остава извън интернет.

С Caddy

Документацията представя Caddy като лесен обратен прокси, който сам получава и подновява сертификатите си. Ето нейния пример, адаптиран за Caddy, инсталиран на сървъра:

Caddyfile
budget.example.com {
    encode gzip zstd
    reverse_proxy 127.0.0.1:5006
}

С Nginx и Certbot

Този блок следва конфигурацията за Nginx от документацията, сведена до порт 80, за да остави на Certbot да постави HTTPS. Той скрива двете заглавки, изпратени от Actual, и ги поставя отново, веднъж: документацията предупреждава, че дублирана заглавка обезсилва политиката, и тогава приложението спира с грешката SharedArrayBufferMissing.

Блок на Nginx
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

OpenID и няколко потребители

За удостоверяване, по-надеждно от парола, документацията препоръчва доставчик на OpenID: повечето от тях предлагат двуфакторно удостоверяване. Това е и начинът да отворите сървъра за няколко потребители. Справочникът за конфигурацията представя този метод като предварителна версия.

  1. Регистрирайте Actual при доставчика си, с адрес за пренасочване https://budget.example.com/openid/callback.
  2. В отворен бюджет отидете в настройките и щракнете върху Start using OpenID, после попълнете доставчика, идентификатора на клиента и неговата тайна.
  3. Влезте с OpenID. Документацията предупреждава, че първият, който влезе, става администратор и собственик на сървъра, роля, която вече не може да се смени от интерфейса: погрижете се да влезете първи.

Същата конфигурация може да отиде и в config.json или в променливи на средата, с адрес за откриване, когато доставчикът публикува такъв:

compose.yaml, в услугата
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.

Шифроване от край до край

Освен паролата на сървъра всеки бюджет може да бъде шифрован от край до край. Тогава данните му се шифроват на вашето устройство, с ключ, изведен от втора парола, преди да го напуснат: сървърът само предава промени, които не може да прочете.

  1. Отворете бюджета, отидете в настройките, раздел Encryption, и щракнете върху Enable encryption.
  2. Изберете парола, различна от паролата на сървъра.
  3. На всяко друго устройство въведете същата парола веднъж, при първото изтегляне на бюджета.

Документацията е категорична: забравена парола за шифроване не може да бъде възстановена. Ако все още съществува локално копие на бюджета, можете да генерирате нов ключ, което нулира синхронизацията. Шифроването не може и да се изключи: връщането към нешифрован файл минава през експорт, после импорт.

ЗащитаКакво даваКъде се настройва
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Новозеландски банкиЕкспериментална функция

Резервните копия

Всяко устройство пази пълно копие на бюджетите ви, а сървърът пази друго. Доброто резервно копие покрива и двете: папката с данни на сървъра и експорт на всеки бюджет.

ЕлементКакво пазиЗа архивиране
server-files/account.sqliteХешираната парола, списъка на бюджетите, сесиите, акаунтите OpenID и банковите данни за достъпЗадължително, шифровано
user-files/Файловете с бюджети, като двоични файловеЗадължително
config.jsonКонфигурацията на сървъра, ако сте създали такаваПрепоръчително, шифровано
Експортът на всеки бюджетZip файл с базата db.sqlite и metadata.jsonПрепоръчително

Папката на сървъра

Всичко, което сървърът пази, се намира в actual-data. При спрян сървър тя може да се копира наведнъж, с базите SQLite в покой:

Терминал, в папката на compose.yaml
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Планирайте това копие на сървъра, шифровайте го и пазете едно другаде. Поставено на диска на сървъра, то влиза и в нощните му резервни копия.

Експортът на всеки бюджет

От отворен бюджет: Settings, раздел Data, Export data. Файлът може да се пази, където пожелаете, и се отваря отново без сървър. Документацията използва този експорт, за да се върне от шифрован бюджет към нешифрован файл: той съдържа данните ви в явен вид, затова го пазете на сигурно място.

Стар бюджет дава голям експорт, защото Actual пази всяка промяна във файла. Тогава документацията съветва Reset sync, в разширените настройки, преди експорта: историята се уплътнява в един файл, а размерът рязко намалява.

Възстановяване

  1. Затворете отворения бюджет: щракнете върху името му горе вляво, после върху Switch file.
  2. Щракнете върху Import file, изберете Actual, после zip файла на експорта.
  3. Импортираният бюджет се появява до оригинала: проверете го, преименувайте го при нужда, после изтрийте старото копие.

На другите си устройства изберете после този бюджет в списъка с файлове: той се изтегля, после се синхронизира. Настолните приложения пазят и собствени автоматични резервни копия, по едно за всеки от последните десет дни на използване и няколко за текущия ден.

Обновленията

Документацията дава командата, от папката на 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.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Actual Budget остава ваш софтуер, с неговите настройки и вашите бюджети.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция
Actual BudgetПроактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
Достъпът и бюджетитеСървърът, който ги носи, наблюдаван и архивиранПаролата на сървъра, OpenID, потребителите и шифроването от край до край
Банковата синхронизацияСървърът, който пази данните ѝ за достъп, наблюдаван и архивиранИзборът на доставчик, неговите ключове и свързаните сметки
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноЕкспортите на бюджетите ви и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Actual Budget, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Actual Budget, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Actual Budget?

Да. Actual Budget се разпространява с лиценз MIT: можете свободно да го използвате, променяте и разпространявате, за себе си или за фирма, стига бележката за авторските права и за лиценза да остава в копията. Остава цената на сървъра, на който работи.

Нужен ли е сървър, за да използвам Actual Budget?

Настолните приложения работят самостоятелно. Сървърът, който документацията настоятелно препоръчва, добавя уеб и мобилното приложение, синхронизацията между устройствата, банковата синхронизация и API. Всяко устройство пази пълно копие на бюджетите ви, синхронизирано със сървъра.

Как се инсталира Actual Budget с Docker Compose?

Създайте compose.yaml с образа actualbudget/actual-server, порт 5006, публикуван на 127.0.0.1, и папка с данни, монтирана на /data, после изпълнете docker compose up -d. След това поставете пред него обратен прокси с HTTPS и отворете адреса си, за да изберете паролата на сървъра.

Защо Actual Budget изисква HTTPS?

Приложението се нуждае от SharedArrayBuffer, който браузърите включват само на страница, предоставена през HTTPS със заглавките Cross-Origin-Embedder-Policy и Cross-Origin-Opener-Policy. Сървърът поставя тези заглавки; обратният прокси осигурява HTTPS. Само достъпът през localhost минава без него.

Как се защитават данните в бюджет на Actual?

Предоставяйте инстанцията през HTTPS, изберете силна парола на сървъра или използвайте OpenID с двуфакторно удостоверяване и включете шифроването от край до край: сървърът вече не може да чете бюджетите ви. Пазете тази втора парола на сигурно място, защото тя не може да бъде възстановена.

Свързва ли се Actual Budget с банката ми?

Да, чрез доставчик на банкови данни, с вашите собствени данни за достъп: SimpleFIN Bridge, GoCardless Bank Account Data за съществуващите акаунти, Pluggy.ai, както и Enable Banking и Akahu като експериментални функции. Синхронизацията изисква сървъра и може да работи автоматично от версия 26.11.0.

Как се архивира Actual Budget?

Копирайте папката с данни на сървъра при спрян сървър: server-files съдържа акаунтите и данните за достъп, user-files бюджетите. Експортирайте и всеки бюджет от Settings, Export data, и пазете тези копия шифровани. Експорт се възстановява с Import file.

Покрива ли Managed VPS Actual Budget?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Хостване на Vaultwarden на Managed VPS: паролите ви на ваш сървърХостването на Vaultwarden на Managed VPS означава да пазите своите пароли и тези на екипа си на своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Vaultwarden е свободен софтуер с лиценз AGPL-3.0. Това ръководство следва официалната му документация: инсталиране с Docker Compose, HTTPS, затваряне на регистрациите, администраторски токен, какво защитава трезора, база данни, имейли, резервни копия и обновления.
Свържете се с нас