Actual Budget hosztolása Managed VPS-en: költségvetései a saját szerverén

Az Actual Budget hosztolása Managed VPS-en azt jelenti, hogy költségvetései és azok szinkronizálása egy saját gépen maradnak, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. Az Actual Budget helyi adattárolásra épülő (local-first) személyes pénzügyi eszköz, amely MIT licenc alatt jelenik meg. Ez az útmutató a hivatalos dokumentációját követi: a szerver szerepét, a telepítést Docker Compose-zal, a HTTPS-t, a szerverjelszót, az OpenID-t, a végpontok közötti titkosítást, a banki szinkronizálást, a mentéseket és a frissítéseket.

Simon Vasconcelos Lee Szerző: Közzétéve 2026. november 17-énOlvasási idő: 14 perc

Minden útmutató

A lényeg röviden

  1. Az MIT licenc szabadon engedi az Actual Budget használatát, módosítását és továbbterjesztését, feltéve, hogy a szerzői jogi és licencmegjegyzése a másolatokban marad.
  2. A szerver szinkronizálja a költségvetéseit az eszközei között, és kiszolgálja a webes alkalmazást: telepítse Docker Compose-zal, egy image-gel és egy adatmappával.
  3. A HTTPS elengedhetetlen: az alkalmazásnak szüksége van a SharedArrayBuffer funkcióra, amelyet a böngészők csak HTTPS-en kiszolgált oldalon kapcsolnak be. Ezt egy fordított proxy biztosítja.
  4. A szerver első indulásakor azonnal nyissa meg a címét, hogy megválassza a szerverjelszót. Az OpenID a szolgáltatója kétlépcsős hitelesítését és több felhasználó kezelését adja hozzá.
  5. A nem kötelező, végpontok közötti titkosítás a szerver számára olvashatatlanná teszi a költségvetéseit. Mentse az adatmappát és exportálja a költségvetéseit, majd frissítsen a docker compose pull paranccsal.

Mit tud az Actual Budget, és mi a szerver szerepe

Az Actual Budget Node.js-ben írt, helyi adattárolásra épülő személyes pénzügyi eszköz, amelyet a README teljesen ingyenesnek és nyílt forráskódúnak ír le. Minden adatát mindegyik eszközén tárolja, és a háttérben szinkronizálja az Ön által választott szerverrel: az alkalmazás kapcsolat nélkül is működik, a módosításai pedig a hálózat visszatértével azonnal eljutnak a többi eszközére.

A projekt egy kliensből és egy szerverből áll. A szerver nem kötelező, de a dokumentáció határozottan ajánlja, mert több funkciót is elérhetővé tesz:

FunkcióSzerver nélkülSzerverrel
Költségvetések, jelentések, ütemezésekIgenIgen
Tranzakciók importálása fájlbólIgenIgen
Költségvetési fájlok importálása és exportálásaIgenIgen
Az alkalmazás böngészőben és telefononIgen
Szinkronizálás az eszközök közöttIgen
Banki szinkronizálásIgen
Az Actual APIIgen

Mit enged meg az MIT licenc

Az Actual Budget az MIT licenc alatt jelenik meg, James Long szerzői jogával. A szöveg mindenkinek, aki másolatot szerez belőle, ingyenesen biztosítja a használat, másolás, módosítás, egyesítés, közzététel, terjesztés, allicencbe adás és a másolatok értékesítésének jogát.

Egyetlen feltétel van: a szerzői jogi megjegyzés és a licenc szövege kíséri a szoftver minden másolatát vagy lényeges részét. A projekt által közzétett image-et tehát futtathatja saját magának, a családjának vagy a vállalkozásának, licenc vásárlása nélkül.

Telepítés Docker Compose-zal

A projekt a szervert Docker image-ként teszi közzé, a Docker Hubon actualbudget/actual-server néven, és ugyanezt az image-et a GitHub tárhelyén is, ghcr.io/actualbudget/actual néven. Egy olyan szerveren, ahol a Docker telepítve van, hozzon létre egy mappát, és helyezze bele ezt a compose.yaml fájlt, amely a tárolóban közzétett fájlból származik:

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
Terminál
docker compose up -d

A domainnévnek A és AAAA rekordokkal a szerverre kell mutatnia, a látogatók pedig a 80-as és a 443-as porton érkeznek. Amíg a HTTPS nincs a helyén, az alkalmazás nem nyílik meg: lépjen egyenesen a következő szakaszra.

