Găzduirea Actual Budget pe un Managed VPS: bugetele pe propriul server

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.

Simon Vasconcelos Lee Autor: Publicat la 17 noiembrie 2026Timp de citire: 14 minute

Toate ghidurile

Esențialul

  1. Licența MIT permite folosirea, modificarea și redistribuirea liberă a Actual Budget, cu condiția ca mențiunea sa de copyright și de licență să rămână în copii.
  2. Serverul vă sincronizează bugetele între dispozitive și servește aplicația web: instalați-l cu Docker Compose, o imagine și un director de date.
  3. HTTPS este indispensabil: aplicația are nevoie de SharedArrayBuffer, pe care browserele îl activează doar pe o pagină servită în HTTPS. Un proxy invers se ocupă de el.
  4. Deschideți adresa dumneavoastră chiar de la prima pornire a serverului pentru a alege parola serverului. OpenID adaugă autentificarea în doi pași a furnizorului dumneavoastră și mai mulți utilizatori.
  5. Criptarea end-to-end opțională face bugetele ilizibile pentru server. Salvați directorul de date și exportați bugetele, apoi actualizați cu docker compose pull.

Ce face Actual Budget și rolul serverului său

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țieFără serverCu server
Bugete, rapoarte, programăriDaDa
Importul tranzacțiilor dintr-un fișierDaDa
Importul și exportul fișierelor de bugetDaDa
Aplicația în browser și pe telefonDa
Sincronizarea între dispozitiveDa
Sincronizarea bancarăDa
API-ul ActualDa

Ce permite licența MIT

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.

Instalarea cu Docker Compose

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:

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

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

HTTPS: o condiție pentru pornirea aplicației

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:

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.

Cu Caddy

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:

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

Cu Nginx și Certbot

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.

Bloc Nginx
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:

Terminal
sudo certbot --nginx

Verificarea

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.

Parola serverului

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.

Resetarea unei parole uitate

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:

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

OpenID și mai mulți utilizatori

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.

  1. Înregistrați Actual la furnizorul dumneavoastră, cu URI-ul de redirecționare https://budget.example.com/openid/callback.
  2. Într-un buget deschis, mergeți la setări și faceți clic pe Start using OpenID, apoi completați furnizorul, ID-ul clientului și secretul său.
  3. Conectați-vă cu OpenID. Documentația avertizează că prima persoană care se conectează devine administratorul și proprietarul serverului, un rol care nu mai poate fi schimbat din interfață: asigurați-vă că vă conectați primul.

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:

compose.yaml, în serviciu
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.

Criptarea end-to-end

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.

  1. Deschideți bugetul, mergeți la setări, secțiunea Encryption, și faceți clic pe Enable encryption.
  2. Alegeți o parolă diferită de parola serverului.
  3. Pe fiecare dintre celelalte dispozitive, introduceți această aceeași parolă o singură dată, la prima descărcare a bugetului.

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țieCe aduceUnde se setează
HTTPSCriptează traseul dintre dispozitivele dumneavoastră și server și permite pornirea aplicațieiProxy-ul invers
Parola serveruluiRestrânge accesul la bugete, păstrată ca hash argon2 pe serverLa prima pornire, apoi în setări
OpenIDAutentificarea în doi pași a furnizorului dumneavoastră și un cont pentru fiecare persoanăLa furnizor, apoi în setări
Criptarea end-to-endFace bugetele ilizibile pentru server și pentru backupurile saleÎn fiecare buget
Criptarea disculuiProtejează 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.

Sincronizarea bancară

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

FurnizorBăncile acoperite, potrivit documentațieiStarea la versiunea 26.11.0
SimpleFIN BridgeBănci nord-americaneSuportat; date de acces pe buget posibile începând cu 26.11.0
GoCardless Bank Account DataBănci europeneSuportat pentru conturile existente: GoCardless nu mai acceptă conturi noi din iulie 2025
Pluggy.aiBănci brazilieneSuportat
Enable BankingBănci europeneFuncție experimentală
AkahuBănci neozeelandezeFuncție experimentală

Backupurile

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.

ElementCe păstreazăDe salvat
server-files/account.sqliteParola sub formă de hash, lista bugetelor, sesiunile, conturile OpenID și datele de acces bancareObligatoriu, criptat
user-files/Fișierele de buget, ca fișiere binareObligatoriu
config.jsonConfigurația serverului, dacă ați creat unaRecomandat, criptat
Exportul fiecărui bugetUn fișier zip cu baza db.sqlite și metadata.jsonRecomandat

Directorul serverului

Tot ce păstrează serverul se află în actual-data. Cu serverul oprit, el poate fi copiat dintr-odată, cu bazele SQLite în repaus:

Terminal, în directorul fișierului compose.yaml
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.

Exportul fiecărui buget

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.

Restaurarea

  1. Închideți bugetul deschis: faceți clic pe numele lui în stânga sus, apoi pe Switch file.
  2. Faceți clic pe Import file, alegeți Actual, apoi fișierul zip al exportului.
  3. Bugetul importat apare lângă original: verificați-l, redenumiți-l dacă e nevoie, apoi ștergeți vechea copie.

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

Actualizările

Documentația dă comanda, din directorul fișierului compose.yaml. Directorul de date rămâne pe loc:

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

Cine ce face pe un Managed VPS

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

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulCitirea jurnalelor instanței dumneavoastră
Actual BudgetUrmă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 bugeteleServerul care le poartă, supravegheat și salvatParola serverului, OpenID, utilizatorii și criptarea end-to-end
Sincronizarea bancarăServerul care îi păstrează datele de acces, supravegheat și salvatAlegerea 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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

Actual Budget, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este Actual Budget 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ă.

Am nevoie de un server pentru a folosi Actual Budget?

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.

Cum instalez Actual Budget cu Docker Compose?

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.

De ce cere Actual Budget HTTPS?

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.

Cum protejez datele unui buget Actual?

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

Se conectează Actual Budget la banca mea?

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.

Cum fac backup la Actual Budget?

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.

Acoperă un Managed VPS și Actual Budget?

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.

Surse și documentație oficială

Ghiduri conexe

Diferența dintre VPS administrat și neadministrat: cine ce faceDiferența dintre un VPS administrat și unul neadministrat ține de o singură întrebare: cine se ocupă de server după ce acesta funcționează. Totuși, „administrat” (managed) nu are o definiție oficială: de la un furnizor la altul, cuvântul acoperă orice, de la simpla instalare a sistemului până la exploatarea completă a serverului. Acest ghid arată cine ce face, rând cu rând, inclusiv la nivelul intermediar al asistenței, și oferă întrebările care înlătură ambiguitatea înainte de semnare.Backupurile unui VPS: ce trebuie să verificați înainte de a semnaO ofertă de VPS anunță aproape mereu „backupuri incluse”. În spatele acestor două cuvinte se poate afla o copie făcută în fiecare noapte, păstrată în afara mașinii și restaurată de experți, sau un snapshot pus pe același disc ca serverul. Acest ghid prezintă întrebările care fac diferența, ce înseamnă fiecare răspuns și modul de a verifica faptul că un backup se poate restaura.Găzduirea Vaultwarden pe un Managed VPS: parolele pe propriul serverGăzduirea Vaultwarden pe un Managed VPS înseamnă să păstrați parolele dumneavoastră și pe cele ale echipei pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Vaultwarden este un software liber sub licență AGPL-3.0. Acest ghid urmează documentația sa oficială: instalarea cu Docker Compose, HTTPS, închiderea înregistrărilor, tokenul de administrare, ceea ce protejează seiful, baza de date, e-mailurile, backupurile și actualizările.
Contactați-ne