Gostovanje Actual Budget na Managed VPS pomeni, da vaši proračuni in njihova sinhronizacija ostanejo na lastnem stroju, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. Actual Budget je orodje za osebne finance, ki podatke najprej hrani lokalno (local-first), objavljeno pod licenco MIT. Ta vodnik sledi njegovi uradni dokumentaciji: vloga strežnika, namestitev z Docker Compose, HTTPS, geslo strežnika, OpenID, šifriranje od konca do konca, bančna sinhronizacija, varnostne kopije in posodobitve.
Avtor: Simon Vasconcelos Lee
Objavljeno 17. novembra 2026Čas branja: 14 minut
SharedArrayBuffer, ki ga brskalniki vključijo le na strani, streženi prek HTTPS. Za to poskrbi obratni posredniški strežnik.docker compose pull.Actual Budget je orodje za osebne finance, ki podatke najprej hrani lokalno, napisano v Node.js, ki ga README opisuje kot povsem brezplačno in odprtokodno. Vse vaše podatke hrani na vsaki od vaših naprav in jih v ozadju sinhronizira s strežnikom, ki ste ga izbrali: aplikacija deluje tudi brez povezave, vaše spremembe pa dosežejo druge naprave, takoj ko je omrežje spet na voljo.
Projekt sestavljata odjemalec in strežnik. Strežnik je neobvezen, a ga dokumentacija močno priporoča, saj odklene več funkcij:
| Funkcija | Brez strežnika | S strežnikom |
|---|---|---|
| Proračuni, poročila, razporedi | Da | Da |
| Uvoz transakcij iz datoteke | Da | Da |
| Uvoz in izvoz datotek proračuna | Da | Da |
| Aplikacija v brskalniku in na telefonu | Da | |
| Sinhronizacija med napravami | Da | |
| Bančna sinhronizacija | Da | |
| API Actual | Da |
Actual Budget je objavljen pod licenco MIT, z avtorskimi pravicami James Long. Besedilo vsakomur, ki pridobi kopijo, brezplačno podeljuje pravico do uporabe, kopiranja, spreminjanja, združevanja, objave, razširjanja, podlicenciranja in prodaje njenih kopij.
Pogoj je en sam: obvestilo o avtorskih pravicah in besedilo licence spremljata vse kopije ali bistvene dele programske opreme. Sliko, ki jo objavi projekt, torej lahko poganjate zase, za svojo družino ali za svoje podjetje, ne da bi morali kupiti licenco.
Projekt strežnik objavlja kot sliko Docker, actualbudget/actual-server na Docker Hubu, isto sliko pa tudi v registru GitHub, ghcr.io/actualbudget/actual. Na strežniku z nameščenim Dockerjem ustvarite mapo in vanjo postavite ta compose.yaml, povzet po datoteki iz repozitorija:
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 so dosegljiva le prek obratnega posredniškega strežnika na istem strežniku, ki doda HTTPS.actual-data hrani vse, kar hrani strežnik. V njej ustvari dve podmapi, server-files in user-files, dokumentacija pa poudarja, da ta priklop ohrani vaše podatke, ko vsebnik odstranite.latest sledi zadnji uradni izdaji, dokumentacija pa jo priporoča večini uporabnikov. latest-alpine daje isto izdajo na lažji osnovi Alpine, oznaka, kot je 26.11.0, pa določi različico. Oznake nightly sledijo razvoju, z vsako spremembo njegove glavne veje.Ime vaše domene z zapisoma A in AAAA kaže na strežnik, obiskovalci pa prihajajo na vrata 80 in 443. Dokler HTTPS ni vzpostavljen, se aplikacija ne odpre: pojdite neposredno na naslednji razdelek.
Projekt ne navaja potrebnega pomnilnika ali procesorja. Velikost je odvisna od števila proračunov, njihove zgodovine in števila naprav, ki se sinhronizirajo. Na Managed VPS nam opišite svojo rabo in priporočimo vam ustrezno velikost.
Actual Budget temelji na SharedArrayBuffer, tehnologiji brskalnikov, ki jo dokumentacija opisuje kot obvezno: brez nje se aplikacija ne zažene. Brskalniki jo vključijo le na izolirani strani, kar zahteva dva pogoja:
localhost.Cross-Origin-Embedder-Policy, nastavljena na require-corp, in Cross-Origin-Opener-Policy, nastavljena na same-origin. Uradni strežnik ju vedno nastavi sam.Če želite Actual izpostaviti internetu, dokumentacija prosi, naj ga postavite za obratni posredniški strežnik s HTTPS. Strežnik lahko HTTPS streže tudi sam, s potrdilom, ki mu ga daste, prek ACTUAL_HTTPS_KEY in ACTUAL_HTTPS_CERT: dokumentacija to pot opisuje za strežnik, ki ostane zunaj interneta.
Dokumentacija Caddy predstavlja kot preprost obratni posredniški strežnik, ki sam pridobiva in obnavlja svoja potrdila. Tukaj je njen primer, prilagojen za Caddy, nameščen na strežniku:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Ta blok sledi konfiguraciji Nginx iz dokumentacije, skrajšani na vrata 80, da lahko Certbot vzpostavi HTTPS. Dve glavi, ki ju pošlje Actual, skrije in ju nastavi znova, enkrat: dokumentacija opozarja, da podvojena glava pravilnik razveljavi, aplikacija pa se nato ustavi z napako 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 odpravi omejitev velikosti v Nginxu, kot v primeru iz dokumentacije, da velika datoteka proračuna pride do strežnika. Certbot nato namesti potrdilo in poskrbi za njegovo obnavljanje:
sudo certbot --nginx
Svoj naslov odprite prek https, v novem zavihku, ne s ponovnim nalaganjem strani, ki je prikazala napako, kot svetuje dokumentacija. Pojavi se pozdravni zaslon programa Actual: HTTPS in glavi sta vzpostavljena.
Ob prvem zagonu vas pozdravni zaslon prosi, da izberete geslo strežnika: to je tisto, kar ščiti dostop do vaših proračunov. Dokler ni nastavljeno, se ta zaslon prikaže prvi osebi, ki odpre naslov. Odprite ga torej takoj, ko HTTPS deluje, in izberite dolgo geslo, ki ga uporabljate le za ta strežnik.
Strežnik to geslo hrani zgoščeno, z argon2, v datoteki account.sqlite v server-files, skupaj s seznamom datotek proračunov, ki jih pozna, in aktivnim žetonom seje.
Dokumentacija ponuja ukaz, ki nastavi novo geslo, ne da bi se dotaknil vaših datotek ali podatkov. Zahteva ga dvakrat:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: privzeto password, openid za ponudnika identitete ali header.x-actual-password. Dokumentacija opozarja, da bi napačna nastavitev v tem koraku instanco lahko odprla vsemu internetu: rezervirajte jo za te storitve.ACTUAL_ALLOWED_LOGIN_METHODS, seznamom, ločenim z vejicami.Za overjanje, trdnejše od gesla, dokumentacija priporoča ponudnika OpenID: večina jih ponuja dvostopenjsko preverjanje pristnosti. To je tudi tisto, kar strežnik odpre več uporabnikom. Konfiguracijski priročnik ta način predstavlja kot predogled.
https://budget.example.com/openid/callback.Ista konfiguracija gre lahko tudi v config.json ali v spremenljivke okolja, z URL-jem za odkrivanje, ko ga ponudnik objavlja:
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"
Skrivnost gre v datoteko .env ob compose.yaml. Od različice 26.10.0 jo lahko ACTUAL_OPENID_CLIENT_SECRET_FILE prebere tudi iz datoteke, kar ustreza skrivnostim Docker.
"authMethod": "oauth2", v config.json.ACTUAL_USER_CREATION_MODE, nastavljen na login, jih ustvari ob prvi prijavi.ACTUAL_OPENID_ENFORCE, nastavljen na true, ga naredi za edini sprejeti način prijave.ACTUAL_TOKEN_EXPIRATION je privzeto never. Lahko sledi trajanju pri ponudniku, z openid-provider, ali trajanju v sekundah.Poleg gesla strežnika je mogoče vsak proračun šifrirati od konca do konca. Njegovi podatki se nato šifrirajo na vaši napravi, s ključem, izpeljanim iz drugega gesla, preden jo zapustijo: strežnik posreduje le spremembe, ki jih ne more prebrati.
Dokumentacija je jasna: pozabljenega gesla za šifriranje ni mogoče obnoviti. Če lokalna kopija proračuna še obstaja, lahko ustvarite nov ključ, kar ponastavi sinhronizacijo. Šifriranja tudi ni mogoče izklopiti: vrnitev na nešifrirano datoteko poteka prek izvoza in nato uvoza.
| Zaščita | Kaj prinaša | Kje se nastavi |
|---|---|---|
| HTTPS | Šifrira pot med vašimi napravami in strežnikom ter omogoči zagon aplikacije | Obratni posredniški strežnik |
| Geslo strežnika | Omeji dostop do proračunov, na strežniku zgoščeno z argon2 | Ob prvem zagonu, nato v nastavitvah |
| OpenID | Dvostopenjsko preverjanje pristnosti vašega ponudnika in en račun na osebo | Pri ponudniku, nato v nastavitvah |
| Šifriranje od konca do konca | Proračune naredi neberljive za strežnik in njegove varnostne kopije | V vsakem proračunu |
| Šifriranje diska | Ščiti lokalno kopijo, ki je po navedbah dokumentacije nešifrirana | Na vsaki od vaših naprav |
Šifriranje od konca do konca pokriva podatke proračunov. Dostopni podatki za bančno sinhronizacijo se hranijo na strežniku, v account.sqlite, zunaj tega šifriranja: temu primerno zaščitite dostop do strežnika in njegovih varnostnih kopij.
Actual vaše transakcije uvozi iz datoteke, brez nastavljanja. Pridobi jih lahko tudi neposredno iz vaše banke, prek ponudnika bančnih podatkov. Ta sinhronizacija je neobvezna, potrebuje strežnik in temelji na vaših lastnih dostopnih podatkih: pri ponudniku odprete račun in tam ustvarite ključe, ki jih daste programu Actual. Ti ključi se hranijo na strežniku in jih vpišete le enkrat.
| Ponudnik | Pokrite banke, po dokumentaciji | Stanje v različici 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Severnoameriške banke | Podprto; od 26.11.0 so mogoči dostopni podatki za posamezen proračun |
| GoCardless Bank Account Data | Evropske banke | Podprto za obstoječe račune: GoCardless od julija 2025 ne sprejema novih računov |
| Pluggy.ai | Brazilske banke | Podprto |
| Enable Banking | Evropske banke | Poskusna funkcija |
| Akahu | Novozelandske banke | Poskusna funkcija |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Javni mostovi SimpleFIN ne potrebujejo nobene nastavitve.Vsaka naprava hrani popolno kopijo vaših proračunov, strežnik pa še eno. Dobra varnostna kopija pokriva oboje: mapo s podatki strežnika in izvoz vsakega proračuna.
| Element | Kaj hrani | Varnostna kopija |
|---|---|---|
server-files/account.sqlite | Zgoščeno geslo, seznam proračunov, seje, račune OpenID in bančne dostopne podatke | Obvezno, šifrirano |
user-files/ | Datoteke proračunov, kot binarne datoteke | Obvezno |
config.json | Konfiguracijo strežnika, če ste jo ustvarili | Priporočeno, šifrirano |
| Izvoz vsakega proračuna | Datoteko zip z zbirko db.sqlite in metadata.json | Priporočeno |
Vse, kar strežnik hrani, živi v actual-data. Z ustavljenim strežnikom jo je mogoče kopirati naenkrat, z zbirkami SQLite v mirovanju:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
To kopijo načrtujte na strežniku, jo šifrirajte in eno hranite drugje. Shranjena na disku strežnika vstopi tudi v njegove nočne varnostne kopije.
Iz odprtega proračuna: Settings, razdelek Data, Export data. Datoteko lahko hranite, kjer želite, in se znova odpre brez strežnika. Dokumentacija ta izvoz uporablja za vrnitev s šifriranega proračuna na nešifrirano datoteko: vaše podatke vsebuje v nešifrirani obliki, zato ga hranite na varnem.
Star proračun da velik izvoz, ker Actual vsako spremembo hrani v datoteki. Dokumentacija nato pred izvozom svetuje Reset sync v naprednih nastavitvah: zgodovina se strne v eno samo datoteko, velikost pa se močno zmanjša.
Na drugih napravah nato ta proračun izberite na seznamu datotek: prenese se in nato sinhronizira. Namizne aplikacije hranijo tudi lastne samodejne varnostne kopije, eno za vsakega od zadnjih desetih dni uporabe in več za tekoči dan.
Dokumentacija navaja ukaz, ki ga zaženete v mapi datoteke compose.yaml. Mapa s podatki ostane na mestu:
docker compose pull
docker compose up -d
Različice so oštevilčene po letu in mesecu: 26.11.0 je izšla 1. novembra 2026, zadnje izdaje pa so izhajale na začetku vsakega meseca. Pred posodobitvijo preberite njihove opombe in tik pred tem izvozite svoje proračune, kot priporoča dokumentacija. Opombe opozarjajo na spremembe, ki jih je treba predvideti, kot sta seznam dovoljenih omrežij SimpleFIN v 26.11.0 ali prehod slike Ubuntu na Node.js 24 v 26.9.0, ki jo je umaknil s 32-bitnih procesorjev ARM v korist slike Alpine.
nightly: vrnitev z nightly na latest lahko proračun naredi neberljiv za stabilno izdajo. Dokumentacija opisuje popravek in pri teh oznakah zahteva varnostne kopije vaših proračunov.Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Actual Budget ostaja vaša programska oprema, z vašimi nastavitvami in proračuni.
| Tema | Naše ekipe | Vi |
|---|---|---|
| Strežnik | Posodobitve sistema in varnosti, vključno s posegi na strežniku | Trenutek, ki ustreza vaši dejavnosti |
| Nadzor | Strežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klic | Branje dnevnikov vaše instance |
| Actual Budget | Proaktivno spremljanje: napake, upočasnitve in prostor na disku, s priporočenim popravkom | Namestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik |
| Dostopi in proračuni | Strežnik, ki jih nosi, pod nadzorom in varnostno kopiran | Geslo strežnika, OpenID, uporabniki in šifriranje od konca do konca |
| Bančna sinhronizacija | Strežnik, ki hrani njene dostopne podatke, pod nadzorom in varnostno kopiran | Izbira ponudnika, njegovi ključi in povezani računi |
| Varnostne kopije | Vsako noč, šifrirane in shranjene zunaj stroja; obnova je vključena | Izvozi vaših proračunov in zahteva za obnovo, ko jo potrebujete |
| Selitev | Selitev vašega sedanjega strežnika, brezplačno | Trenutek preklopa |
Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.
Z Managed VPS Simafri naše ekipe strežnik vaše instance Actual Budget sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.
Da. Actual Budget je objavljen pod licenco MIT: prosto ga lahko uporabljate, spreminjate in nadalje razširjate, zase ali za podjetje, če obvestilo o avtorskih pravicah in licenci ostane v kopijah. Ostane le strošek strežnika, na katerem teče.
Namizne aplikacije delujejo samostojno. Strežnik, ki ga dokumentacija močno priporoča, doda spletno in mobilno aplikacijo, sinhronizacijo med napravami, bančno sinhronizacijo in API. Vsaka naprava hrani popolno kopijo vaših proračunov, sinhronizirano s strežnikom.
Ustvarite compose.yaml s sliko actualbudget/actual-server, vrati 5006, objavljenimi na 127.0.0.1, in mapo s podatki, priklopljeno na /data, nato zaženite docker compose up -d. Pred aplikacijo nato postavite obratni posredniški strežnik s HTTPS in odprite svoj naslov, da izberete geslo strežnika.
Aplikacija potrebuje SharedArrayBuffer, ki ga brskalniki vključijo le na strani, streženi prek HTTPS z glavama Cross-Origin-Embedder-Policy in Cross-Origin-Opener-Policy. Strežnik nastavi ti glavi, obratni posredniški strežnik pa prinese HTTPS. Brez njega gre le dostop prek localhost.
Instanco strežite prek HTTPS, izberite trdno geslo strežnika ali uporabite OpenID z dvostopenjskim preverjanjem pristnosti in vključite šifriranje od konca do konca: strežnik vaših proračunov ne more več brati. To drugo geslo hranite na varnem, saj ga ni mogoče obnoviti.
Da, prek ponudnika bančnih podatkov, z vašimi lastnimi dostopnimi podatki: SimpleFIN Bridge, GoCardless Bank Account Data za obstoječe račune, Pluggy.ai ter Enable Banking in Akahu kot poskusni funkciji. Sinhronizacija potrebuje strežnik in od različice 26.11.0 lahko teče samodejno.
Z ustavljenim strežnikom kopirajte njegovo mapo s podatki: server-files hrani račune in dostopne podatke, user-files proračune. Vsak proračun izvozite tudi v Settings, Export data, te kopije pa hranite šifrirane. Izvoz se obnovi z Import file.
Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe proaktivno spremljajo tudi vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.
Simafri
Pogovorimo se o vašem projektu
Povejte nam v nekaj besedah, kaj potrebujete: hitro se vam oglasimo.
Hvala! Vaše povpraševanje je bilo poslano. Kmalu vam bomo odgovorili.
Imate raje e-pošto? Pišite nam na support@simafri.com.