A projekt nem ad meg memória- és processzorigényt. A méret a költségvetések számától, az előzményeiktől és a szinkronizáló eszközök számától függ. Egy Managed VPS esetén írja le nekünk a használatát, és mi azt a méretet javasoljuk, amely megfelel.

HTTPS: az alkalmazás indulásának feltétele

Az Actual Budget a SharedArrayBuffer funkcióra épül, egy olyan böngészőtechnológiára, amelyet a dokumentációja kötelezőnek ír le: nélküle az alkalmazás nem indul el. A böngészők csak elszigetelt oldalon kapcsolják be, amihez két feltétel szükséges:

Az Actual internetes elérhetővé tételéhez a dokumentáció azt kéri, hogy helyezze HTTPS-t használó fordított proxy mögé. A szerver maga is kiszolgálhat HTTPS-t egy Ön által megadott tanúsítvánnyal, az ACTUAL_HTTPS_KEY és az ACTUAL_HTTPS_CERT révén: a dokumentáció ezt az utat az internettől elzárt szerverre írja le.

Caddyvel

A dokumentáció a Caddyt egyszerű fordított proxyként mutatja be, amely magától megszerzi és megújítja a tanúsítványait. Íme a példája, a szerverre telepített Caddyhez igazítva:

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

Nginxszel és Certbottal

Ez a blokk a dokumentáció Nginx-konfigurációját követi, a 80-as portra szűkítve, hogy a Certbot beállíthassa a HTTPS-t. Elrejti az Actual által küldött két fejlécet, és egyszer újra beállítja őket: a dokumentáció figyelmeztet, hogy egy megkettőzött fejléc érvényteleníti a szabályt, és az alkalmazás ekkor a SharedArrayBufferMissing hibánál megáll.

Nginx-blokk
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;
    }
}

A client_max_body_size 0 a dokumentáció példájához hasonlóan feloldja az Nginx méretkorlátját, így egy nagy költségvetési fájl is eljut a szerverig. A Certbot ezután telepíti a tanúsítványt, és gondoskodik a megújításáról:

Terminál
sudo certbot --nginx

Ellenőrzés

Nyissa meg a címét https előtaggal, a dokumentáció tanácsa szerint egy új lapon, ne pedig egy hibát mutató oldal újratöltésével. Megjelenik az Actual üdvözlőképernyője: a HTTPS és a fejlécek a helyükön vannak.

A szerverjelszó

Az első indításkor az üdvözlőképernyő arra kéri, hogy válasszon jelszót a szerverhez: ez védi a költségvetéseihez való hozzáférést. Amíg nincs beállítva, ez a képernyő annak jelenik meg, aki elsőként nyitja meg a címet. Nyissa meg tehát, amint a HTTPS működik, és válasszon egy hosszú, csak ehhez a szerverhez használt jelszót.

A szerver ezt a jelszót argon2-vel hashelve őrzi a server-files mappa account.sqlite fájljában, az általa ismert költségvetési fájlok listájával és az aktív munkamenet tokenjével együtt.

Elfelejtett jelszó visszaállítása

A dokumentáció egy parancsot ad, amely a fájlok és az adatok érintése nélkül állít be új jelszót. Kétszer kéri be:

Terminál
docker exec -it actual_server node /app/src/scripts/reset-password.js

OpenID és több felhasználó

A jelszónál erősebb hitelesítéshez a dokumentáció OpenID-szolgáltatót ajánl: a legtöbbjük kétlépcsős hitelesítést kínál. Ez nyitja meg a szervert több felhasználó előtt is. A konfigurációs referencia ezt a módszert előzetes (preview) funkcióként mutatja be.

  1. Regisztrálja az Actualt a szolgáltatójánál, a https://budget.example.com/openid/callback átirányítási URI-val.
  2. Egy megnyitott költségvetésben lépjen a beállításokba, és kattintson a Start using OpenID gombra, majd töltse ki a szolgáltatót, a kliensazonosítót és a hozzá tartozó titkos kulcsot.
  3. Jelentkezzen be OpenID-vel. A dokumentáció figyelmeztet, hogy az elsőként bejelentkező személy lesz a szerver adminisztrátora és tulajdonosa, és ez a szerepkör a felületről már nem módosítható: gondoskodjon róla, hogy Ön jelentkezzen be elsőként.

Ugyanez a konfiguráció a config.json fájlba vagy környezeti változókba is kerülhet, egy felderítési URL-lel, ha a szolgáltató közzétesz ilyet:

compose.yaml, a szolgáltatásban
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"

