Actual Budgeti majutamine Managed VPS-is: teie eelarved teie enda serveris

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.

Simon Vasconcelos Lee Autor: Avaldatud 17. novembril 2026Lugemisaeg: 14 minutit

Kõik juhendid

Lühidalt

  1. MIT-litsents lubab Actual Budgetit vabalt kasutada, muuta ja edasi levitada, tingimusel et selle autoriõiguse ja litsentsi teade jääb koopiatesse.
  2. Server sünkroonib teie eelarved teie seadmete vahel ja serveerib veebirakendust: paigaldage see Docker Compose’iga, üks tõmmis ja andmekaust.
  3. HTTPS on hädavajalik: rakendus vajab SharedArrayBuffer-it, mille brauserid lubavad ainult HTTPS-i kaudu serveeritud lehel. Selle eest hoolitseb pöördproksi.
  4. Avage oma aadress kohe pärast serveri esimest käivitamist, et valida serveri parool. OpenID lisab teie pakkuja kaksikautentimise ja mitu kasutajat.
  5. Valikuline otspunktkrüpteerimine muudab teie eelarved serverile loetamatuks. Varundage andmekaust ja eksportige oma eelarved ning uuendage seejärel käsuga docker compose pull.

Mida Actual Budget teeb ja milline on selle serveri roll

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:

FunktsioonIlma serveritaServeriga
Eelarved, aruanded, ajakavadJahJah
Tehingute import failistJahJah
Eelarvefailide import ja eksportJahJah
Rakendus brauseris ja telefonisJah
Sünkroonimine seadmete vahelJah
PangasünkroonimineJah
Actual APIJah

Mida MIT-litsents lubab

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.

Paigaldus Docker Compose’iga

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:

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

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.

HTTPS: rakenduse käivitumise tingimus

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:

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.

Caddy-ga

Dokumentatsioon tutvustab Caddyt lihtsa pöördproksina, mis hangib ja uuendab oma sertifikaadid ise. Siin on selle näide, kohandatud serverisse paigaldatud Caddyle:

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

Nginxi ja Certbotiga

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.

Nginxi plokk
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:

Terminal
sudo certbot --nginx

Kontrollimine

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.

Serveri parool

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.

Unustatud parooli lähtestamine

Dokumentatsioon pakub käsku, mis seab uue parooli teie faile ega andmeid puutumata. See küsib parooli kaks korda:

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

OpenID ja mitu kasutajat

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.

  1. Registreerige Actual oma pakkuja juures, ümbersuunamise URI-ga https://budget.example.com/openid/callback.
  2. Minge avatud eelarves sätetesse ja klõpsake Start using OpenID, seejärel täitke pakkuja, kliendi ID ja selle saladus.
  3. Logige sisse OpenID-ga. Dokumentatsioon hoiatab, et esimene sisselogija saab serveri administraatoriks ja omanikuks, rolliks, mida liidesest enam muuta ei saa: veenduge, et logite sisse esimesena.

Sama konfiguratsiooni saab panna ka faili config.json või keskkonnamuutujatesse, avastus-URL-iga, kui pakkuja selle avaldab:

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

Otspunktkrüpteerimine

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.

  1. Avage eelarve, minge sätetesse, jaotisse Encryption, ja klõpsake Enable encryption.
  2. Valige serveri paroolist erinev parool.
  3. Sisestage igas teises seadmes see sama parool üks kord, eelarve esimesel allalaadimisel.

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.

KaitseMida see annabKus seda seadistatakse
HTTPSKrüpteerib tee teie seadmete ja serveri vahel ning laseb rakendusel käivitudaPöördproksi
Serveri paroolPiirab ligipääsu eelarvetele, serveris argon2-ga räsitunaEsimesel käivitamisel, seejärel sätetes
OpenIDTeie pakkuja kaksikautentimine ja üks konto inimese kohtaPakkuja juures, seejärel sätetes
OtspunktkrüpteerimineMuudab eelarved serverile ja selle varukoopiatele loetamatuksIgas eelarves
Ketta krüpteerimineKaitseb kohalikku koopiat, mis dokumentatsiooni järgi on krüpteerimataIgas 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.

Pangasünkroonimine

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.

PakkujaKaetud pangad dokumentatsiooni järgiOlek versioonis 26.11.0
SimpleFIN BridgePõhja-Ameerika pangadToetatud; alates versioonist 26.11.0 on võimalikud eelarvepõhised juurdepääsuandmed
GoCardless Bank Account DataEuroopa pangadToetatud olemasolevatele kontodele: GoCardless ei ole alates 2025. aasta juulist uusi kontosid vastu võtnud
Pluggy.aiBrasiilia pangadToetatud
Enable BankingEuroopa pangadEksperimentaalne funktsioon
AkahuUus-Meremaa pangadEksperimentaalne funktsioon

Varukoopiad

Iga seade hoiab teie eelarvetest täielikku koopiat ja server hoiab veel ühte. Hea varukoopia katab mõlemad: serveri andmekausta ja iga eelarve ekspordi.

ElementMida see hoiabVarundada
server-files/account.sqliteRäsitud parool, eelarvete loend, seansid, OpenID kontod ja panga juurdepääsuandmedKohustuslik, krüpteeritult
user-files/Eelarvefailid binaarfailidenaKohustuslik
config.jsonServeri konfiguratsioon, kui olete selle loonudSoovitatav, krüpteeritult
Iga eelarve eksportZip-fail andmebaasiga db.sqlite ja failiga metadata.jsonSoovitatav

Serveri kaust

Kõik, mida server hoiab, asub kaustas actual-data. Peatatud serveriga saab selle korraga kopeerida, selle SQLite’i andmebaasid puhkeolekus:

Terminal, compose.yaml-i kaustas
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.

Iga eelarve eksport

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.

Taastamine

  1. Sulgege avatud eelarve: klõpsake selle nimel üleval vasakul ja seejärel Switch file.
  2. Klõpsake Import file, valige Actual ja seejärel ekspordi zip-fail.
  3. Imporditud eelarve ilmub originaali kõrvale: kontrollige seda, nimetage vajadusel ümber ja kustutage seejärel vana koopia.

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.

Uuendused

Dokumentatsioon annab käsu, mida käivitatakse kaustast, kus asub compose.yaml. Andmekaust jääb paigale:

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

Kes mida teeb Managed VPS-is

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.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudHetk, mis sobib teie tegevusele
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie instantsi logide lugemine
Actual BudgetProaktiivne jälgimine: vead, aeglus ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused ja sätted, mille rakendate teie või teie tehisintellekti assistent
Ligipääs ja eelarvedNeid kandev server, jälgitud ja varundatudServeri parool, OpenID, kasutajad ja otspunktkrüpteerimine
PangasünkroonimineSelle juurdepääsuandmeid hoidev server, jälgitud ja varundatudPakkuja valik, selle võtmed ja ühendatud kontod
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubTeie eelarvete ekspordid ja taastamistaotlus, kui seda vajate
ÜleviimineTeie 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.

Actual Budget teie eest hoitud serveris

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.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas Actual Budget 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.

Kas Actual Budgeti kasutamiseks on vaja serverit?

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.

Kuidas paigaldada Actual Budget Docker Compose’iga?

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.

Miks nõuab Actual Budget HTTPS-i?

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.

Kuidas kaitsta Actuali eelarve andmeid?

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.

Kas Actual Budget ühendub minu pangaga?

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.

Kuidas Actual Budgetit varundada?

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.

Kas Managed VPS katab Actual Budgeti?

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.

Allikad ja ametlik dokumentatsioon

Võtke meiega ühendust