Gostovanje Actual Budget na Managed VPS: vaši proračuni na vašem strežniku

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.

Simon Vasconcelos Lee Avtor: Objavljeno 17. novembra 2026Čas branja: 14 minut

Vsi vodniki

Na kratko

  1. Licenca MIT dovoljuje prosto uporabo, spreminjanje in nadaljnje razširjanje programa Actual Budget, če obvestilo o avtorskih pravicah in licenci ostane v kopijah.
  2. Strežnik sinhronizira vaše proračune med napravami in streže spletno aplikacijo: namestite ga z Docker Compose, z eno sliko in mapo s podatki.
  3. HTTPS je nujen: aplikacija potrebuje SharedArrayBuffer, ki ga brskalniki vključijo le na strani, streženi prek HTTPS. Za to poskrbi obratni posredniški strežnik.
  4. Svoj naslov odprite takoj ob prvem zagonu strežnika, da izberete geslo strežnika. OpenID doda dvostopenjsko preverjanje pristnosti vašega ponudnika in več uporabnikov.
  5. Neobvezno šifriranje od konca do konca vaše proračune naredi neberljive za strežnik. Varnostno kopirajte mapo s podatki in izvozite svoje proračune, posodabljajte pa z docker compose pull.

Kaj počne Actual Budget in kakšna je vloga njegovega strežnika

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:

FunkcijaBrez strežnikaS strežnikom
Proračuni, poročila, razporediDaDa
Uvoz transakcij iz datotekeDaDa
Uvoz in izvoz datotek proračunaDaDa
Aplikacija v brskalniku in na telefonuDa
Sinhronizacija med napravamiDa
Bančna sinhronizacijaDa
API ActualDa

Kaj dovoljuje licenca MIT

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.

Namestitev z Docker Compose

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:

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
Terminal
docker compose up -d

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.

HTTPS: pogoj za zagon aplikacije

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:

Č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.

S Caddyjem

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:

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

Z Nginxom in Certbotom

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.

Blok 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 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:

Terminal
sudo certbot --nginx

Preverjanje

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.

Geslo strežnika

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.

Ponastavitev pozabljenega gesla

Dokumentacija ponuja ukaz, ki nastavi novo geslo, ne da bi se dotaknil vaših datotek ali podatkov. Zahteva ga dvakrat:

Terminal
docker exec -it actual_server node /app/src/scripts/reset-password.js

OpenID in več uporabnikov

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.

  1. Actual registrirajte pri svojem ponudniku, z URI-jem za preusmeritev https://budget.example.com/openid/callback.
  2. V odprtem proračunu pojdite v nastavitve in kliknite Start using OpenID, nato izpolnite ponudnika, identifikator odjemalca in njegovo skrivnost.
  3. Prijavite se z OpenID. Dokumentacija opozarja, da prva oseba, ki se prijavi, postane skrbnik in lastnik strežnika, vloge pa iz vmesnika ni več mogoče spremeniti: poskrbite, da se prijavite prvi.

Ista konfiguracija gre lahko tudi v config.json ali v spremenljivke okolja, z URL-jem za odkrivanje, ko ga ponudnik objavlja:

compose.yaml, v storitvi
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.

Šifriranje od konca do konca

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.

  1. Odprite proračun, pojdite v nastavitve, razdelek Encryption, in kliknite Enable encryption.
  2. Izberite geslo, drugačno od gesla strežnika.
  3. Na vsaki drugi napravi to isto geslo vpišite enkrat, ob prvem prenosu proračuna.

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ščitaKaj prinašaKje se nastavi
HTTPSŠifrira pot med vašimi napravami in strežnikom ter omogoči zagon aplikacijeObratni posredniški strežnik
Geslo strežnikaOmeji dostop do proračunov, na strežniku zgoščeno z argon2Ob prvem zagonu, nato v nastavitvah
OpenIDDvostopenjsko preverjanje pristnosti vašega ponudnika in en račun na oseboPri ponudniku, nato v nastavitvah
Šifriranje od konca do koncaProračune naredi neberljive za strežnik in njegove varnostne kopijeV vsakem proračunu
Šifriranje diskaŠčiti lokalno kopijo, ki je po navedbah dokumentacije nešifriranaNa 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.

Bančna sinhronizacija

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.

PonudnikPokrite banke, po dokumentacijiStanje v različici 26.11.0
SimpleFIN BridgeSevernoameriške bankePodprto; od 26.11.0 so mogoči dostopni podatki za posamezen proračun
GoCardless Bank Account DataEvropske bankePodprto za obstoječe račune: GoCardless od julija 2025 ne sprejema novih računov
Pluggy.aiBrazilske bankePodprto
Enable BankingEvropske bankePoskusna funkcija
AkahuNovozelandske bankePoskusna funkcija

Varnostne kopije

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.

ElementKaj hraniVarnostna kopija
server-files/account.sqliteZgoščeno geslo, seznam proračunov, seje, račune OpenID in bančne dostopne podatkeObvezno, šifrirano
user-files/Datoteke proračunov, kot binarne datotekeObvezno
config.jsonKonfiguracijo strežnika, če ste jo ustvariliPriporočeno, šifrirano
Izvoz vsakega proračunaDatoteko zip z zbirko db.sqlite in metadata.jsonPriporočeno

Mapa strežnika

Vse, kar strežnik hrani, živi v actual-data. Z ustavljenim strežnikom jo je mogoče kopirati naenkrat, z zbirkami SQLite v mirovanju:

Terminal, v mapi datoteke compose.yaml
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.

Izvoz vsakega proračuna

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.

Obnova

  1. Zaprite odprti proračun: kliknite njegovo ime zgoraj levo, nato Switch file.
  2. Kliknite Import file, izberite Actual, nato datoteko zip izvoza.
  3. Uvoženi proračun se pojavi ob izvirniku: preverite ga, ga po potrebi preimenujte, nato izbrišite staro kopijo.

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.

Posodobitve

Dokumentacija navaja ukaz, ki ga zaženete v mapi datoteke compose.yaml. Mapa s podatki ostane na mestu:

Terminal
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.

Kdo kaj dela na Managed VPS

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.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki ustreza vaši dejavnosti
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicBranje dnevnikov vaše instance
Actual BudgetProaktivno spremljanje: napake, upočasnitve in prostor na disku, s priporočenim popravkomNamestitev, posodobitve in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
Dostopi in proračuniStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranGeslo strežnika, OpenID, uporabniki in šifriranje od konca do konca
Bančna sinhronizacijaStrežnik, ki hrani njene dostopne podatke, pod nadzorom in varnostno kopiranIzbira ponudnika, njegovi ključi in povezani računi
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaIzvozi vaših proračunov in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek 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.

Actual Budget na strežniku, ki ga vzdržujemo za vas

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.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je Actual Budget brezplačen?

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.

Ali za uporabo programa Actual Budget potrebujem strežnik?

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.

Kako namestiti Actual Budget z Docker Compose?

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.

Zakaj Actual Budget zahteva HTTPS?

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.

Kako zaščititi podatke v proračunu Actual?

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.

Ali se Actual Budget poveže z mojo banko?

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.

Kako varnostno kopirati Actual Budget?

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.

Ali Managed VPS pokriva Actual Budget?

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.

Viri in uradna dokumentacija

Stopite v stik z nami