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.
Szerző: Simon Vasconcelos Lee
Közzétéve 2026. november 17-énOlvasási idő: 14 perc
SharedArrayBuffer funkcióra, amelyet a böngészők csak HTTPS-en kiszolgált oldalon kapcsolnak be. Ezt egy fordított proxy biztosítja.docker compose pull paranccsal.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ül | Szerverrel |
|---|---|---|
| Költségvetések, jelentések, ütemezések | Igen | Igen |
| Tranzakciók importálása fájlból | Igen | Igen |
| Költségvetési fájlok importálása és exportálása | Igen | Igen |
| Az alkalmazás böngészőben és telefonon | Igen | |
| Szinkronizálás az eszközök között | Igen | |
| Banki szinkronizálás | Igen | |
| Az Actual API | Igen |
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.
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:
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 címen közzétéve csak az ugyanazon a szerveren lévő fordított proxyn keresztül érhető el, amely a HTTPS-t hozzáadja.actual-data mappa mindent tartalmaz, amit a szerver őriz. Két almappát hoz létre benne, a server-files és a user-files mappát, és a dokumentáció kiemeli, hogy ez a csatolás a konténer törlésekor is megőrzi az adatait.latest címke a legutóbbi hivatalos kiadást követi, és a dokumentáció a legtöbb felhasználónak ezt ajánlja. A latest-alpine ugyanezt a kiadást adja egy könnyebb Alpine alapon, egy olyan címke pedig, mint a 26.11.0, rögzít egy verziót. A nightly címkék a fejlesztést követik, a fő ág minden változásával.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.
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:
localhost címen megnyitott szervert menti fel.Cross-Origin-Embedder-Policy require-corp értékkel és a Cross-Origin-Opener-Policy same-origin értékkel. A hivatalos szerver ezeket mindig maga állítja be.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.
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:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
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.
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:
sudo certbot --nginx
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.
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.
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:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD változóval állítható: alapértelmezésként password, identitásszolgáltatóhoz openid, vagy header.x-actual-password fejlécben adják át a jelszót. A dokumentáció figyelmeztet, hogy egy hibás beállítás ennél a lépésnél az egész internet számára elérhetővé teheti a példányt: tartsa fenn ezeknek a szolgáltatásoknak.ACTUAL_ALLOWED_LOGIN_METHODS változóval szűkíthetők, egy vesszővel elválasztott listával.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.
https://budget.example.com/openid/callback átirányítási URI-val.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:
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.
config.json fájlban megadott "authMethod": "oauth2" beállítással működik.ACTUAL_USER_CREATION_MODE login értéke az első bejelentkezéskor hozza létre őket.ACTUAL_OPENID_ENFORCE true értéke ezt teszi az egyetlen elfogadott bejelentkezési móddá.ACTUAL_TOKEN_EXPIRATION alapértéke never. Követheti a szolgáltatóét az openid-provider értékkel, vagy megadható másodpercben.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.
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édelem | Mit nyújt | Hol állítható |
|---|---|---|
| HTTPS | Titkosítja az eszközei és a szerver közötti utat, és lehetővé teszi az alkalmazás indulását | A fordított proxy |
| Szerverjelszó | Korlátozza a költségvetésekhez való hozzáférést, a szerveren argon2-vel hashelve | Az első indításkor, majd a beállításokban |
| OpenID | A szolgáltatója kétlépcsős hitelesítése, és személyenként egy fiók | A szolgáltatónál, majd a beállításokban |
| Végpontok közötti titkosítás | Olvashatatlanná teszi a költségvetéseket a szerver és a mentései számára | Minden költségvetésben |
| Lemeztitkosítás | Védi a helyi másolatot, amely a dokumentáció megjegyzése szerint titkosítatlan | Minden 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.
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 bankok | Támogatott; a 26.11.0-s verzió óta költségvetésenkénti hozzáférési adatok is lehetségesek |
| GoCardless Bank Account Data | Európai bankok | A meglévő fiókoknál támogatott: a GoCardless 2025 júliusa óta nem fogad új fiókokat |
| Pluggy.ai | Brazil bankok | Támogatott |
| Enable Banking | Európai bankok | Kísérleti funkció |
| Akahu | Új-zélandi bankok | Kísérleti funkció |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS listába. A nyilvános SimpleFIN-hidak semmilyen beállítást nem igényelnek.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.
| Elem | Mit őriz | Mentendő |
|---|---|---|
server-files/account.sqlite | A hashelt jelszó, a költségvetések listája, a munkamenetek, az OpenID-fiókok és a banki hozzáférési adatok | Kötelező, titkosítva |
user-files/ | A költségvetési fájlok, bináris fájlokként | Kötelező |
config.json | A szerver konfigurációja, ha létrehozott ilyet | Ajánlott, titkosítva |
| Minden költségvetés exportja | Egy zip-fájl a db.sqlite adatbázissal és a metadata.json fájllal | Ajánlott |
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:
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.
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.
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 dokumentáció megadja a parancsot, a compose.yaml mappájából. Az adatmappa a helyén marad:
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.
nightly címkék: a nightly címkéről a latest címkére való visszalépés olvashatatlanná tehet egy költségvetést a stabil kiadás számára. A dokumentáció leírja a javítást, és ezekkel a címkékkel a költségvetései mentését kéri.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éma | Csapataink | Ön |
|---|---|---|
| A szerver | Rendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együtt | A 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ül | A példánya naplóinak olvasása |
| Actual Budget | Proaktív követés: a hibák, lassulások és a lemezterület észlelése, javítás ajánlása | A 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ések | A szerver, amely hordozza őket, felügyelve és mentve | A szerverjelszó, az OpenID, a felhasználók és a végpontok közötti titkosítás |
| A banki szinkronizálás | A hozzáférési adatait őrző szerver, felügyelve és mentve | A szolgáltató kiválasztása, a kulcsai és az összekapcsolt fiókok |
| A mentések | Minden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együtt | A költségvetései exportjai, és a visszaállítási kérés, amikor szüksége van rá |
| Az átköltöztetés | A jelenlegi szervere átköltöztetve, ingyenesen | Az á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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Beszéljünk a weboldaláról
Meséljen néhány szóban a projektjéről: hamarosan jelentkezünk.
Köszönjük! Kérését elküldtük. Hamarosan válaszolunk.
Inkább e-mailben? Írjon nekünk ide: support@simafri.com.