Găzduirea Actual Budget pe un Managed VPS înseamnă să păstrați bugetele și sincronizarea lor pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Actual Budget este un instrument de finanțe personale de tip local-first, publicat sub licență MIT. Acest ghid urmează documentația sa oficială: rolul serverului, instalarea cu Docker Compose, HTTPS, parola serverului, OpenID, criptarea end-to-end, sincronizarea bancară, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 17 noiembrie 2026Timp de citire: 14 minute
SharedArrayBuffer, pe care browserele îl activează doar pe o pagină servită în HTTPS. Un proxy invers se ocupă de el.docker compose pull.Actual Budget este un instrument de finanțe personale de tip local-first, scris în Node.js, pe care README-ul său îl descrie ca fiind complet gratuit și open source. El păstrează toate datele dumneavoastră pe fiecare dintre dispozitive și le sincronizează în fundal cu serverul ales: aplicația funcționează chiar și fără conexiune, iar modificările ajung pe celelalte dispozitive de îndată ce rețeaua revine.
Proiectul este format dintr-un client și un server. Serverul este opțional, dar documentația îl recomandă insistent, deoarece deblochează mai multe funcții:
| Funcție | Fără server | Cu server |
|---|---|---|
| Bugete, rapoarte, programări | Da | Da |
| Importul tranzacțiilor dintr-un fișier | Da | Da |
| Importul și exportul fișierelor de buget | Da | Da |
| Aplicația în browser și pe telefon | Da | |
| Sincronizarea între dispozitive | Da | |
| Sincronizarea bancară | Da | |
| API-ul Actual | Da |
Actual Budget este publicat sub licența MIT, copyright James Long. Textul acordă gratuit oricui obține o copie dreptul de a folosi, copia, modifica, fuziona, publica, distribui, sublicenția și vinde copii ale acesteia.
Există o singură condiție: mențiunea de copyright și textul licenței însoțesc toate copiile sau părțile substanțiale ale software-ului. Puteți deci rula imaginea publicată de proiect pentru dumneavoastră, familia sau firma dumneavoastră, fără nicio licență de cumpărat.
Proiectul publică serverul ca imagine Docker, actualbudget/actual-server pe Docker Hub, și aceeași imagine în registrul GitHub, ghcr.io/actualbudget/actual. Pe un server unde Docker este instalat, creați un director și puneți în el acest compose.yaml, preluat din fișierul furnizat în depozit:
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, el este accesibil doar prin proxy-ul invers de pe același server, care adaugă HTTPS.actual-data conține tot ce păstrează serverul. Acesta creează acolo două subdirectoare, server-files și user-files, iar documentația subliniază că această montare vă păstrează datele atunci când containerul este șters.latest urmărește cea mai recentă versiune oficială, iar documentația o recomandă majorității utilizatorilor. latest-alpine oferă aceeași versiune pe o bază Alpine mai ușoară, iar o etichetă precum 26.11.0 fixează o versiune. Etichetele nightly urmăresc dezvoltarea, cu fiecare modificare a ramurii sale principale.Numele dumneavoastră de domeniu indică spre server prin înregistrări A și AAAA, iar vizitatorii ajung pe porturile 80 și 443. Cât timp HTTPS nu este instalat, aplicația nu se deschide: treceți direct la secțiunea următoare.
Proiectul nu indică nicio cifră pentru memorie sau procesor. Dimensiunea depinde de numărul de bugete, de istoricul lor și de numărul de dispozitive care se sincronizează. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă recomandăm dimensiunea potrivită.
Actual Budget se sprijină pe SharedArrayBuffer, o tehnologie a browserelor pe care documentația sa o descrie ca obligatorie: fără ea, aplicația nu pornește. Browserele o activează doar pe o pagină izolată, ceea ce cere două condiții:
localhost.Cross-Origin-Embedder-Policy cu valoarea require-corp și Cross-Origin-Opener-Policy cu valoarea same-origin. Serverul oficial le setează întotdeauna el însuși.Pentru a expune Actual pe internet, documentația cere să îl plasați în spatele unui proxy invers în HTTPS. Serverul poate servi și el însuși HTTPS cu un certificat pe care i-l dați, prin ACTUAL_HTTPS_KEY și ACTUAL_HTTPS_CERT: documentația descrie această cale pentru un server care rămâne în afara internetului.
Documentația prezintă Caddy ca un proxy invers simplu, care își obține și își reînnoiește singur certificatele. Iată exemplul său, adaptat pentru Caddy instalat pe server:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
Acest bloc preia configurația Nginx din documentație, redusă la portul 80, pentru a lăsa Certbot să instaleze HTTPS. El ascunde cele două antete trimise de Actual și le setează din nou, o singură dată: documentația avertizează că un antet dublat invalidează politica, iar aplicația se oprește atunci cu eroarea 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 ridică limita de dimensiune a Nginx, ca în exemplul din documentație, astfel încât un fișier de buget mare să ajungă la server. Certbot instalează apoi certificatul și se ocupă de reînnoirea lui:
sudo certbot --nginx
Deschideți adresa dumneavoastră în https, într-o filă nouă, mai degrabă decât reîncărcând o pagină care afișa o eroare, așa cum sfătuiește documentația. Apare ecranul de întâmpinare al Actual: HTTPS și antetele sunt la locul lor.
La prima pornire, ecranul de întâmpinare vă cere să alegeți o parolă pentru server: ea protejează accesul la bugetele dumneavoastră. Cât timp nu este setată niciuna, acest ecran se afișează primei persoane care deschide adresa. Deschideți-o deci de îndată ce HTTPS funcționează și alegeți o parolă lungă, folosită doar pentru acest server.
Serverul păstrează această parolă sub formă de hash, cu argon2, în fișierul account.sqlite din server-files, împreună cu lista fișierelor de buget pe care le cunoaște și tokenul sesiunii active.
Documentația furnizează o comandă care setează o parolă nouă fără a atinge fișierele sau datele dumneavoastră. Ea o cere de două ori:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password implicit, openid pentru un furnizor de identitate sau header.x-actual-password. Documentația avertizează că o greșeală de configurare la această etapă ar putea face instanța accesibilă întregului internet: rezervați-o acestor servicii.ACTUAL_ALLOWED_LOGIN_METHODS, o listă separată prin virgule.Pentru o autentificare mai solidă decât o parolă, documentația recomandă un furnizor OpenID: majoritatea oferă autentificare în doi pași. Tot el deschide serverul mai multor utilizatori. Referința de configurare prezintă această metodă ca o funcție în previzualizare.
https://budget.example.com/openid/callback.Aceeași configurație se poate pune și în config.json sau în variabile de mediu, cu un URL de descoperire atunci când furnizorul publică unul:
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"
Secretul se pune într-un fișier .env, lângă compose.yaml. Începând cu versiunea 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE îl poate citi și dintr-un fișier, ceea ce se potrivește secretelor Docker.
"authMethod": "oauth2", în config.json.ACTUAL_USER_CREATION_MODE cu valoarea login îi creează la prima lor conectare.ACTUAL_OPENID_ENFORCE cu valoarea true o face singura metodă de conectare acceptată.ACTUAL_TOKEN_EXPIRATION este implicit never. Ea poate urma durata furnizorului, cu openid-provider, sau o durată în secunde.Pe lângă parola serverului, fiecare buget poate fi criptat end-to-end. Datele sale sunt atunci criptate pe dispozitivul dumneavoastră, cu o cheie derivată dintr-o a doua parolă, înainte de a pleca: serverul doar transmite modificări pe care nu le poate citi.
Documentația este clară: o parolă de criptare uitată nu poate fi recuperată. Dacă mai există o copie locală a bugetului, puteți genera o cheie nouă, ceea ce resetează sincronizarea. Criptarea nu poate fi nici ea dezactivată: revenirea la un fișier necriptat trece printr-un export, apoi un import.
| Protecție | Ce aduce | Unde se setează |
|---|---|---|
| HTTPS | Criptează traseul dintre dispozitivele dumneavoastră și server și permite pornirea aplicației | Proxy-ul invers |
| Parola serverului | Restrânge accesul la bugete, păstrată ca hash argon2 pe server | La prima pornire, apoi în setări |
| OpenID | Autentificarea în doi pași a furnizorului dumneavoastră și un cont pentru fiecare persoană | La furnizor, apoi în setări |
| Criptarea end-to-end | Face bugetele ilizibile pentru server și pentru backupurile sale | În fiecare buget |
| Criptarea discului | Protejează copia locală, despre care documentația notează că este necriptată | Pe fiecare dintre dispozitivele dumneavoastră |
Criptarea end-to-end acoperă datele bugetelor. Datele de acces pentru sincronizarea bancară sunt păstrate pe server, în account.sqlite, în afara acestei criptări: protejați în consecință accesul la server și la backupurile sale.
Actual importă tranzacțiile dumneavoastră dintr-un fișier, fără nicio configurare. El le poate prelua și direct de la banca dumneavoastră, printr-un furnizor de date bancare. Această sincronizare este opțională, cere serverul și se sprijină pe propriile dumneavoastră date de acces: vă deschideți un cont la furnizor și creați acolo cheile pe care i le dați lui Actual. Aceste chei sunt păstrate pe server și le introduceți o singură dată.
| Furnizor | Băncile acoperite, potrivit documentației | Starea la versiunea 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Bănci nord-americane | Suportat; date de acces pe buget posibile începând cu 26.11.0 |
| GoCardless Bank Account Data | Bănci europene | Suportat pentru conturile existente: GoCardless nu mai acceptă conturi noi din iulie 2025 |
| Pluggy.ai | Bănci braziliene | Suportat |
| Enable Banking | Bănci europene | Funcție experimentală |
| Akahu | Bănci neozeelandeze | Funcție experimentală |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. Punțile SimpleFIN publice nu cer nicio setare.Fiecare dispozitiv păstrează o copie completă a bugetelor dumneavoastră, iar serverul păstrează încă una. Un backup bun le acoperă pe amândouă: directorul de date al serverului și un export al fiecărui buget.
| Element | Ce păstrează | De salvat |
|---|---|---|
server-files/account.sqlite | Parola sub formă de hash, lista bugetelor, sesiunile, conturile OpenID și datele de acces bancare | Obligatoriu, criptat |
user-files/ | Fișierele de buget, ca fișiere binare | Obligatoriu |
config.json | Configurația serverului, dacă ați creat una | Recomandat, criptat |
| Exportul fiecărui buget | Un fișier zip cu baza db.sqlite și metadata.json | Recomandat |
Tot ce păstrează serverul se află în actual-data. Cu serverul oprit, el poate fi copiat dintr-odată, cu bazele SQLite în repaus:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Programați această copiere pe server, criptați-o și păstrați o copie în altă parte. Pusă pe discul serverului, ea intră și în backupurile sale de noapte.
Dintr-un buget deschis: Settings, secțiunea Data, Export data. Fișierul poate fi păstrat oriunde doriți și se redeschide fără server. Documentația folosește acest export pentru a reveni de la un buget criptat la un fișier necriptat: el vă conține datele în clar, așa că păstrați-l într-un loc sigur.
Un buget vechi dă un export voluminos, deoarece Actual păstrează în fișier fiecare modificare. Documentația sfătuiește atunci Reset sync, în setările avansate, înainte de export: istoricul este compactat într-un singur fișier, iar dimensiunea scade puternic.
Pe celelalte dispozitive, alegeți apoi acest buget din lista de fișiere: el se descarcă, apoi se sincronizează. Aplicațiile desktop își păstrează și propriile backupuri automate, câte unul pentru fiecare dintre ultimele zece zile de utilizare și mai multe pentru ziua curentă.
Documentația dă comanda, din directorul fișierului compose.yaml. Directorul de date rămâne pe loc:
docker compose pull
docker compose up -d
Versiunile sunt numerotate după an și lună: 26.11.0 a apărut la 1 noiembrie 2026, iar ultimele versiuni au fost publicate la începutul fiecărei luni. Citiți-le notele înainte de actualizare și exportați-vă bugetele chiar înainte, așa cum recomandă documentația. Notele semnalează schimbările de prevăzut, precum lista rețelelor SimpleFIN autorizate în 26.11.0 sau trecerea imaginii Ubuntu la Node.js 24 în 26.9.0, care a retras-o de pe procesoarele ARM pe 32 de biți în favoarea imaginii Alpine.
nightly: revenirea de la nightly la latest poate lăsa un buget ilizibil pentru versiunea stabilă. Documentația descrie remedierea și cere backupuri ale bugetelor cu aceste etichete.Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Actual Budget rămâne software-ul dumneavoastră, cu setările sale și bugetele dumneavoastră.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Citirea jurnalelor instanței dumneavoastră |
| Actual Budget | Urmărire proactivă: erori, încetiniri și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Accesele și bugetele | Serverul care le poartă, supravegheat și salvat | Parola serverului, OpenID, utilizatorii și criptarea end-to-end |
| Sincronizarea bancară | Serverul care îi păstrează datele de acces, supravegheat și salvat | Alegerea furnizorului, cheile sale și conturile legate |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Exporturile bugetelor dumneavoastră și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Actual Budget, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Actual Budget este publicat sub licență MIT: îl puteți folosi, modifica și redistribui liber, pentru dumneavoastră sau pentru o firmă, cu condiția ca mențiunea sa de copyright și de licență să rămână în copii. Rămâne costul serverului pe care rulează.
Aplicațiile desktop funcționează singure. Serverul, pe care documentația îl recomandă insistent, adaugă aplicația web și mobilă, sincronizarea între dispozitive, sincronizarea bancară și API-ul. Fiecare dispozitiv păstrează o copie completă a bugetelor dumneavoastră, sincronizată cu serverul.
Creați un compose.yaml cu imaginea actualbudget/actual-server, portul 5006 publicat pe 127.0.0.1 și un director de date montat pe /data, apoi rulați docker compose up -d. Puneți apoi în față un proxy invers în HTTPS și deschideți adresa dumneavoastră pentru a alege parola serverului.
Aplicația are nevoie de SharedArrayBuffer, pe care browserele îl activează doar pe o pagină servită în HTTPS, cu antetele Cross-Origin-Embedder-Policy și Cross-Origin-Opener-Policy. Serverul setează aceste antete; proxy-ul invers aduce HTTPS. Doar accesul prin localhost se descurcă fără el.
Serviți instanța în HTTPS, alegeți o parolă de server solidă sau folosiți OpenID cu autentificare în doi pași și activați criptarea end-to-end: serverul nu vă mai poate citi bugetele. Păstrați această a doua parolă într-un loc sigur, deoarece nu poate fi recuperată.
Da, printr-un furnizor de date bancare, cu propriile dumneavoastră date de acces: SimpleFIN Bridge, GoCardless Bank Account Data pentru conturile existente, Pluggy.ai, precum și Enable Banking și Akahu ca funcții experimentale. Sincronizarea cere serverul și poate rula automat începând cu versiunea 26.11.0.
Copiați directorul de date al serverului cu serverul oprit: server-files conține conturile și datele de acces, user-files bugetele. Exportați și fiecare buget din Settings, Export data, și păstrați aceste copii criptate. Un export se restaurează cu Import file.
Un Managed VPS acoperă serverul: sistemul, securitatea, monitorizarea și backupurile. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.