Actual Budgeti majutamine Managed VPS-is tähendab, et teie eelarved ja nende sünkroonimine jäävad masinasse, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. Actual Budget on kohalikkusele tuginev (local-first) isiklike rahaasjade tööriist, mis avaldatakse MIT-litsentsi all. See juhend järgib selle ametlikku dokumentatsiooni: serveri roll, paigaldus Docker Compose’iga, HTTPS, serveri parool, OpenID, otspunktkrüpteerimine, pangasünkroonimine, varukoopiad ja uuendused.
Autor: Simon Vasconcelos Lee
Avaldatud 17. novembril 2026Lugemisaeg: 14 minutit
SharedArrayBuffer-it, mille brauserid lubavad ainult HTTPS-i kaudu serveeritud lehel. Selle eest hoolitseb pöördproksi.docker compose pull.Actual Budget on Node.js-is kirjutatud kohalikkusele tuginev isiklike rahaasjade tööriist, mida selle README kirjeldab täiesti tasuta ja avatud lähtekoodiga tarkvarana. See hoiab kõiki teie andmeid igas teie seadmes ja sünkroonib neid taustal teie valitud serveriga: rakendus töötab ka ilma ühenduseta ja teie muudatused jõuavad teie teistesse seadmetesse kohe, kui võrk on tagasi.
Projekt koosneb kliendist ja serverist. Server on vabatahtlik, kuid dokumentatsioon soovitab seda tungivalt, sest see avab mitu funktsiooni:
| Funktsioon | Ilma serverita | Serveriga |
|---|---|---|
| Eelarved, aruanded, ajakavad | Jah | Jah |
| Tehingute import failist | Jah | Jah |
| Eelarvefailide import ja eksport | Jah | Jah |
| Rakendus brauseris ja telefonis | Jah | |
| Sünkroonimine seadmete vahel | Jah | |
| Pangasünkroonimine | Jah | |
| Actual API | Jah |
Actual Budget avaldatakse MIT-litsentsi all, autoriõigus James Long. Tekst annab igaühele, kes koopia saab, tasuta õiguse seda kasutada, kopeerida, muuta, ühendada, avaldada, levitada, all-litsentsida ja selle koopiaid müüa.
Tingimus on üks: autoriõiguse teade ja litsentsi tekst kaasnevad tarkvara kõigi koopiate või oluliste osadega. Seega võite projekti avaldatud tõmmist käitada enda, oma pere või ettevõtte jaoks, ilma et peaksite litsentsi ostma.
Projekt avaldab serveri Dockeri tõmmisena, Docker Hubis actualbudget/actual-server, ja sama tõmmise GitHubi registris, ghcr.io/actualbudget/actual. Looge serveris, kuhu Docker on paigaldatud, kaust ja pange sinna see compose.yaml, mis on võetud hoidlas pakutavast failist:
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 avaldatuna on see kättesaadav ainult samas serveris asuva pöördproksi kaudu, mis lisab HTTPS-i.actual-data hoiab kõike, mida server säilitab. Server loob sinna kaks alamkausta, server-files ja user-files, ning dokumentatsioon märgib, et see paigaldus säilitab teie andmed konteineri eemaldamisel.latest järgib viimast ametlikku väljalaset ja dokumentatsioon soovitab seda enamikule kasutajatele. latest-alpine annab sama väljalaske kergemal Alpine’i baasil ja silt nagu 26.11.0 fikseerib versiooni. Sildid nightly järgivad arendust, iga muudatusega selle põhiharus.Teie domeeninimi viitab serverile A- ja AAAA-kirjetega ning külastajad jõuavad portidele 80 ja 443. Kuni HTTPS pole paigas, rakendus ei avane: minge otse järgmisse jaotisse.
Projekt ei too välja mälu ega protsessori mahtu. Suurus sõltub eelarvete arvust, nende ajaloost ja sünkroonivate seadmete arvust. Managed VPS-is kirjeldage meile oma kasutust ja soovitame sobiva suuruse.
Actual Budget tugineb SharedArrayBuffer-ile, brauseritehnoloogiale, mida selle dokumentatsioon kirjeldab nõutavana: ilma selleta rakendus ei käivitu. Brauserid lubavad selle ainult isoleeritud lehel, mis nõuab kaht tingimust:
localhost kaudu avatud serverile.Cross-Origin-Embedder-Policy väärtusega require-corp ja Cross-Origin-Opener-Policy väärtusega same-origin. Ametlik server seab need alati ise.Actuali internetti avamiseks palub dokumentatsioon panna see HTTPS-iga pöördproksi taha. Server saab HTTPS-i ka ise teenindada teie antud sertifikaadiga, muutujate ACTUAL_HTTPS_KEY ja ACTUAL_HTTPS_CERT kaudu: dokumentatsioon kirjeldab seda teed serverile, mis jääb internetist eemale.
Dokumentatsioon tutvustab Caddyt lihtsa pöördproksina, mis hangib ja uuendab oma sertifikaadid ise. Siin on selle näide, kohandatud serverisse paigaldatud Caddyle:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
See plokk järgib dokumentatsiooni Nginxi konfiguratsiooni, mis on taandatud pordile 80, et Certbot saaks HTTPS-i paigaldada. See peidab Actuali saadetud kaks päist ja seab need uuesti, üks kord: dokumentatsioon hoiatab, et dubleeritud päis muudab poliitika kehtetuks ja rakendus peatub siis veaga 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 eemaldab Nginxi mahupiirangu, nagu dokumentatsiooni näites, et suur eelarvefail jõuaks serverini. Certbot paigaldab seejärel sertifikaadi ja hoolitseb selle uuendamise eest:
sudo certbot --nginx
Avage oma aadress https kaudu uuel vahekaardil, mitte veateate näidanud lehte uuesti laadides, nagu dokumentatsioon soovitab. Ilmub Actuali tervitusekraan: HTTPS ja päised on paigas.
Esimesel käivitamisel palub tervitusekraan valida serverile parooli: just see kaitseb ligipääsu teie eelarvetele. Kuni parool pole seatud, näidatakse seda ekraani esimesele inimesele, kes aadressi avab. Avage see seega kohe, kui HTTPS töötab, ja valige pikk parool, mida kasutate ainult selle serveri jaoks.
Server hoiab seda parooli räsituna, argon2-ga, kausta server-files failis account.sqlite, koos talle teada olevate eelarvefailide loendi ja aktiivse seansi märgiga.
Dokumentatsioon pakub käsku, mis seab uue parooli teie faile ega andmeid puutumata. See küsib parooli kaks korda:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: vaikimisi password, identiteedipakkuja jaoks openid või header.x-actual-password. Dokumentatsioon hoiatab, et selle sammu vale seadistus võib teha instantsi kättesaadavaks kogu internetile: jätke see nende teenuste jaoks.ACTUAL_ALLOWED_LOGIN_METHODS, komadega eraldatud loendiga.Paroolist tugevama autentimise jaoks soovitab dokumentatsioon OpenID pakkujat: enamik neist pakub kaksikautentimist. Just see avab serveri ka mitmele kasutajale. Konfiguratsiooni teatmik esitleb seda meetodit eelvaatena.
https://budget.example.com/openid/callback.Sama konfiguratsiooni saab panna ka faili config.json või keskkonnamuutujatesse, avastus-URL-iga, kui pakkuja selle avaldab:
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"
Saladus läheb faili .env, faili compose.yaml kõrvale. Alates versioonist 26.10.0 saab ACTUAL_OPENID_CLIENT_SECRET_FILE seda lugeda ka failist, mis sobib Dockeri saladustega.
"authMethod": "oauth2" failis config.json.ACTUAL_USER_CREATION_MODE väärtusel login loob nad nende esimesel sisselogimisel.ACTUAL_OPENID_ENFORCE väärtusel true teeb sellest ainsa aktsepteeritud sisselogimisviisi.ACTUAL_TOKEN_EXPIRATION on vaikimisi never. See võib järgida pakkuja oma väärtusega openid-provider või kestust sekundites.Lisaks serveri paroolile saab iga eelarvet otspunktkrüpteerida. Selle andmed krüpteeritakse siis teie seadmes, teisest paroolist tuletatud võtmega, enne kui need lahkuvad: server edastab ainult muudatusi, mida ta lugeda ei saa.
Dokumentatsioon on selge: unustatud krüpteerimisparooli ei saa taastada. Kui eelarvest on veel olemas kohalik koopia, saate luua uue võtme, mis lähtestab sünkroonimise. Krüpteerimist ei saa ka välja lülitada: tagasi krüpteerimata faili juurde jõuab ekspordi ja seejärel impordi kaudu.
| Kaitse | Mida see annab | Kus seda seadistatakse |
|---|---|---|
| HTTPS | Krüpteerib tee teie seadmete ja serveri vahel ning laseb rakendusel käivituda | Pöördproksi |
| Serveri parool | Piirab ligipääsu eelarvetele, serveris argon2-ga räsituna | Esimesel käivitamisel, seejärel sätetes |
| OpenID | Teie pakkuja kaksikautentimine ja üks konto inimese kohta | Pakkuja juures, seejärel sätetes |
| Otspunktkrüpteerimine | Muudab eelarved serverile ja selle varukoopiatele loetamatuks | Igas eelarves |
| Ketta krüpteerimine | Kaitseb kohalikku koopiat, mis dokumentatsiooni järgi on krüpteerimata | Igas teie seadmes |
Otspunktkrüpteerimine katab eelarve andmed. Pangasünkroonimise juurdepääsuandmeid hoitakse serveris failis account.sqlite, sellest krüpteerimisest väljaspool: kaitske ligipääsu serverile ja selle varukoopiatele vastavalt.
Actual impordib teie tehingud failist, ilma seadistamiseta. See oskab neid ka otse teie pangast tuua, pangaandmete pakkuja kaudu. See sünkroonimine on vabatahtlik, vajab serverit ja tugineb teie enda juurdepääsuandmetele: avate pakkuja juures konto ja loote seal võtmed, mille annate Actualile. Neid võtmeid hoitakse serveris ja sisestate need ainult üks kord.
| Pakkuja | Kaetud pangad dokumentatsiooni järgi | Olek versioonis 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Põhja-Ameerika pangad | Toetatud; alates versioonist 26.11.0 on võimalikud eelarvepõhised juurdepääsuandmed |
| GoCardless Bank Account Data | Euroopa pangad | Toetatud olemasolevatele kontodele: GoCardless ei ole alates 2025. aasta juulist uusi kontosid vastu võtnud |
| Pluggy.ai | Brasiilia pangad | Toetatud |
| Enable Banking | Euroopa pangad | Eksperimentaalne funktsioon |
| Akahu | Uus-Meremaa pangad | Eksperimentaalne funktsioon |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Avalikud SimpleFIN-sillad ei vaja sätet.Iga seade hoiab teie eelarvetest täielikku koopiat ja server hoiab veel ühte. Hea varukoopia katab mõlemad: serveri andmekausta ja iga eelarve ekspordi.
| Element | Mida see hoiab | Varundada |
|---|---|---|
server-files/account.sqlite | Räsitud parool, eelarvete loend, seansid, OpenID kontod ja panga juurdepääsuandmed | Kohustuslik, krüpteeritult |
user-files/ | Eelarvefailid binaarfailidena | Kohustuslik |
config.json | Serveri konfiguratsioon, kui olete selle loonud | Soovitatav, krüpteeritult |
| Iga eelarve eksport | Zip-fail andmebaasiga db.sqlite ja failiga metadata.json | Soovitatav |
Kõik, mida server hoiab, asub kaustas actual-data. Peatatud serveriga saab selle korraga kopeerida, selle SQLite’i andmebaasid puhkeolekus:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Ajastage see koopia serveris, krüpteerige see ja hoidke üht mujal. Serveri kettal hoituna jõuab see ka selle öistesse varukoopiatesse.
Avatud eelarvest: Settings, jaotis Data, Export data. Faili saab hoida, kus soovite, ja see avaneb uuesti ka ilma serverita. Dokumentatsioon kasutab seda eksporti, et minna krüpteeritud eelarvelt tagasi krüpteerimata failile: see sisaldab teie andmeid avatekstina, seega hoidke seda turvalises kohas.
Vana eelarve annab suure ekspordi, sest Actual hoiab failis iga muudatust. Dokumentatsioon soovitab siis enne eksportimist täpsemates sätetes valikut Reset sync: ajalugu tihendatakse üheks failiks ja maht väheneb tunduvalt.
Valige seejärel oma teistes seadmetes see eelarve failide loendist: see laaditakse alla ja sünkroonitakse. Töölauarakendused hoiavad ka oma automaatseid varukoopiaid, ühe iga viimase kümne kasutuspäeva kohta ja mitu jooksva päeva kohta.
Dokumentatsioon annab käsu, mida käivitatakse kaustast, kus asub compose.yaml. Andmekaust jääb paigale:
docker compose pull
docker compose up -d
Versioonid nummerdatakse aasta ja kuu järgi: 26.11.0 ilmus 1. novembril 2026 ja viimased väljalasked on avaldatud iga kuu alguses. Lugege nende märkmed enne uuendamist läbi ja eksportige oma eelarved vahetult enne, nagu dokumentatsioon soovitab. Märkmed toovad esile muudatused, millega arvestada, näiteks lubatud SimpleFIN-võrkude loendi versioonis 26.11.0 või Ubuntu tõmmise ülemineku Node.js 24-le versioonis 26.9.0, mis eemaldas selle 32-bitistelt ARM-protsessoritelt Alpine’i tõmmise kasuks.
nightly: üleminek sildilt nightly tagasi sildile latest võib jätta eelarve stabiilsele väljalaskele loetamatuks. Dokumentatsioon kirjeldab parandust ja palub nende siltidega oma eelarvetest varukoopiaid.Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; Actual Budget jääb teie tarkvaraks oma sätete ja teie eelarvetega.
| Teema | Meie meeskonnad | Teie |
|---|---|---|
| Server | Süsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatud | Hetk, mis sobib teie tegevusele |
| Seire | Serverit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamata | Teie instantsi logide lugemine |
| Actual Budget | Proaktiivne jälgimine: vead, aeglus ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Ligipääs ja eelarved | Neid kandev server, jälgitud ja varundatud | Serveri parool, OpenID, kasutajad ja otspunktkrüpteerimine |
| Pangasünkroonimine | Selle juurdepääsuandmeid hoidev server, jälgitud ja varundatud | Pakkuja valik, selle võtmed ja ühendatud kontod |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | Teie eelarvete ekspordid ja taastamistaotlus, kui seda vajate |
| Üleviimine | Teie praeguse serveri üleviimine, tasuta | Ümberlülitamise hetk |
Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.
Simafri Managed VPS-iga hoiavad meie meeskonnad teie Actual Budgeti instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.
Jah. Actual Budget avaldatakse MIT-litsentsi all: võite seda vabalt kasutada, muuta ja edasi levitada, enda või ettevõtte jaoks, tingimusel et selle autoriõiguse ja litsentsi teade jääb koopiatesse. Jääb ainult seda käitava serveri hind.
Töölauarakendused töötavad iseseisvalt. Server, mida dokumentatsioon tungivalt soovitab, lisab veebi- ja mobiilirakenduse, sünkroonimise seadmete vahel, pangasünkroonimise ja API. Iga seade hoiab teie eelarvetest täielikku koopiat, mis on serveriga sünkroonitud.
Looge compose.yaml tõmmisega actualbudget/actual-server, aadressil 127.0.0.1 avaldatud pordiga 5006 ja kaustaga /data paigaldatud andmekaustaga ning käivitage docker compose up -d. Pange seejärel selle ette HTTPS-iga pöördproksi ja avage oma aadress, et valida serveri parool.
Rakendus vajab SharedArrayBufferit, mille brauserid lubavad ainult HTTPS-i kaudu serveeritud lehel koos päistega Cross-Origin-Embedder-Policy ja Cross-Origin-Opener-Policy. Server seab need päised; pöördproksi toob HTTPS-i. Ainult ligipääs aadressi localhost kaudu saab ilma selleta hakkama.
Teenindage instantsi HTTPS-iga, valige tugev serveri parool või kasutage OpenID-d kaksikautentimisega ja lülitage sisse otspunktkrüpteerimine: server ei saa teie eelarveid enam lugeda. Hoidke seda teist parooli turvalises kohas, sest seda ei saa taastada.
Jah, pangaandmete pakkuja kaudu, teie enda juurdepääsuandmetega: SimpleFIN Bridge, GoCardless Bank Account Data olemasolevatele kontodele, Pluggy.ai ning eksperimentaalsete funktsioonidena Enable Banking ja Akahu. Sünkroonimine vajab serverit ja võib alates versioonist 26.11.0 toimuda automaatselt.
Kopeerige serveri andmekaust peatatud serveriga: server-files hoiab kontosid ja juurdepääsuandmeid, user-files eelarveid. Eksportige ka iga eelarve valikuga Settings, Export data ja hoidke neid koopiaid krüpteeritult. Eksport taastatakse valikuga Import file.
Managed VPS katab serveri: süsteem, turvalisus, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.
Simafri
Räägime teie kavatsusest
Öelge meile paari sõnaga, mida vajate: vastame teile kiiresti.
Aitäh! Teie päring on saadetud. Võtame teiega peagi ühendust.
Eelistate e-posti? Kirjutage meile aadressil support@simafri.com.