Sari la conținut
PortDock

Ghid de instalare

PortDock rulează pe orice server Linux pe care îl controlezi — un VPS, o mașină din data center sau o mașină virtuală on-premises — și pe Kubernetes.

Cerințe

  • Un server Linux — recomandat Ubuntu sau Debian — cu acces root
  • Porturile 80 și 443 libere pentru proxy-ul HTTPS
  • Memorie suficientă pentru aplicațiile și bazele tale de date (SQL Server are nevoie de circa 2 GB)
  • Docker — installer-ul îl adaugă dacă lipsește
  • Pentru Kubernetes dintr-o comandă: un server nou și o înregistrare DNS (A) a domeniului tău care indică spre el

01

Varianta 1 — installer

Instalează Docker dacă lipsește și pornește PortDock. Adaugă un domeniu care indică spre server ca să ai HTTPS pentru dashboard.

Shell
$ git clone https://github.com/gavrilencu/PortDock.git portdock && cd portdock$ sudo bash install.sh                               # dashboard pe http://<ip-server>:8000$ sudo bash install.sh https://portdock.example.com  # sau cu un domeniu

Dacă portul 8000 e ocupat, installer-ul alege următorul port liber și afișează adresa (sau setează PORTDOCK_PORT=9000).

02

Varianta 2 — imaginea Docker

Când Docker este deja instalat.

Shell
$ docker run -d --name portdock --restart unless-stopped \  -p 8000:8000 \  -v /var/run/docker.sock:/var/run/docker.sock \  -v /data/portdock:/data/portdock \  -e PORTDOCK_PUBLIC_URL=http://<ip-server>:8000 \  ghcr.io/gavrilencu/portdock:latest

Păstrează directorul de date montat la aceeași cale ca pe host (/data/portdock): build-urile și backup-urile sunt montate în containere auxiliare după calea absolută.

03

Varianta 3 — Kubernetes pe un server nou, totul într-o comandă

Îți cere domeniul dashboard-ului, apoi instalează k3s, cert-manager cu Let's Encrypt, Docker pentru build-uri și un registry privat și pornește PortDock pe https://domeniul-tău, cu serverele test și prod gata pregătite.

Shell
$ curl -fsSL https://github.com/gavrilencu/PortDock/releases/latest/download/install-kubernetes.sh | sudo bash

La final afișează un link cu un token de configurare: îl deschizi ca să îți creezi contul de owner, așa că nimeni altcineva nu poate prelua dashboard-ul înaintea ta. Actualizările următoare se fac din interfață; rulat din nou, installer-ul repară configurarea și păstrează parolele și datele.

04

Varianta 4 — un cluster Kubernetes existent

PortDock rulează în cluster și face deploy în el cu propriul service account.

Shell
$ kubectl apply -f https://raw.githubusercontent.com/gavrilencu/PortDock/main/deploy/kubernetes/portdock.yaml$ kubectl -n portdock rollout status statefulset/portdock$ kubectl -n portdock port-forward svc/portdock 8000:8000   # apoi deschizi http://localhost:8000

Ca să faci deploy într-un cluster dintr-un PortDock care rulează pe un server Docker, rulezi connect.sh acolo unde kubectl ajunge la cluster și lipești kubeconfig-ul afișat în Servere → Conectează server → Cluster Kubernetes.

Apoi

  1. 01

    Creezi contul de owner

    Deschizi dashboard-ul; primul cont devine proprietarul organizației.

  2. 02

    Pornești proxy-ul

    Servere → localhost → Rulează configurarea instalează rețeaua și proxy-ul Traefik (pe Kubernetes se ocupă controllerul de ingress al clusterului).

  3. 03

    Conectezi codul

    Setări → Surse Git: conectezi GitHub sau Azure DevOps ori folosești orice URL Git.

  4. 04

    Lansezi

    Resursă nouă → repozitoriu Git, imagine Docker, Compose, bază de date sau serviciu.

Adăugarea serverelor la distanță

  1. 1.Servere → Conectează server și generezi o cheie SSH.
  2. 2.Adaugi cheia publică în ~/.ssh/authorized_keys pe server (recomandat utilizatorul root).
  3. 3.Apeși Rulează configurarea: instalează Docker, rețeaua portdock și proxy-ul Traefik.
  4. 4.Opțional: setezi un domeniu wildcard (*.apps.example.com → IP-ul serverului) pentru domenii automate și preview-uri.

Configurare

Variabilele de mediu ale containerului PortDock.

VariabilăImplicitDescriere
PORTDOCK_ADDR:8000Adresa HTTP pe care ascultă
PORTDOCK_PORT8000Portul de pe host folosit de install.sh și docker-compose.yml
PORTDOCK_DATA_DIR/data/portdockBaza de date, cheia de criptare, build-urile și backup-urile
PORTDOCK_PUBLIC_URLhttp://localhost:8000URL-ul extern, folosit pentru webhook-uri; https:// activează cookie-urile securizate
PORTDOCK_SECRET_KEYgeneratăCheia AES pentru secrete — fă-i backup
PORTDOCK_MAX_BUILDS4Deploy-uri în paralel
PORTDOCK_NETWORKportdockRețeaua Docker comună cu Traefik
PORTDOCK_OPENROUTER_URLhttps://openrouter.ai/api/v1API-ul folosit de asistentul AI
PORTDOCK_TRUSTED_PROXIESrețele privateProxy-urile al căror X-Forwarded-For este de încredere pentru adresele clienților
PORTDOCK_SETUP_TOKEN–Necesar pentru crearea contului de owner; setat de installer-ul Kubernetes
PORTDOCK_KUBE_SERVERS–Într-un cluster: serverele create odată cu contul de owner (perechi nume=namespace)

Actualizări

PortDock verifică dacă există o versiune nouă ori de câte ori îl deschizi și afișează Actualizare disponibilă în bara laterală. Un click verifică semnătura imaginii noi, face backup la baza de date și la cheie, recreează PortDock cu versiunea nouă și revine automat dacă aceasta nu pornește. Aplicațiile rulează în tot acest timp; poți activa și actualizările automate pe timp de noapte. La fel și în Kubernetes: un job al versiunii curente trece PortDock pe versiunea nouă și revine la cea anterioară dacă aceasta nu pornește.

Recuperare din linia de comandă

Ai rămas fără acces? Resetezi o parolă sau dezactivezi autentificarea în doi pași direct de pe server.

Shell
$ docker exec portdock portdock -reset-password admin@example.com$ docker exec portdock portdock -disable-2fa user@example.com$ # pe Kubernetes$ kubectl -n portdock exec statefulset/portdock -- portdock -reset-password admin@example.com

Dezvoltare

Backend în Go și frontend în React; contribuțiile sunt binevenite.

Shell
$ make dev-api   # backend pe :8000$ make dev-ui    # Vite pe :5173$ make test      # go vet, go test și verificarea TypeScript$ make build     # bin/portdock cu interfața inclusă