A titkos kulcs egy .env fájlba kerül, a compose.yaml mellé. A 26.10.0-s verzió óta az ACTUAL_OPENID_CLIENT_SECRET_FILE egy fájlból is kiolvashatja, ami a Docker-titkokhoz illik.

Végpontok közötti titkosítás

A szerverjelszó mellett minden költségvetés végpontok közötti titkosítással is védhető. Az adatai ekkor az Ön eszközén, egy második jelszóból származtatott kulccsal titkosítódnak, mielőtt elhagynák az eszközt: a szerver csak olyan módosításokat továbbít, amelyeket nem tud elolvasni.

  1. Nyissa meg a költségvetést, lépjen a beállítások Encryption részébe, és kattintson az Enable encryption gombra.
  2. Válasszon a szerverjelszótól eltérő jelszót.
  3. Minden további eszközön adja meg egyszer ugyanezt a jelszót, a költségvetés első letöltésekor.

A dokumentáció egyértelmű: egy elfelejtett titkosítási jelszó nem állítható helyre. Ha a költségvetésnek még létezik helyi másolata, új kulcsot állíthat elő, ami alaphelyzetbe állítja a szinkronizálást. A titkosítás ki sem kapcsolható: a titkosítatlan fájlhoz való visszatérés exporttal, majd importtal történik.

VédelemMit nyújtHol állítható
HTTPSTitkosítja az eszközei és a szerver közötti utat, és lehetővé teszi az alkalmazás indulásátA fordított proxy
SzerverjelszóKorlátozza a költségvetésekhez való hozzáférést, a szerveren argon2-vel hashelveAz első indításkor, majd a beállításokban
OpenIDA szolgáltatója kétlépcsős hitelesítése, és személyenként egy fiókA szolgáltatónál, majd a beállításokban
Végpontok közötti titkosításOlvashatatlanná teszi a költségvetéseket a szerver és a mentései számáraMinden költségvetésben
LemeztitkosításVédi a helyi másolatot, amely a dokumentáció megjegyzése szerint titkosítatlanMinden eszközén

A végpontok közötti titkosítás a költségvetések adatait fedi le. A banki szinkronizálás hozzáférési adatai a szerveren, az account.sqlite fájlban vannak, e titkosításon kívül: ennek megfelelően védje a szerverhez és a mentéseihez való hozzáférést.

Banki szinkronizálás

Az Actual beállítás nélkül importálja a tranzakcióit egy fájlból. Közvetlenül a bankjától is lekérheti őket, egy banki adatszolgáltatón keresztül. Ez a szinkronizálás nem kötelező, a szervert igényli, és az Ön saját hozzáférési adataira épül: Ön nyit fiókot a szolgáltatónál, és ott hozza létre azokat a kulcsokat, amelyeket az Actualnak megad. Ezek a kulcsok a szerveren maradnak, és csak egyszer kell megadnia őket.

SzolgáltatóLefedett bankok a dokumentáció szerintÁllapot a 26.11.0-s verzióban
SimpleFIN BridgeÉszak-amerikai bankokTámogatott; a 26.11.0-s verzió óta költségvetésenkénti hozzáférési adatok is lehetségesek
GoCardless Bank Account DataEurópai bankokA meglévő fiókoknál támogatott: a GoCardless 2025 júliusa óta nem fogad új fiókokat
Pluggy.aiBrazil bankokTámogatott
Enable BankingEurópai bankokKísérleti funkció
AkahuÚj-zélandi bankokKísérleti funkció

A mentések

Minden eszköz teljes másolatot őriz a költségvetéseiről, a szerver pedig egy másikat. Egy jó mentés mindkettőt lefedi: a szerver adatmappáját és minden költségvetés exportját.

ElemMit őrizMentendő
server-files/account.sqliteA hashelt jelszó, a költségvetések listája, a munkamenetek, az OpenID-fiókok és a banki hozzáférési adatokKötelező, titkosítva
user-files/A költségvetési fájlok, bináris fájlokkéntKötelező
config.jsonA szerver konfigurációja, ha létrehozott ilyetAjánlott, titkosítva
Minden költségvetés exportjaEgy zip-fájl a db.sqlite adatbázissal és a metadata.json fájllalAjánlott

A szerver mappája

Mindaz, amit a szerver őriz, az actual-data mappában él. Leállított szerver mellett egyben másolható, nyugalmi állapotban lévő SQLite-adatbázisaival együtt:

Terminál, a compose.yaml mappájában
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Ütemezze ezt a másolást a szerveren, titkosítsa, és őrizzen egy példányt máshol. A szerver lemezén tárolva a szerver éjszakai mentéseibe is bekerül.

Minden költségvetés exportja

