Mitināt Actual Budget Managed VPS serverī nozīmē glabāt savus budžetus un to sinhronizāciju uz savas mašīnas, ko mūsu komandas uztur atjauninātu un uzrauga dienu un nakti. Actual Budget ir personīgo finanšu rīks, kas datus vispirms glabā lokāli, izplatīts ar MIT licenci. Šis ceļvedis seko tā oficiālajai dokumentācijai: servera loma, uzstādīšana ar Docker Compose, HTTPS, servera parole, OpenID, pilnīga šifrēšana, bankas sinhronizācija, rezerves kopijas un atjauninājumi.
Autors: Simon Vasconcelos Lee
Publicēts 2026. gada 17. novembrīLasīšanas laiks: 14 minūtes
SharedArrayBuffer, ko pārlūkprogrammas ieslēdz tikai lapā, kas piedāvāta caur HTTPS. To nodrošina reversais starpniekserveris.docker compose pull.Actual Budget ir personīgo finanšu rīks, kas datus vispirms glabā lokāli, uzrakstīts Node.js, un tā README to raksturo kā pilnībā bezmaksas un atvērtā koda. Tas glabā visus jūsu datus katrā jūsu ierīcē un fonā sinhronizē tos ar jūsu izvēlēto serveri: lietotne darbojas arī bez savienojuma, un jūsu izmaiņas nonāk citās ierīcēs, tiklīdz tīkls ir atpakaļ.
Projekts sastāv no klienta un servera. Serveris nav obligāts, taču dokumentācija to stingri iesaka, jo tas atver vairākas funkcijas:
| Funkcija | Bez servera | Ar serveri |
|---|---|---|
| Budžeti, pārskati, grafiki | Jā | Jā |
| Darījumu importēšana no faila | Jā | Jā |
| Budžeta failu importēšana un eksportēšana | Jā | Jā |
| Lietotne pārlūkprogrammā un tālrunī | Jā | |
| Sinhronizācija starp ierīcēm | Jā | |
| Bankas sinhronizācija | Jā | |
| Actual API | Jā |
Actual Budget tiek izplatīts ar MIT licenci, autortiesības pieder James Long. Teksts ikvienam, kas iegūst kopiju, bez maksas piešķir tiesības to izmantot, kopēt, mainīt, apvienot, publicēt, izplatīt, apakšlicencēt un pārdot tās kopijas.
Ir viens nosacījums: autortiesību paziņojums un licences teksts pavada visas programmatūras kopijas vai būtiskas tās daļas. Tāpēc jūs varat darbināt projekta publicēto attēlu sev, savai ģimenei vai savam uzņēmumam, nepērkot nekādu licenci.
Projekts publicē serveri kā Docker attēlu, actualbudget/actual-server Docker Hub, un to pašu attēlu GitHub reģistrā, ghcr.io/actualbudget/actual. Serverī, kur uzstādīts Docker, izveidojiet mapi un ievietojiet tajā šo compose.yaml, ņemtu no repozitorijā pieejamā faila:
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, tas ir sasniedzams tikai caur reverso starpniekserveri tajā pašā serverī, kas pievieno HTTPS.actual-data glabā visu, ko serveris saglabā. Tas tur izveido divas apakšmapes, server-files un user-files, un dokumentācija norāda, ka šis montējums saglabā jūsu datus, kad konteiners tiek noņemts.latest seko jaunākajai oficiālajai versijai, un dokumentācija to iesaka vairumam lietotāju. latest-alpine dod to pašu versiju uz vieglākas Alpine bāzes, un birka, piemēram, 26.11.0, fiksē versiju. Birkas nightly seko izstrādei, ar katru izmaiņu tās galvenajā zarā.Jūsu domēna vārds norāda uz serveri ar A un AAAA ierakstiem, un apmeklētāji nonāk uz portiem 80 un 443. Kamēr HTTPS nav ieslēgts, lietotne neatveras: pārejiet tieši uz nākamo sadaļu.
Projekts nenosauc ne atmiņas, ne procesora apjomu. Izmērs ir atkarīgs no budžetu skaita, to vēstures un sinhronizēto ierīču skaita. Ar Managed VPS aprakstiet mums savu lietojumu, un mēs jums iesakām piemērotu izmēru.
Actual Budget balstās uz SharedArrayBuffer, pārlūkprogrammu tehnoloģiju, ko tā dokumentācija raksturo kā obligātu: bez tās lietotne nestartē. Pārlūkprogrammas to ieslēdz tikai izolētā lapā, kam vajadzīgi divi nosacījumi:
localhost.Cross-Origin-Embedder-Policy ar vērtību require-corp un Cross-Origin-Opener-Policy ar vērtību same-origin. Oficiālais serveris tās vienmēr iestata pats.Lai padarītu Actual pieejamu internetā, dokumentācija lūdz to novietot aiz reversā starpniekservera ar HTTPS. Serveris var arī pats piedāvāt HTTPS ar sertifikātu, ko tam dodat, izmantojot ACTUAL_HTTPS_KEY un ACTUAL_HTTPS_CERT: dokumentācija šo ceļu apraksta serverim, kas paliek ārpus interneta.
Dokumentācija pasniedz Caddy kā vienkāršu reverso starpniekserveri, kas pats iegūst un atjauno savus sertifikātus. Lūk, tās piemērs, pielāgots Caddy, kas uzstādīts serverī:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Šis bloks seko dokumentācijas Nginx konfigurācijai, saīsinātai līdz portam 80, lai Certbot varētu ieslēgt HTTPS. Tas paslēpj abas Actual sūtītās galvenes un iestata tās no jauna, vienreiz: dokumentācija brīdina, ka dublēta galvene padara politiku nederīgu, un tad lietotne apstājas ar kļūdu 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 noņem Nginx izmēra ierobežojumu, kā dokumentācijas piemērā, lai liels budžeta fails nonāktu līdz serverim. Pēc tam Certbot uzstāda sertifikātu un parūpējas par tā atjaunošanu:
sudo certbot --nginx
Atveriet savu adresi ar https jaunā cilnē, nevis pārlādējot lapu, kas rādīja kļūdu, kā iesaka dokumentācija. Parādās Actual sākuma ekrāns: HTTPS un galvenes ir vietā.
Pirmajā startā sākuma ekrāns lūdz izvēlēties servera paroli: tieši tā aizsargā piekļuvi jūsu budžetiem. Kamēr tā nav iestatīta, šis ekrāns parādās pirmajam, kas atver adresi. Tāpēc atveriet to, tiklīdz HTTPS darbojas, un izvēlieties garu paroli, ko izmantojat tikai šim serverim.
Serveris glabā šo paroli jaucējkodā, ar argon2, failā account.sqlite mapē server-files, kopā ar tam zināmo budžeta failu sarakstu un aktīvās sesijas marķieri.
Dokumentācija piedāvā komandu, kas iestata jaunu paroli, neskarot jūsu failus un datus. Tā to prasa divreiz:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: pēc noklusējuma password, openid identitātes pakalpojuma sniedzējam vai header.x-actual-password. Dokumentācija brīdina, ka kļūdaina konfigurācija šajā solī varētu padarīt instanci pieejamu visam internetam: rezervējiet to šiem pakalpojumiem.ACTUAL_ALLOWED_LOGIN_METHODS, sarakstu, kas atdalīts ar komatiem.Autentifikācijai, kas ir stiprāka par paroli, dokumentācija iesaka OpenID pakalpojuma sniedzēju: lielākā daļa no tiem piedāvā divfaktoru autentifikāciju. Tieši tas arī atver serveri vairākiem lietotājiem. Konfigurācijas rokasgrāmata šo metodi pasniedz kā priekšskatījuma funkciju.
https://budget.example.com/openid/callback.To pašu konfigurāciju var ievietot arī failā config.json vai vides mainīgajos, ar atklāšanas URL, ja pakalpojuma sniedzējs tādu publicē:
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"
Noslēpums tiek ievietots failā .env blakus compose.yaml. Kopš versijas 26.10.0 ACTUAL_OPENID_CLIENT_SECRET_FILE to var nolasīt arī no faila, kas der Docker noslēpumiem.
"authMethod": "oauth2" failā config.json.ACTUAL_USER_CREATION_MODE ar vērtību login tos izveido pirmajā pieteikšanās reizē.ACTUAL_OPENID_ENFORCE ar vērtību true padara to par vienīgo pieņemto pieteikšanās metodi.ACTUAL_TOKEN_EXPIRATION pēc noklusējuma ir never. Tas var sekot pakalpojuma sniedzēja sesijai ar openid-provider vai ilgumam sekundēs.Papildus servera parolei katru budžetu var šifrēt no gala līdz galam. Tad tā dati tiek šifrēti jūsu ierīcē ar atslēgu, kas atvasināta no otras paroles, pirms tie to atstāj: serveris tikai nodod tālāk izmaiņas, ko tas nevar izlasīt.
Dokumentācija ir skaidra: aizmirstu šifrēšanas paroli nevar atgūt. Ja budžeta lokālā kopija vēl pastāv, varat ģenerēt jaunu atslēgu, kas atiestata sinhronizāciju. Šifrēšanu arī nevar izslēgt: atgriešanās pie nešifrēta faila notiek ar eksportu un pēc tam importu.
| Aizsardzība | Ko tā dod | Kur to iestata |
|---|---|---|
| HTTPS | Šifrē ceļu starp jūsu ierīcēm un serveri un ļauj lietotnei startēt | Reversais starpniekserveris |
| Servera parole | Ierobežo piekļuvi budžetiem, glabāta jaucējkodā ar argon2 serverī | Pirmajā startā, pēc tam iestatījumos |
| OpenID | Jūsu pakalpojuma sniedzēja divfaktoru autentifikācija un viens konts katram cilvēkam | Pie pakalpojuma sniedzēja, pēc tam iestatījumos |
| Pilnīga šifrēšana | Padara budžetus nelasāmus serverim un tā rezerves kopijām | Katrā budžetā |
| Diska šifrēšana | Aizsargā lokālo kopiju, kas, kā norāda dokumentācija, nav šifrēta | Katrā jūsu ierīcē |
Pilnīgā šifrēšana aptver budžeta datus. Bankas sinhronizācijas piekļuves dati tiek glabāti serverī, failā account.sqlite, ārpus šīs šifrēšanas: attiecīgi aizsargājiet piekļuvi serverim un tā rezerves kopijām.
Actual importē jūsu darījumus no faila bez jebkādiem iestatījumiem. Tas var tos arī iegūt tieši no jūsu bankas, izmantojot banku datu pakalpojuma sniedzēju. Šī sinhronizācija nav obligāta, tai vajadzīgs serveris, un tā balstās uz jūsu pašu piekļuves datiem: jūs atverat kontu pie pakalpojuma sniedzēja un tur izveidojat atslēgas, ko dodat Actual. Šīs atslēgas tiek glabātas serverī, un jūs tās ievadāt tikai vienreiz.
| Pakalpojuma sniedzējs | Aptvertās bankas, saskaņā ar dokumentāciju | Statuss 26.11.0 versijā |
|---|---|---|
| SimpleFIN Bridge | Ziemeļamerikas bankas | Atbalstīts; kopš 26.11.0 iespējami katram budžetam atsevišķi piekļuves dati |
| GoCardless Bank Account Data | Eiropas bankas | Atbalstīts esošajiem kontiem: GoCardless kopš 2025. gada jūlija nepieņem jaunus kontus |
| Pluggy.ai | Brazīlijas bankas | Atbalstīts |
| Enable Banking | Eiropas bankas | Eksperimentāla funkcija |
| Akahu | Jaunzēlandes bankas | Eksperimentāla funkcija |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Publiskiem SimpleFIN tiltiem iestatījums nav vajadzīgs.Katra ierīce glabā pilnu jūsu budžetu kopiju, un serveris glabā vēl vienu. Laba rezerves kopija aptver abas: servera datu mapi un katra budžeta eksportu.
| Elements | Ko tas glabā | Vai kopēt |
|---|---|---|
server-files/account.sqlite | Paroles jaucējkodu, budžetu sarakstu, sesijas, OpenID kontus un bankas piekļuves datus | Obligāti, šifrētu |
user-files/ | Budžeta failus, binārā formā | Obligāti |
config.json | Servera konfigurāciju, ja to izveidojāt | Ieteicams, šifrētu |
| Katra budžeta eksports | Zip failu ar datubāzi db.sqlite un metadata.json | Ieteicams |
Viss, ko serveris glabā, atrodas mapē actual-data. Ar apturētu serveri to var nokopēt vienā reizē, kamēr tā SQLite datubāzes ir miera stāvoklī:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Ieplānojiet šo kopēšanu serverī, šifrējiet kopiju un glabājiet vienu citur. Glabāta servera diskā, tā nonāk arī tā nakts rezerves kopijās.
No atvērta budžeta: Settings, sadaļa Data, Export data. Failu var glabāt, kur vēlaties, un tas atveras arī bez servera. Dokumentācija izmanto šo eksportu, lai no šifrēta budžeta atgrieztos pie nešifrēta faila: tajā jūsu dati ir skaidrā tekstā, tāpēc glabājiet to drošā vietā.
Vecs budžets dod lielu eksportu, jo Actual failā glabā katru izmaiņu. Tad dokumentācija iesaka pirms eksportēšanas papildu iestatījumos izmantot Reset sync: vēsture tiek saspiesta vienā failā, un izmērs ievērojami samazinās.
Pēc tam citās ierīcēs izvēlieties šo budžetu failu sarakstā: tas tiek lejupielādēts un pēc tam sinhronizēts. Darbvirsmas lietotnes arī veido pašas savas automātiskās rezerves kopijas, pa vienai katrai no pēdējām desmit lietošanas dienām un vairākas par pašreizējo dienu.
Dokumentācija dod komandu, kas jāpalaiž no mapes ar compose.yaml. Datu mape paliek vietā:
docker compose pull
docker compose up -d
Versijas tiek numurētas pēc gada un mēneša: 26.11.0 iznāca 2026. gada 1. novembrī, un pēdējās versijas ir publicētas katra mēneša sākumā. Pirms atjaunināšanas izlasiet to piezīmes un tieši pirms tam eksportējiet savus budžetus, kā iesaka dokumentācija. Piezīmes norāda izmaiņas, kas jāparedz, piemēram, atļauto SimpleFIN tīklu sarakstu 26.11.0 versijā vai Ubuntu attēla pāreju uz Node.js 24 versijā 26.9.0, kas to izslēdza 32 bitu ARM procesoriem par labu Alpine attēlam.
nightly: atgriešanās no nightly uz latest var padarīt budžetu nelasāmu stabilajai versijai. Dokumentācija apraksta labojumu un ar šīm birkām lūdz veidot jūsu budžetu rezerves kopijas.Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Actual Budget paliek jūsu programmatūra ar saviem iestatījumiem un jūsu budžetiem.
| Temats | Mūsu komandas | Jūs |
|---|---|---|
| Serveris | Sistēmas un drošības atjauninājumi, ieskaitot iejaukšanos serverī | Brīdis, kas der jūsu darbam |
| Uzraudzība | Serveris tiek uzraudzīts 24/7, iejaucoties, negaidot jūsu zvanu | Jūsu instances žurnālu lasīšana |
| Actual Budget | Proaktīva sekošana: kļūdas, palēninājumi un diska vieta tiek pamanīti, labojums tiek ieteikts | Tā uzstādīšana, atjauninājumi un iestatījumi, ko ieviešat jūs vai jūsu MI asistents |
| Piekļuve un budžeti | Serveris, kas tos nes, uzraudzīts un ar rezerves kopijām | Servera parole, OpenID, lietotāji un pilnīgā šifrēšana |
| Bankas sinhronizācija | Serveris, kas glabā tās piekļuves datus, uzraudzīts un ar rezerves kopijām | Pakalpojuma sniedzēja izvēle, tā atslēgas un sasaistītie konti |
| Rezerves kopijas | Katru nakti, šifrētas un glabātas ārpus mašīnas; atjaunošana iekļauta | Jūsu budžetu eksporti un atjaunošanas pieprasījums, kad tas vajadzīgs |
| Migrācija | Jūsu pašreizējā servera migrācija, bez maksas | Pārslēgšanās brīdis |
Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.
Ar Simafri Managed VPS mūsu komandas uztur jūsu Actual Budget instances serveri atjauninātu, uzrauga to dienu un nakti un iejaucas, negaidot jūsu zvanu; tās arī proaktīvi seko jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs paši vai jūsu MI asistents. Rezerves kopijas katru nakti tiek šifrētas un glabātas ārpus mašīnas, to atjaunošana ir iekļauta, un jūsu pašreizējā servera migrācija ir bez maksas.
Jā. Actual Budget tiek izplatīts ar MIT licenci: varat to brīvi izmantot, mainīt un izplatīt tālāk, sev vai uzņēmumam, ja vien tā autortiesību un licences paziņojums paliek kopijās. Paliek tikai servera izmaksas, uz kura tas darbojas.
Darbvirsmas lietotnes darbojas patstāvīgi. Serveris, ko dokumentācija stingri iesaka, pievieno tīmekļa un mobilo lietotni, sinhronizāciju starp ierīcēm, bankas sinhronizāciju un API. Katra ierīce glabā pilnu jūsu budžetu kopiju, sinhronizētu ar serveri.
Izveidojiet compose.yaml ar attēlu actualbudget/actual-server, portu 5006, publicētu uz 127.0.0.1, un datu mapi, piemontētu /data, pēc tam palaidiet docker compose up -d. Tad pirms tā novietojiet reverso starpniekserveri ar HTTPS un atveriet savu adresi, lai izvēlētos servera paroli.
Lietotnei vajadzīgs SharedArrayBuffer, ko pārlūkprogrammas ieslēdz tikai lapā, kas piedāvāta caur HTTPS ar galvenēm Cross-Origin-Embedder-Policy un Cross-Origin-Opener-Policy. Serveris iestata šīs galvenes; reversais starpniekserveris nodrošina HTTPS. Bez tā iztiek tikai piekļuve caur localhost.
Piedāvājiet instanci caur HTTPS, izvēlieties stipru servera paroli vai izmantojiet OpenID ar divfaktoru autentifikāciju un ieslēdziet pilnīgo šifrēšanu: serveris vairs nevar izlasīt jūsu budžetus. Glabājiet šo otro paroli drošā vietā, jo to nevar atgūt.
Jā, caur banku datu pakalpojuma sniedzēju, ar jūsu pašu piekļuves datiem: SimpleFIN Bridge, GoCardless Bank Account Data esošajiem kontiem, Pluggy.ai, kā arī Enable Banking un Akahu kā eksperimentālas funkcijas. Sinhronizācijai vajadzīgs serveris, un kopš versijas 26.11.0 tā var darboties automātiski.
Kopējiet servera datu mapi ar apturētu serveri: server-files glabā kontus un piekļuves datus, user-files budžetus. Eksportējiet arī katru budžetu no Settings, Export data, un glabājiet šīs kopijas šifrētas. Eksportu atjauno ar Import file.
Managed VPS aptver serveri: sistēmu, drošību, uzraudzību un rezerves kopijas. Mūsu komandas proaktīvi seko arī jūsu instancei un iesaka noderīgus labojumus, ko ieviešat jūs. Iejaukšanās lietojumprogrammā tiek rēķināta par stundu vai par fiksētu summu.
Simafri
Parunāsim par jūsu ieceri
Pasakiet mums dažos vārdos, kas jums vajadzīgs: mēs jums ātri atbildam.
Paldies! Jūsu pieprasījums ir nosūtīts. Drīzumā ar jums sazināsimies.
Labāk e-pastu? Rakstiet mums uz support@simafri.com.