Actual Budget talpinimas Managed VPS serveryje reiškia, kad jūsų biudžetai ir jų sinchronizavimas lieka jūsų mašinoje, kurią mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. Actual Budget yra pirmiausia vietoje veikiantis asmeninių finansų įrankis, platinamas pagal MIT licenciją. Šis gidas seka oficialią jo dokumentaciją: serverio vaidmenį, diegimą su Docker Compose, HTTPS, serverio slaptažodį, OpenID, ištisinį šifravimą, banko sinchronizavimą, atsargines kopijas ir atnaujinimus.
Autorius: Simon Vasconcelos Lee
Paskelbta 2026 m. lapkričio 17 d.Skaitymo trukmė: 14 min.
SharedArrayBuffer, kurį naršyklės įjungia tik per HTTPS teikiamame puslapyje. Tai užtikrina atvirkštinis tarpinis serveris.docker compose pull.Actual Budget yra pirmiausia vietoje veikiantis asmeninių finansų įrankis, parašytas Node.js, kurį README apibūdina kaip visiškai nemokamą ir atvirojo kodo. Jis laiko visus jūsų duomenis kiekviename jūsų įrenginyje ir fone sinchronizuoja juos su jūsų pasirinktu serveriu: programa veikia net be ryšio, o jūsų pakeitimai pasiekia kitus įrenginius, vos tik grįžta tinklas.
Projektą sudaro klientas ir serveris. Serveris nėra privalomas, tačiau dokumentacija jį primygtinai rekomenduoja, nes jis atveria kelias funkcijas:
| Funkcija | Be serverio | Su serveriu |
|---|---|---|
| Biudžetai, ataskaitos, grafikai | Taip | Taip |
| Operacijų importavimas iš failo | Taip | Taip |
| Biudžeto failų importavimas ir eksportavimas | Taip | Taip |
| Programa naršyklėje ir telefone | Taip | |
| Sinchronizavimas tarp įrenginių | Taip | |
| Banko sinchronizavimas | Taip | |
| Actual API | Taip |
Actual Budget platinamas pagal MIT licenciją, autorių teisės priklauso James Long. Tekstas kiekvienam, gavusiam kopiją, nemokamai suteikia teisę naudoti, kopijuoti, keisti, sujungti, skelbti, platinti, sublicencijuoti ir parduoti jo kopijas.
Sąlyga yra viena: autorių teisių pranešimas ir licencijos tekstas pridedami prie visų programinės įrangos kopijų ar esminių jos dalių. Todėl projekto paskelbtą atvaizdą galite paleisti sau, savo šeimai ar verslui, nieko nepirkdami dėl licencijos.
Projektas serverį skelbia kaip Docker atvaizdą, actualbudget/actual-server Docker Hub, ir tą patį atvaizdą GitHub registre, ghcr.io/actualbudget/actual. Serveryje, kuriame įdiegtas Docker, sukurkite katalogą ir įdėkite į jį šį compose.yaml, paimtą iš saugykloje pateikto failo:
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, jis pasiekiamas tik per tame pačiame serveryje esantį atvirkštinį tarpinį serverį, kuris prideda HTTPS.actual-data laiko viską, ką saugo serveris. Jis ten sukuria du pakatalogius, server-files ir user-files, o dokumentacija pabrėžia, kad šis prijungimas išsaugo jūsų duomenis pašalinus konteinerį.latest seka naujausią oficialią versiją, ir dokumentacija ją rekomenduoja daugumai naudotojų. latest-alpine pateikia tą pačią versiją lengvesniu Alpine pagrindu, o žyma, pavyzdžiui, 26.11.0, užfiksuoja versiją. Žymos nightly seka kūrimą, su kiekvienu pagrindinės šakos pakeitimu.Jūsų domeno vardas nukreipiamas į serverį A ir AAAA įrašais, o lankytojai atvyksta 80 ir 443 prievadais. Kol HTTPS neįdiegtas, programa neatsidaro: tiesiai pereikite prie kito skyriaus.
Projektas nenurodo nei atminties, nei procesoriaus dydžio. Dydis priklauso nuo biudžetų skaičiaus, jų istorijos ir sinchronizuojamų įrenginių skaičiaus. Naudojant Managed VPS, papasakokite mums, kaip ketinate naudotis, ir mes rekomenduosime tinkamą dydį.
Actual Budget remiasi SharedArrayBuffer, naršyklių technologija, kurią jo dokumentacija apibūdina kaip būtiną: be jos programa nepasileidžia. Naršyklės ją įjungia tik izoliuotame puslapyje, o tam reikia dviejų sąlygų:
localhost.Cross-Origin-Embedder-Policy su reikšme require-corp ir Cross-Origin-Opener-Policy su reikšme same-origin. Oficialus serveris jas visada nustato pats.Norint atverti Actual internetui, dokumentacija prašo jį pastatyti už atvirkštinio tarpinio serverio su HTTPS. Serveris taip pat gali pats teikti HTTPS su jam pateiktu sertifikatu, per ACTUAL_HTTPS_KEY ir ACTUAL_HTTPS_CERT: dokumentacija šį kelią aprašo serveriui, kuris lieka neprieinamas iš interneto.
Dokumentacija Caddy pristato kaip paprastą atvirkštinį tarpinį serverį, kuris pats gauna ir atnaujina sertifikatus. Štai jos pavyzdys, pritaikytas serveryje įdiegtai Caddy:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Šis blokas seka dokumentacijos Nginx konfigūraciją, sutrumpintą iki 80 prievado, kad HTTPS įdiegtų Certbot. Jis paslepia dvi Actual siunčiamas antraštes ir nustato jas iš naujo, vieną kartą: dokumentacija įspėja, kad pasikartojanti antraštė panaikina politiką, ir tada programa sustoja ties klaida 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 panaikina Nginx dydžio ribą, kaip dokumentacijos pavyzdyje, kad didelis biudžeto failas pasiektų serverį. Tada Certbot įdiegia sertifikatą ir pasirūpina jo atnaujinimu:
sudo certbot --nginx
Atverkite savo adresą per https naujame skirtuke, o ne iš naujo įkeldami klaidą rodžiusį puslapį, kaip pataria dokumentacija. Pasirodo Actual pasveikinimo ekranas: HTTPS ir antraštės veikia.
Pirmą kartą paleidus, pasveikinimo ekranas paprašo pasirinkti serverio slaptažodį: būtent jis saugo prieigą prie jūsų biudžetų. Kol jis nenustatytas, šis ekranas rodomas pirmajam žmogui, atvėrusiam adresą. Todėl atverkite jį, vos tik HTTPS veikia, ir pasirinkite ilgą, tik šiam serveriui skirtą slaptažodį.
Serveris šį slaptažodį saugo užhashuotą argon2 algoritmu, kataloge server-files esančiame faile account.sqlite, kartu su jam žinomų biudžeto failų sąrašu ir aktyvios sesijos žetonu.
Dokumentacija pateikia komandą, kuri nustato naują slaptažodį neliesdama jūsų failų ir duomenų. Ji jo paprašo du kartus:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: numatytai password, openid tapatybės teikėjui arba header.x-actual-password. Dokumentacija įspėja, kad dėl klaidingos konfigūracijos šiame žingsnyje egzempliorius galėtų tapti prieinamas visam internetui: palikite jį šioms paslaugoms.ACTUAL_ALLOWED_LOGIN_METHODS, kableliais atskirtu sąrašu.Patikimesniam nei slaptažodis autentifikavimui dokumentacija rekomenduoja OpenID teikėją: dauguma jų siūlo dviejų veiksnių autentifikavimą. Būtent tai serverį atveria ir keliems naudotojams. Konfigūracijos žinynas šį būdą pristato kaip peržiūros versiją.
https://budget.example.com/openid/callback.Tą pačią konfigūraciją taip pat galima įrašyti į config.json arba aplinkos kintamuosius, su aptikimo URL, kai teikėjas jį skelbia:
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"
Paslaptis dedama į failą .env šalia compose.yaml. Nuo 26.10.0 versijos ACTUAL_OPENID_CLIENT_SECRET_FILE ją gali nuskaityti ir iš failo, o tai tinka Docker paslaptims.
"authMethod": "oauth2" faile config.json.ACTUAL_USER_CREATION_MODE su reikšme login juos sukuria pirmojo prisijungimo metu.ACTUAL_OPENID_ENFORCE su reikšme true padaro jį vieninteliu priimamu prisijungimo būdu.ACTUAL_TOKEN_EXPIRATION numatytai yra never. Ji gali sekti teikėjo trukmę su openid-provider arba būti nurodyta sekundėmis.Be serverio slaptažodžio, kiekvieną biudžetą galima šifruoti ištisiniu šifravimu. Tada jo duomenys šifruojami jūsų įrenginyje, raktu, išvestu iš antrojo slaptažodžio, prieš jiems išeinant: serveris tik perduoda pakeitimus, kurių negali perskaityti.
Dokumentacija aiški: pamiršto šifravimo slaptažodžio atkurti neįmanoma. Jei dar yra vietinė biudžeto kopija, galite sugeneruoti naują raktą, o tai iš naujo nustato sinchronizavimą. Šifravimo išjungti taip pat negalima: grįžtama prie nešifruoto failo per eksportą, tada importą.
| Apsauga | Ką ji suteikia | Kur nustatoma |
|---|---|---|
| HTTPS | Šifruoja kelią tarp jūsų įrenginių ir serverio bei leidžia programai pasileisti | Atvirkštinis tarpinis serveris |
| Serverio slaptažodis | Riboja prieigą prie biudžetų, serveryje užhashuotas argon2 | Pirmą kartą paleidus, vėliau nustatymuose |
| OpenID | Jūsų teikėjo dviejų veiksnių autentifikavimas ir po paskyrą kiekvienam žmogui | Pas teikėją, tada nustatymuose |
| Ištisinis šifravimas | Padaro biudžetus neperskaitomus serveriui ir jo atsarginėms kopijoms | Kiekviename biudžete |
| Disko šifravimas | Apsaugo vietinę kopiją, kuri, kaip pažymi dokumentacija, nešifruota | Kiekviename jūsų įrenginyje |
Ištisinis šifravimas apima biudžeto duomenis. Banko sinchronizavimo prieigos duomenys laikomi serveryje, faile account.sqlite, už šio šifravimo ribų: atitinkamai apsaugokite prieigą prie serverio ir jo atsarginių kopijų.
Actual importuoja jūsų operacijas iš failo, be jokios sąrankos. Jis taip pat gali jas gauti tiesiai iš jūsų banko, per banko duomenų teikėją. Šis sinchronizavimas nėra privalomas, jam reikia serverio ir jis remiasi jūsų pačių prieigos duomenimis: atsidarote paskyrą pas teikėją ir ten susikuriate raktus, kuriuos pateikiate Actual. Šie raktai laikomi serveryje, o jūs juos įvedate tik vieną kartą.
| Teikėjas | Aprėpiami bankai, pagal dokumentaciją | Būsena 26.11.0 versijoje |
|---|---|---|
| SimpleFIN Bridge | Šiaurės Amerikos bankai | Palaikomas; nuo 26.11.0 galimi atskiri prieigos duomenys kiekvienam biudžetui |
| GoCardless Bank Account Data | Europos bankai | Palaikomas esamoms paskyroms: nuo 2025 m. liepos GoCardless nepriima naujų paskyrų |
| Pluggy.ai | Brazilijos bankai | Palaikomas |
| Enable Banking | Europos bankai | Eksperimentinė funkcija |
| Akahu | Naujosios Zelandijos bankai | Eksperimentinė funkcija |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Viešiems SimpleFIN tiltams jokio nustatymo nereikia.Kiekvienas įrenginys laiko visą jūsų biudžetų kopiją, o serveris dar vieną. Gera atsarginė kopija apima abi: serverio duomenų katalogą ir kiekvieno biudžeto eksportą.
| Elementas | Ką jis saugo | Ar kopijuoti |
|---|---|---|
server-files/account.sqlite | Užhashuotą slaptažodį, biudžetų sąrašą, sesijas, OpenID paskyras ir banko prieigos duomenis | Privaloma, šifruotą |
user-files/ | Biudžeto failus, dvejetainius | Privaloma |
config.json | Serverio konfigūraciją, jei ją sukūrėte | Rekomenduojama, šifruotą |
| Kiekvieno biudžeto eksportas | Zip failą su duomenų baze db.sqlite ir metadata.json | Rekomenduojama |
Viskas, ką saugo serveris, yra kataloge actual-data. Sustabdžius serverį, jį galima nukopijuoti vienu kartu, kai jo SQLite duomenų bazės ramybės būsenoje:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Suplanuokite šią kopiją serveryje, šifruokite ją ir vieną laikykite kitur. Padėta serverio diske, ji patenka ir į jo naktines atsargines kopijas.
Iš atverto biudžeto: Settings, skiltis Data, Export data. Failą galima laikyti kur norite, ir jis vėl atsidaro be serverio. Dokumentacija šį eksportą naudoja grįžti iš šifruoto biudžeto prie nešifruoto failo: jame jūsų duomenys yra atviri, todėl laikykite jį saugioje vietoje.
Senas biudžetas duoda didelį eksportą, nes Actual faile laiko kiekvieną pakeitimą. Tada dokumentacija pataria prieš eksportuojant išplėstiniuose nustatymuose paspausti Reset sync: istorija suspaudžiama į vieną failą, o dydis stipriai sumažėja.
Kituose savo įrenginiuose tada failų sąraše pasirinkite šį biudžetą: jis atsisiunčiamas, tada sinchronizuojamas. Darbalaukio programos taip pat kuria savas automatines atsargines kopijas, po vieną kiekvienai iš paskutinių dešimties naudojimo dienų ir kelias einamajai dienai.
Dokumentacija pateikia komandą, vykdomą kataloge su compose.yaml. Duomenų katalogas lieka vietoje:
docker compose pull
docker compose up -d
Versijos numeruojamos pagal metus ir mėnesį: 26.11.0 išleista 2026 m. lapkričio 1 d., o naujausios versijos skelbiamos kiekvieno mėnesio pradžioje. Prieš atnaujindami perskaitykite jų pastabas, o prieš pat tai eksportuokite savo biudžetus, kaip rekomenduoja dokumentacija. Pastabose pažymimi pakeitimai, kuriems reikia pasiruošti, pavyzdžiui, leidžiamų SimpleFIN tinklų sąrašas 26.11.0 versijoje arba Ubuntu atvaizdo perėjimas prie Node.js 24 26.9.0 versijoje, dėl kurio jis nebeteikiamas 32 bitų ARM procesoriams, o jiems skirtas Alpine atvaizdas.
nightly: grįžus iš nightly į latest, biudžetas gali tapti neperskaitomas stabiliai versijai. Dokumentacija aprašo sprendimą ir su šiomis žymomis prašo kurti biudžetų atsargines kopijas.Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Actual Budget lieka jūsų programa su savo nustatymais ir jūsų biudžetais.
| Tema | Mūsų komandos | Jūs |
|---|---|---|
| Serveris | Sistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryje | Jūsų veiklai tinkamas momentas |
| Stebėsena | Serveris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučio | Jūsų egzemplioriaus žurnalų skaitymas |
| Actual Budget | Proaktyvi stebėsena: klaidos, sulėtėjimai ir disko vieta pastebimi, rekomenduojamas pataisymas | Jo diegimas, atnaujinimai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas |
| Prieiga ir biudžetai | Juos laikantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Serverio slaptažodis, OpenID, naudotojai ir ištisinis šifravimas |
| Banko sinchronizavimas | Jo prieigos duomenis laikantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Teikėjo pasirinkimas, jo raktai ir susietos sąskaitos |
| Atsarginės kopijos | Kiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotas | Jūsų biudžetų eksportai ir atkūrimo prašymas, kai jo prireikia |
| Perkėlimas | Jūsų dabartinis serveris perkeliamas nemokamai | Perjungimo momentas |
Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.
Su Simafri Managed VPS mūsų komandos palaiko jūsų Actual Budget egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.
Taip. Actual Budget platinamas pagal MIT licenciją: jį galite laisvai naudoti, keisti ir platinti, sau ar verslui, jei kopijose išlieka jo autorių teisių ir licencijos pranešimas. Lieka tik jį vykdančio serverio kaina.
Darbalaukio programos veikia savarankiškai. Serveris, kurį dokumentacija primygtinai rekomenduoja, prideda žiniatinklio ir mobiliąją programą, sinchronizavimą tarp įrenginių, banko sinchronizavimą ir API. Kiekvienas įrenginys laiko visą jūsų biudžetų kopiją, sinchronizuojamą su serveriu.
Sukurkite compose.yaml su atvaizdu actualbudget/actual-server, 5006 prievadu, paskelbtu adresu 127.0.0.1, ir duomenų katalogu, prijungtu prie /data, tada paleiskite docker compose up -d. Po to prieš jį pastatykite HTTPS atvirkštinį tarpinį serverį ir atverkite savo adresą, kad pasirinktumėte serverio slaptažodį.
Programai reikia SharedArrayBuffer, kurį naršyklės įjungia tik per HTTPS teikiamame puslapyje su antraštėmis Cross-Origin-Embedder-Policy ir Cross-Origin-Opener-Policy. Šias antraštes nustato serveris; HTTPS suteikia atvirkštinis tarpinis serveris. Be jo apsieinama tik jungiantis per localhost.
Teikite egzempliorių per HTTPS, pasirinkite stiprų serverio slaptažodį arba naudokite OpenID su dviejų veiksnių autentifikavimu ir įjunkite ištisinį šifravimą: serveris nebegali perskaityti jūsų biudžetų. Šį antrąjį slaptažodį laikykite saugioje vietoje, nes jo atkurti neįmanoma.
Taip, per banko duomenų teikėją, su jūsų pačių prieigos duomenimis: SimpleFIN Bridge, GoCardless Bank Account Data esamoms paskyroms, Pluggy.ai, o Enable Banking ir Akahu kaip eksperimentinės funkcijos. Sinchronizavimui reikia serverio, o nuo 26.11.0 versijos jis gali vykti automatiškai.
Sustabdę serverį, nukopijuokite jo duomenų katalogą: server-files laiko paskyras ir prieigos duomenis, user-files biudžetus. Taip pat eksportuokite kiekvieną biudžetą per Settings, Export data, ir šias kopijas laikykite šifruotas. Eksportas atkuriamas su Import file.
Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.
Simafri
Pakalbėkime apie jūsų sumanymą
Pasakykite mums keliais žodžiais, ko jums reikia: greitai jums atsakome.
Ačiū! Jūsų užklausa išsiųsta. Netrukus su jumis susisieksime.
Labiau mėgstate el. paštą? Rašykite mums adresu support@simafri.com.