Egy megnyitott költségvetésből: Settings, Data rész, Export data. A fájlt bárhol megőrizheti, és szerver nélkül is újra megnyitható. A dokumentáció ezzel az exporttal tér vissza egy titkosított költségvetésből egy titkosítatlan fájlhoz: az adatait olvasható formában tartalmazza, ezért őrizze biztonságos helyen.

Egy régi költségvetés nagy exportot ad, mert az Actual minden módosítást megőriz a fájlban. A dokumentáció ilyenkor az exportálás előtt a speciális beállítások Reset sync lehetőségét tanácsolja: az előzmények egyetlen fájlba tömörülnek, és a méret jelentősen csökken.

Visszaállítás

  1. Zárja be a megnyitott költségvetést: kattintson a nevére a bal felső sarokban, majd a Switch file lehetőségre.
  2. Kattintson az Import file lehetőségre, válassza az Actual formátumot, majd az export zip-fájlját.
  3. Az importált költségvetés az eredeti mellett jelenik meg: ellenőrizze, szükség esetén nevezze át, majd törölje a régi példányt.

A többi eszközén ezután válassza ki ezt a költségvetést a fájllistában: letöltődik, majd szinkronizálódik. Az asztali alkalmazások saját automatikus mentéseket is készítenek, a használat utolsó tíz napjának mindegyikéről egyet, az aktuális napról pedig többet.

A frissítések

A dokumentáció megadja a parancsot, a compose.yaml mappájából. Az adatmappa a helyén marad:

Terminál
docker compose pull
docker compose up -d

A verziók számozása évet és hónapot követ: a 26.11.0-s 2026. november 1-jén jelent meg, a legutóbbi kiadások pedig minden hónap elején jelentek meg. Frissítés előtt olvassa el a megjegyzéseiket, és közvetlenül előtte exportálja a költségvetéseit, ahogyan a dokumentáció ajánlja. A megjegyzések jelzik a tervezendő változásokat, például a 26.11.0-s verzióban az engedélyezett SimpleFIN-hálózatok listáját, vagy a 26.9.0-s verzióban az Ubuntu alapú image Node.js 24-re való átállását, amely a 32 bites ARM-processzorokon az Alpine image javára megszűnt.

Ki mit csinál egy Managed VPS-en

A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; az Actual Budget továbbra is az Ön szoftvere marad, a beállításaival és a költségvetéseivel.

TémaCsapatainkÖn
A szerverRendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együttA tevékenységének megfelelő időpont
A felügyeletÉjjel-nappal, a hét minden napján követett szerver, beavatkozás a hívására való várakozás nélkülA példánya naplóinak olvasása
Actual BudgetProaktív követés: a hibák, lassulások és a lemezterület észlelése, javítás ajánlásaA telepítése, a frissítései és a beállításai, amelyeket Ön vagy MI-asszisztense alkalmaz
A hozzáférés és a költségvetésekA szerver, amely hordozza őket, felügyelve és mentveA szerverjelszó, az OpenID, a felhasználók és a végpontok közötti titkosítás
A banki szinkronizálásA hozzáférési adatait őrző szerver, felügyelve és mentveA szolgáltató kiválasztása, a kulcsai és az összekapcsolt fiókok
A mentésekMinden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együttA költségvetései exportjai, és a visszaállítási kérés, amikor szüksége van rá
Az átköltöztetésA jelenlegi szervere átköltöztetve, ingyenesenAz átállás időpontja

Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.

Az Actual Budget egy Ön helyett karbantartott szerveren

Egy Simafri Managed VPS esetében csapataink naprakészen tartják Actual Budget-példánya szerverét, éjjel-nappal felügyelik, és beavatkoznak anélkül, hogy a hívására várnának; proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön vagy MI-asszisztense alkalmaz. A mentések minden éjjel titkosítva, a gépen kívül készülnek, a visszaállításuk a díj része, jelenlegi szervere átköltöztetése pedig ingyenes.

Tovább a Managed VPS oldalára

Gyakori kérdések

Ingyenes az Actual Budget?

Igen. Az Actual Budget MIT licenc alatt jelenik meg: szabadon használhatja, módosíthatja és terjesztheti tovább, saját magának vagy egy vállalkozásnak, feltéve, hogy a szerzői jogi és licencmegjegyzése a másolatokban marad. Marad a költsége annak a szervernek, amelyen fut.

Kell szerver az Actual Budget használatához?

