ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
docs: catch README/CHANGELOG/feature reference up to the unreleased dev work
Juan Denisae177d789c27
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 9a2a8d4b..34088956 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -43,6 +43,35 @@ awaiting a stable release:`/git`).- **RHEL-family support** — the installer now covers Rocky, AlmaLinux, RHEL, andCentOS in addition to Ubuntu/Debian/Fedora.+- **Per-app Web Application Firewall** — ModSecurity v3 + OWASP Core Rule Set+ with detect/block modes, paranoia tuning, a disabled-rule editor, one-click+ apply (nginx include injection), and parsed audit-log events.+- **Container lifecycle controls** — image-update detection with one-click+ apply, idle container auto-sleep, and CPU-driven horizontal auto-scaling, with+ cron-drivable sweeps for the sleep/scale policies.+- **GPU monitoring** — NVIDIA utilization, memory, temperature, power, and+ per-process / per-container usage.+- **Dynamic DNS** — token-authenticated A/AAAA updates synced through a+ connected DNS provider (e.g. Cloudflare).+- **Secrets manager & inbound webhook gateway** — encrypted secret storage and+ inbound webhook endpoints for triggering automation.+- **Passkeys / WebAuthn** — passwordless and second-factor authentication with+ hardware keys, Touch ID, and Windows Hello.+- **Layout switcher** — full sidebar, compact rail, and top-bar shell variants.+- **Guided installer / updater** — health-checked install and update flow with+ automatic rollback.++### Security++- **Container CVE scanning & SBOM** — per-image vulnerability scans with grype+ and software bill-of-materials generation with syft.+- **Optional, hardened TLS** — best-effort HTTPS that never blocks an install+ (falls back to HTTP), a server-wide TLS 1.2+/AEAD-cipher floor applied at+ install and update, Cloudflare-aware nginx configs, automatic CAA records on+ certificate issuance, and HSTS gated on the operator's recorded SSL choice so+ HTTPS stays optional.+- **Encryption at rest** — system-setting secrets and DNS/cloud provider+ credentials sealed with Fernet; optional client-side backup encryption.### Changeddiff --git a/README.md b/README.mdindex 8bd97693..167a0b9d 100644--- a/README.md+++ b/README.md@@ -56,15 +56,19 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P**Docker** — Full container and Docker Compose management with real-time log streaming and terminal access+**Container Lifecycle** — Image-update detection with one-click apply, auto-sleep for idle containers, and CPU-driven horizontal auto-scaling+**Marketplace** — Over 60+ one-click templates for popular apps (Immich, Ghost, Authelia, etc.)### 🏗️ Infrastructure**Domain Management** — Nginx virtual hosts with easy configuration-**DNS Zone Management** — Full DNS record management with propagation checking (A, AAAA, CNAME, MX, TXT, etc.)+**DNS Zone Management** — Full DNS record management with propagation checking (A, AAAA, CNAME, MX, TXT, CAA, etc.)++**Dynamic DNS** — Token-authenticated A/AAAA updates for home servers and changing IPs, synced through your DNS provider-**SSL Certificates** — Automatic Let's Encrypt with auto-renewal+**SSL / TLS** — Automatic Let's Encrypt with auto-renewal, optional (best-effort) HTTPS that never blocks an install, hardened TLS 1.2+/AEAD ciphers, Cloudflare-aware configs, and automatic CAA records**Databases** — MySQL/MariaDB and PostgreSQL with user management and query interface@@ -78,7 +82,9 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P**FTP Server** — Manage vsftpd users and access-**Backup & Restore** — Automated backups to S3, Backblaze B2, or local storage with scheduling, retention policies, and one-click restore+**Backup & Restore** — Automated backups to S3, Backblaze B2, or local storage with scheduling, retention policies, one-click restore, and optional client-side encryption++**Secrets & Webhook Gateway** — Encrypted secrets store plus an inbound webhook gateway for triggering automation from external events**Email Server** — Postfix + Dovecot with DKIM/SPF/DMARC, SpamAssassin, Roundcube webmail, email forwarding rules@@ -86,6 +92,10 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P**Two-Factor Auth** — TOTP-based with backup codes+**Passkeys / WebAuthn** — Passwordless and second-factor sign-in with hardware keys, Touch ID, and Windows Hello++**Web Application Firewall** — Per-app ModSecurity v3 + OWASP Core Rule Set with detect/block modes, tunable paranoia, and audit-log events+**Malware Scanning** — ClamAV integration with quarantine**File Integrity Monitoring** — Detect unauthorized file changes@@ -94,6 +104,10 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P**Vulnerability Scanning** — Lynis security audits with reports and recommendations+**Container CVE Scanning & SBOM** — Per-image vulnerability scanning with grype and software bill-of-materials generation with syft++**Encrypted Secrets at Rest** — Provider credentials and system-setting secrets sealed with Fernet encryption+**Automatic Updates** — unattended-upgrades / dnf-automatic for OS-level patching### 🖥️ Multi-Server Management@@ -122,6 +136,8 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P**Real-time Metrics** — CPU, RAM, disk, network monitoring via WebSocket+**GPU Monitoring** — NVIDIA GPU utilization, memory, temperature, and power, with per-process and per-container usage+**Uptime Tracking** — Historical server uptime data and visualization**Status Pages** — Public status pages with HTTP/TCP/DNS/Ping health checks, component monitoring, and incident management@@ -148,6 +164,8 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P### 🎨 Customization+**Layout Switcher** — Switch the app shell between full sidebar, compact rail, and top-bar layouts+**Sidebar Presets** — Switch between Full, Web Hosting, Email Admin, DevOps, and Minimal views with one click**Collapsible Navigation** — Sidebar groups auto-expand on navigation and collapse when switching sections@@ -302,6 +320,14 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions- [x] Status pages — Public status pages with health checks, incident management- [x] Cloud provisioning — DigitalOcean, Hetzner, Vultr, Linode with cost tracking- [x] Customizable sidebar — Collapsible groups, view presets, accent colors, white-label branding+- [x] Web Application Firewall — Per-app ModSecurity v3 + OWASP CRS+- [x] Container security — Image CVE scanning (grype) + SBOM (syft)+- [x] Passwordless auth — WebAuthn / passkeys+- [x] Dynamic DNS — Token-authenticated A/AAAA updates+- [x] GPU monitoring — NVIDIA utilization, memory, and processes+- [x] Container lifecycle — Image-update apply, auto-sleep, horizontal auto-scaling+- [x] TLS hardening — Optional HTTPS, Cloudflare-aware configs, automatic CAA+- [x] Secrets manager & inbound webhook gatewayFull details: [ROADMAP.md](ROADMAP.md)@@ -317,6 +343,7 @@ Full details: [ROADMAP.md](ROADMAP.md)| [Agent](agent/README.md) | Install & run the multi-server agent (Linux/Windows/macOS) || [Agent Pairing](docs/pairing.md) | Secure short-code agent enrollment || [API Reference](docs/API.md) | REST API endpoints |+| [New Features](docs/NEW_FEATURES.md) | Endpoint & page reference for the latest `dev` features || [Changelog](CHANGELOG.md) | Release history and notable changes || [Roadmap](ROADMAP.md) | Development roadmap and planned features || [Contributing](CONTRIBUTING.md) | How to contribute |@@ -332,8 +359,8 @@ Full details: [ROADMAP.md](ROADMAP.md)| Database | SQLite / PostgreSQL || Web Server | Nginx, Gunicorn (GeventWebSocket) || Containers | Docker, Docker Compose |-| Security | ClamAV, Lynis, Fail2ban, TOTP (pyotp), Fernet encryption |-| Auth | JWT, OAuth 2.0, OIDC, SAML 2.0 |+| Security | ClamAV, Lynis, Fail2ban, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), Fernet encryption |+| Auth | JWT, OAuth 2.0, OIDC, SAML 2.0, WebAuthn / passkeys || Email | Postfix, Dovecot, SpamAssassin, Roundcube || Agent | Go (multi-server), HMAC-SHA256, WebSocket |diff --git a/docs/NEW_FEATURES.md b/docs/NEW_FEATURES.mdindex 3df8f0ce..f837150d 100644--- a/docs/NEW_FEATURES.md+++ b/docs/NEW_FEATURES.md@@ -1,9 +1,10 @@# New Features — Endpoint & Page Reference-Reference for the features added on `dev` (12 feature commits, `cd16d9a … 70883d5`).-All endpoints are under `/api/v1`. "admin" = requires `user.is_admin`; "edit" =-`_can_edit_app` (owner or admin); "auth" = any valid JWT. Tables auto-create on-startup via `db.create_all()`.+Reference for the features added on `dev` — the 12 UI/Docker/WAF feature commits+(`cd16d9a … 70883d5`) plus the SSL/TLS hardening follow-up (`02afdec … a09bf0f`,+see §6). All endpoints are under `/api/v1`. "admin" = requires `user.is_admin`;+"edit" = `_can_edit_app` (owner or admin); "auth" = any valid JWT. Tables+auto-create on startup via `db.create_all()`.---@@ -119,7 +120,58 @@ Requires a scale-capable compose service (no fixed host port / `container_name`)----## 6. Known follow-ups+## 6. SSL/TLS hardening & optional HTTPS (security follow-up — `02afdec … a09bf0f`)++HTTPS is **optional and best-effort** — the installer never blocks on SSL, and the+panel never forces it. Hardening is applied so that *when* TLS is served, it's+strong; it stays inert in HTTP-only mode.++**Install/update (`install.sh`, `scripts/update.sh`)**+- Best-effort cert: tries Let's Encrypt (webroot); on failure falls back to plain+ HTTP instead of failing the install. `SERVERKIT_SKIP_SSL=1` forces HTTP.+- Two panel vhosts: `serverkit.conf` (HTTPS + HTTP→HTTPS redirect) and+ `serverkit-insecure.conf` (HTTP-only). The choice persists to+ `/etc/serverkit/ssl-mode` and is preserved across updates.+- **Server-wide TLS floor**: `harden_global_tls()` rewrites/injects+ `ssl_protocols TLSv1.2 TLSv1.3` + AEAD-only `ssl_ciphers` in the system+ `nginx.conf` `http{}`, so the default server and any non-ServerKit vhost are+ covered too. Edited in place to avoid nginx's duplicate-directive error on+ Debian/Ubuntu. `update.sh` re-applies it to existing installs.+- Cloudflare-aware configs (Origin CA option + dashboard guidance) in+ `nginx/sites-available/*`.++**Per-app vhosts (`services/nginx_service.py` `SSL_BLOCK`)** — HSTS+(`includeSubDomains; preload`), CSP, `X-Content-Type-Options`, `X-Frame-Options`,+`Referrer-Policy`, and `ssl_ecdh_curve`, in addition to the TLS 1.2/1.3 + AEAD set.++**Auto-CAA on certificate issuance** — `ssl_service.obtain_certificate` calls+`DNSProviderService.ensure_caa_record(domain)` (best-effort, never fails the cert).+It creates `CAA 0 issue "letsencrypt.org"` at the **zone apex** via whichever+connected provider manages the domain (Cloudflare / DigitalOcean / Route53), and+degrades to manual instructions otherwise. Cloudflare/DigitalOcean need CAA's+structured `data` object (not a flat string) — handled. The cert response gains a+`caa: {created, provider, zone, record, …}` field. The default DNS zone+`web-hosting` preset also seeds a CAA record.++**HSTS gating (panel)** — the Flask security middleware emits HSTS **only when the+deployment terminates real HTTPS**, resolved as `SSL_MODE` / `HSTS_ENABLED` in+`config.py`. Behind nginx/Cloudflare, Flask can't tell real TLS from a Cloudflare+Flexible edge via `X-Forwarded-Proto`, so it trusts the operator's recorded choice+rather than the request scheme. The nginx edge emits HSTS independently in its+secure server block.++| Setting | Where | Purpose |+|---|---|---|+| `SERVERKIT_SKIP_SSL=1` | env (installer) | Skip HTTPS entirely; run on plain HTTP. |+| `SERVERKIT_SSL_MODE` | env / `.env` | `secure`\|`insecure` — gates the panel's HSTS header. |+| `/etc/serverkit/ssl-mode` | file | Persisted SSL mode (read by installer, updater, and `config._resolve_ssl_mode`). |+| `/etc/serverkit/panel-domain` | file | Persisted panel domain so `update.sh` re-applies the cert path without the old (broken) `.env` scrape. |++Proving tests: `backend/tests/test_dns_caa.py`, `backend/tests/test_security_headers.py`.++---++## 7. Known follow-ups- Migration import (cPanel/CyberPanel) — not started; needs real archive samples.- Backups: additional remote targets (WebDAV/Azure/Dropbox/SFTP), streaming