Operatoriams

Kaip Aitvarą paleisti savuose serveriuose.

Du sluoksniai: panelė (ši svetainė) ir hiperizoriai (jūsų Proxmox / KVM). Pirmiausia stovi panelė. VM atsiranda tik prijungus adapterį.

1. Kraštas

Caddy ima 80/443, išrašo Let's Encrypt, atiduoda paneliui. Slapukai __Host- veikia tik čia.

2. Valdymo plokštuma

Šis kodas + Postgres. Katalogas, auth, krepšelis, eilė, IPAM, QoS, DDoS būsenos, NOC.

3. Adapteris

Užsakymas virsta createServer(). Mock — demonstracija. Proxmox API arba node-agent — tikri VM.

4. Hiperizoriai

Atskiri fiziniai ar dedicated serveriai. Panelė jų nediegia. Ji tik skirsto ir valdo.

01

Klientas

02

Caddy TLS

03

Panelė

04

Postgres

05

Adapteris

06

Mazgas

07

KVM VM

01

Ko reikia paneliui

  • Vienas Ubuntu 24.04 (ar pan.) su viešu IPv4 — 2 vCPU / 4 GB RAM užtenka
  • Domenas su A įrašu į tą IP (be HTTPS prisijungimas neveiks)
  • 80 ir 443 atidaryti; 22 palikite sau

Tai ne hiperizorius. Klientų VPS čia nesikuria. Panelė tik parduoda, skirsto ir valdo.

02

Viena komanda

Projekto šaknyje, pakeiskite domeną:

DOMAIN=aitvara.lt sudo bash deploy/install.sh

Skriptas įdiegia Docker, nukelia kodą į /opt/aitvara, sugeneruoja slaptažodžius ir paleidžia Postgres + panelę + Caddy. Po 20–40 s atidarykite https://aitvara.lt. Pirmoji registracija tampa super administratoriumi — eikite į /admin/deploy.

Atsisiųsti diegimo paketą(kodas be node_modules)

03

Ką Compose paleidžia

ServisasRolė
caddyViešas 80/443, Letʼs Encrypt, atvirkštinis proxy
appNitro panelė viduje :3000. Migracijos starte.
postgresVisas katalogas, sesijos, IPAM, QoS, ticketai

Slapukai vadinasi __Host-*. Naršyklė juos priima tik per HTTPS su Path=/. HTTP prisijungimo forma tyliai neįsirašys.

04

Aplinkos kintamieji

KintamasisPrasmė
DOMAINCaddy TLS vardas
BETTER_AUTH_URLViešas origin, https://aitvara.lt be slash
BETTER_AUTH_SECRET32+ baitai. Po keitimo visos sesijos krenta
POSTGRES_PASSWORDCompose Postgres
PROXMOX_*Gyvas Proxmox klasteris (nebūtina startui)
AGENT_URL / TOKENKVM node-agent (nebūtina startui)

Reikšmės gyvena /opt/aitvara/.env. Panelės konteineris jų neskaito iš naršyklės.

05

Tikri VPS: Proxmox

Datacenter → Permissions → API Tokens. Suteikite VM.Allocate, VM.Audit, VM.PowerMgmt, VM.Config. Nenaudokite root slaptažodžio.

Paruoškite QEMU šabloną su cloud-init (pvz. Ubuntu 24.04) ir įrašykite jo VMID.

PROXMOX_URL=https://pve.example:8006
PROXMOX_TOKEN_ID=aitvara@pve!panel
PROXMOX_TOKEN_SECRET=…
PROXMOX_NODE=pve
PROXMOX_STORAGE=local-lvm
PROXMOX_BRIDGE=vmbr0
PROXMOX_TEMPLATE=9000
PROXMOX_VERIFY_TLS=true
  1. Perleiskite Compose su atnaujintu .env
  2. NOC → Diegimas → Testuoti Proxmox
  3. NOC → Talpa: mazgą pve-vno-1 iš maintenance į online
  4. NOC → Tiekėjai: įjunkite pardavimus „Nuosavas Proxmox“

Placement variklis tada rinks šį mazgą. IP vis tiek skiria panelės IPAM — Proxmox gauna VM, o viešą adresą priskiriate pagal savo tinklą (bridge / cloud-init).

06

KVM be Proxmox: node-agent

deploy/node-agent/agent.mjs — mažas HTTP agentas hiperizoriuje. Jei yra qm, kuria VM per Proxmox CLI; jei virsh — libvirt; kitu atveju saugo būseną faile (laboratorija).

export AGENT_TOKEN="$(openssl rand -hex 24)"
sudo cp deploy/node-agent/aitvara-node.service /etc/systemd/system/
printf 'AGENT_TOKEN=%s\nAGENT_NODE_ID=kvm-vno-1\nAGENT_PORT=8787\n' "$AGENT_TOKEN" \
  | sudo tee /etc/aitvara-node/environment
sudo systemctl enable --now aitvara-node

Priešais agentą pastatykite Caddy su TLS. Panelyje: AGENT_URL=https://node1.jūsų.tld ir tas pats tokenas. Tada tas pats NOC ciklas: testas → mazgas online → pardavimai.

07

Kas veikia dabar, kas — vėliau

Veikia savame serveryje

  • Svetainė, krepšelis, auth, ticketai
  • Užsakymų eilė ir placement
  • QoS, DDoS būsenos, NOC
  • Proxmox API ir node-agent

Jungiama atskirai

  • Anycast BGP / scrubbing (DDoS kraštas)
  • cPanel / LiteSpeed / paštas
  • WHMCS mokėjimų gateway (dabar simuliacija)
  • Resellerio API vietoj mock_reseller

08

Atnaujinimas ir atsarginės kopijos

cd /opt/aitvara
sudo bash deploy/backup.sh
# įkelkite naują kodą, tada:
docker compose --env-file /opt/aitvara/.env -f deploy/docker-compose.yml up -d --build

Migracijos paleidžiamos konteinerio starte. Schema — failai `migrations/`.

09

Be Docker

Node 22 ir Postgres 16. Unit failas `deploy/aitvara.service`.

npm ci
export NITRO_PRESET=node-server VITE_AUTH_ENABLED=true VITE_SELFHOST=true
export DATABASE_URL=postgres://aitvara:PASS@127.0.0.1:5432/aitvara
export BETTER_AUTH_URL=https://aitvara.lt
export BETTER_AUTH_SECRET="$(openssl rand -hex 32)"
npm run build:selfhost
npm run start:selfhost

Caddy ar nginx į 127.0.0.1:3000. Slaptažodžių failas: /etc/aitvara/environment.

Atsisiųsti paketą

Po diegimo NOC skiltis „Diegimas“ rodo gyvą būseną.