Az asztali alkalmazások önállóan is működnek. A szerver, amelyet a dokumentáció határozottan ajánl, hozzáadja a webes és mobilalkalmazást, az eszközök közötti szinkronizálást, a banki szinkronizálást és az API-t. Minden eszköz teljes, a szerverrel szinkronizált másolatot őriz a költségvetéseiről.

Hogyan telepítsem az Actual Budgetet Docker Compose-zal?

Hozzon létre egy compose.yaml fájlt az actualbudget/actual-server image-gel, a 127.0.0.1 címen közzétett 5006-os porttal és egy /data útvonalra csatolt adatmappával, majd futtassa a docker compose up -d parancsot. Ezután helyezzen elé egy HTTPS-t használó fordított proxyt, és nyissa meg a címét, hogy megválassza a szerverjelszót.

Miért követeli meg az Actual Budget a HTTPS-t?

Az alkalmazásnak szüksége van a SharedArrayBuffer funkcióra, amelyet a böngészők csak HTTPS-en, a Cross-Origin-Embedder-Policy és a Cross-Origin-Opener-Policy fejléccel kiszolgált oldalon kapcsolnak be. Ezeket a fejléceket a szerver állítja be; a HTTPS-t a fordított proxy biztosítja. Csak a localhost címen keresztüli hozzáférés működik nélküle.

Hogyan védjem az adatokat egy Actual-költségvetésben?

Szolgálja ki a példányt HTTPS-en, válasszon erős szerverjelszót, vagy használjon OpenID-t kétlépcsős hitelesítéssel, és kapcsolja be a végpontok közötti titkosítást: a szerver ekkor már nem tudja elolvasni a költségvetéseit. Ezt a második jelszót őrizze biztonságos helyen, mert nem állítható helyre.

Kapcsolódik az Actual Budget a bankomhoz?

Igen, egy banki adatszolgáltatón keresztül, az Ön saját hozzáférési adataival: SimpleFIN Bridge, GoCardless Bank Account Data a meglévő fiókokhoz, Pluggy.ai, valamint kísérleti funkcióként Enable Banking és Akahu. A szinkronizáláshoz szerver kell, és a 26.11.0-s verzió óta automatikusan is futhat.

Hogyan mentsem az Actual Budgetet?

Másolja a szerver adatmappáját leállított szerver mellett: a server-files a fiókokat és a hozzáférési adatokat, a user-files a költségvetéseket tartalmazza. Exportáljon minden költségvetést is a Settings, Export data menüpontból, és ezeket a másolatokat titkosítva őrizze. Egy export az Import file lehetőséggel állítható vissza.

Lefedi a Managed VPS az Actual Budgetet?

A Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazásban végzett beavatkozás óradíjban vagy átalánydíjban számlázódik.

Források és hivatalos dokumentáció

Kapcsolódó útmutatók

Menedzselt és nem menedzselt VPS közötti különbség: ki mit végezA menedzselt és a nem menedzselt VPS közötti különbség egyetlen kérdésen múlik: ki gondoskodik a szerverről, miután az már fut. A „menedzselt” szónak ugyanakkor nincs hivatalos meghatározása: szolgáltatónként a rendszer egyszerű telepítésétől a szerver teljes üzemeltetéséig terjedhet a jelentése. Ez az útmutató megmutatja, ki mit végez, feladatról feladatra, a támogatás köztes szintjével együtt, és megadja azokat a kérdéseket, amelyek aláírás előtt eloszlatják a kétértelműséget.Egy VPS biztonsági mentései: mit ellenőrizzen aláírás előttA VPS-ajánlatok szinte mindig ezt ígérik: „mentés a csomagban”. E néhány szó mögött lehet minden éjjel készülő, a gépen kívül őrzött és szakértők által visszaállított másolat, de lehet egy a szerverrel azonos lemezen tárolt pillanatkép is. Ez az útmutató megadja azokat a kérdéseket, amelyek különbséget tesznek, azt, mit jelent az egyes válasz, és azt, hogyan ellenőrizheti, hogy egy mentés visszaállítható.Vaultwarden hosztolása Managed VPS-en: jelszavai a saját szerverénA Vaultwarden hosztolása Managed VPS-en azt jelenti, hogy a saját és a csapata jelszavait egy saját gépen tartja, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A Vaultwarden AGPL-3.0 licenc alatt álló szabad szoftver. Ez az útmutató a hivatalos dokumentációját követi: a telepítést Docker Compose-zal, a HTTPS-t, a regisztrációk lezárását, az adminisztrációs tokent, azt, ami a széfet védi, az adatbázist, az e-maileket, a mentéseket és a frissítéseket.
Kapcsolatfelvétel