Skip to content

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.

docs(readme): refresh the English README and rebuild all three translations

Juan Denisa83dbd3e374f
diff --git a/README.md b/README.md
index dd711320..09ab29bd 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
<div align="center">
-# ServerKit
-
<img width="100%" alt="ServerKit — Deploy, manage, and monitor servers" src="docs/screenshots/poster.png" />
+# ServerKit
+
**Deploy, manage, and monitor servers.**
A lightweight, modern server control panel for managing web apps, databases,
@@ -19,6 +19,7 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
[![Discord](https://img.shields.io/discord/1470639209059455008?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/ZKk6tkCQfG)
[![GitHub Stars](https://img.shields.io/github/stars/jhd3197/ServerKit?style=flat-square&color=f5c542)](https://github.com/jhd3197/ServerKit/stargazers)
+[![Downloads](https://img.shields.io/github/downloads/jhd3197/ServerKit/total?style=flat-square)](https://github.com/jhd3197/ServerKit/releases)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=flat-square&logo=react&logoColor=black)](https://reactjs.org)
@@ -28,359 +29,12 @@ English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [P
<br>
-[Features](#-features) · [Quick Start](#-quick-start) · [Screenshots](#-screenshots) · [Architecture](#-architecture) · [Roadmap](#-roadmap) · [Docs](#-documentation) · [Contributing](#-contributing) · [Discord](#-community)
+[Quick Start](#-quick-start) · [Screenshots](#-screenshots) · [Features](#-features) · [Architecture](#-architecture) · [Roadmap](#-roadmap) · [Docs](#-documentation) · [Contributing](#-contributing) · [Discord](#-community)
</div>
---
-<p align="center">
- <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
-</p>
-
----
-
-
-<!-- SK:SHOTS:START -->
-## 📸 Screenshots
-
-> Captured from a mock-data demo build — every hostname, IP, domain, and metric below is fictional.
-
-<details open>
-<summary><strong>Dashboard</strong> — Live server metrics, KPI cards, your apps at a glance, and a recent-activity feed</summary>
-
-![Dashboard](docs/screenshots/dashboard.png)
-
-</details>
-
-<details>
-<summary><strong>AI Assistant</strong> — Built-in, Prompture-powered assistant — reads page context, answers questions, and runs tools on your infra</summary>
-
-![AI Assistant](docs/screenshots/ai.png)
-
-</details>
-
-<details>
-<summary><strong>Services</strong> — Static, Node.js, Python, PHP, and Docker apps with status, domain, and last-deploy</summary>
-
-![Services](docs/screenshots/services.png)
-
-</details>
-
-<details>
-<summary><strong>Service Detail</strong> — Per-app deployments, git connection, live resource usage, logs, and settings</summary>
-
-![Service Detail](docs/screenshots/service-detail.png)
-
-</details>
-
-<details>
-<summary><strong>WordPress</strong> — Per-site WordPress dashboard — status, core version, disk, DB config, Quick Actions, and live site-health checks</summary>
-
-![WordPress](docs/screenshots/wordpress.png)
-
-</details>
-
-<details>
-<summary><strong>Docker</strong> — Containers, images, volumes, and networks with live CPU/RAM per container</summary>
-
-![Docker](docs/screenshots/docker.png)
-
-</details>
-
-<details>
-<summary><strong>Databases</strong> — MySQL / PostgreSQL / SQLite explorer with a live source tree and SQL console</summary>
-
-![Databases](docs/screenshots/databases.png)
-
-</details>
-
-<details>
-<summary><strong>SQL Console</strong> — Run SQL against any database from the browser with a live, typed results grid</summary>
-
-![SQL Console](docs/screenshots/sql.png)
-
-</details>
-
-<details>
-<summary><strong>Domains</strong> — Domains mapped to sites with SSL status, expiry tracking, and auto-renew</summary>
-
-![Domains](docs/screenshots/domains.png)
-
-</details>
-
-<details>
-<summary><strong>DNS Zones</strong> — Multi-provider DNS — Cloudflare, Route 53, DigitalOcean — with full record editing</summary>
-
-![DNS Zones](docs/screenshots/dns.png)
-
-</details>
-
-<details>
-<summary><strong>Monitoring</strong> — Live host gauges, threshold-based alert rules, delivery channels, and alert history</summary>
-
-![Monitoring](docs/screenshots/monitoring.png)
-
-</details>
-
-<details>
-<summary><strong>Security</strong> — Security posture score, ClamAV malware scanning, file integrity, firewall, and Fail2Ban</summary>
-
-![Security](docs/screenshots/security.png)
-
-</details>
-
-<details>
-<summary><strong>Backups</strong> — Scheduled app/database/file backups with S3/B2 remote sync and one-click restore</summary>
-
-![Backups](docs/screenshots/backups.png)
-
-</details>
-
-<details>
-<summary><strong>Mail</strong> — Full mail stack — Postfix, Dovecot, OpenDKIM, SpamAssassin, Roundcube — with DKIM/SPF/DMARC</summary>
-
-![Mail](docs/screenshots/email.png)
-
-</details>
-
-<details>
-<summary><strong>Cron Jobs</strong> — Scheduled tasks with cron expressions, human-readable timing, and enable toggles</summary>
-
-![Cron Jobs](docs/screenshots/cron.png)
-
-</details>
-
-<details>
-<summary><strong>File Manager</strong> — Browse, edit, and upload files from the browser with per-mount disk usage</summary>
-
-![File Manager](docs/screenshots/files.png)
-
-</details>
-
-<details>
-<summary><strong>Logs & Terminal</strong> — In-browser log viewer, process list, journald, and full SSH terminal sessions</summary>
-
-![Logs & Terminal](docs/screenshots/terminal.png)
-
-</details>
-
-<details>
-<summary><strong>Servers</strong> — Manage every server from one panel with live CPU/RAM/disk telemetry per host</summary>
-
-![Servers](docs/screenshots/servers.png)
-
-</details>
-
-<details>
-<summary><strong>Agent Fleet</strong> — Fleet health, agent version distribution, staged rollouts, and command queue</summary>
-
-![Agent Fleet](docs/screenshots/fleet.png)
-
-</details>
-
-<details>
-<summary><strong>Remote Access</strong> — Expose a private/NAT-ed home service publicly by WireGuard-pairing two agents — no port forwarding</summary>
-
-![Remote Access](docs/screenshots/remote-access.png)
-
-</details>
-
-<details>
-<summary><strong>Workflow Builder</strong> — Node-based visual automation — chain triggers, builds, deploys, and notifications on a canvas</summary>
-
-![Workflow Builder](docs/screenshots/workflow.png)
-
-</details>
-
-<details>
-<summary><strong>Marketplace</strong> — Browse and install extensions from the bundled catalog or the remote registry — with a unified Installed tab</summary>
-
-![Marketplace](docs/screenshots/marketplace.png)
-
-</details>
-
-<details>
-<summary><strong>Settings</strong> — Profile, security, appearance/branding, users, connections, and notification channels</summary>
-
-![Settings](docs/screenshots/settings.png)
-
-</details>
-
-<details>
-<summary><strong>Login</strong> — Email/password sign-in with SSO (Google/GitHub/GitLab) and 2FA support</summary>
-
-![Login](docs/screenshots/login.png)
-
-</details>
-<!-- SK:SHOTS:END -->
-
-## 🎯 Features
-
-### 🚀 Apps & Deployment
-
-**PHP / WordPress** — PHP-FPM 8.x with one-click WordPress installation
-
-**Python Apps** — Deploy Flask and Django with Gunicorn
-
-**Node.js** — PM2-managed applications with log streaming
-
-**Manual & Zip Deploys** — Deploy from a local/manual path or a zip upload, alongside Git and Docker sources
-
-**Workflow Builder** — Node-based visual automation for server tasks, deployments, and CI/CD
-
-**Environment Pipeline** — Multi-environment management for WordPress (Prod/Staging/Dev) with code/DB promotion
-
-**WordPress Publishing** — Publish managed sites at a real subdomain (not `localhost:port`), safely swap a site's URL with preview, and attach a custom domain with automatic DNS and wildcard HTTPS
-
-**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.)
-
-**Build Packs** — Zero-Dockerfile detection that inspects a repo and generates a Dockerfile + compose from a build plan (defers to an author-provided Dockerfile when present)
-
-**Declarative Templates** — A documented catalog schema with auto-resolved `${SERVICE_*}` magic variables (password/user/FQDN/URL/base64) so templates never hardcode generated secrets or hosts
-
-**Projects & Environments** — Group applications into a Workspace → Project → Environment hierarchy with workspace-scoped access and resource counts
-
-**Config Snapshots** — Immutable, secret-masked configuration snapshots captured before each deploy, with diff and one-click restore + redeploy
-
-**Container Status** — One deterministic health status per app, aggregated from its containers and pushed live (healthy / degraded / restarting / unhealthy)
-
-**PR Preview Environments** — Ephemeral previews driven by a pull-request webhook that open, redeploy, and tear down per PR
-
-### 🏗️ Infrastructure
-
-**Domain Management** — Nginx virtual hosts with easy configuration
-
-**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 / 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
-
-**Cloud Provisioning** — Provision servers on DigitalOcean, Hetzner, Vultr, and Linode with cost tracking
-
-**Connections** — One place to link every external account: source (GitHub/GitLab), cloud infrastructure, DNS providers, domain registrars with expiry tracking, SMTP relays, and S3/B2 storage — credentials encrypted at rest
-
-**Firewall** — UFW/firewalld with visual rule management and port presets
-
-**Cron Jobs** — Schedule tasks with a visual editor
-
-**File Manager** — Browse, edit, upload, and download files via web interface, including browsing and previewing S3 / Backblaze B2 buckets
-
-**FTP Server** — Manage vsftpd users and access
-
-**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
-
-### 🔒 Security
-
-**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
-
-**Fail2ban & SSH** — Brute force protection, SSH key management, IP allowlist/blocklist
-
-**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
-
-**Agent-Based Architecture** — Cross-platform Go agent (Linux, Windows, macOS) with HMAC-SHA256 authentication and a real-time WebSocket gateway (with HTTP-poll fallback). Native Windows service + MSI installer, plus `.deb`/`.rpm` and ARM64 builds. See [agent/README.md](agent/README.md).
-
-**Fleet Management** — Agent inventory, connection status, approval queue, rollouts, LAN auto-discovery (UDP), and command queue
-
-**Windows Desktop Agent** — Native Windows service plus an optional desktop app: WebView2 console, system-tray controls, and a guided pairing wizard for one-click enrollment
-
-**Agent Enrollment** — Two ways to adopt a server: a secure short-code pairing flow (type a rotating code + passphrase into the panel and verify the key fingerprint) or a pre-shared registration token; host credentials are stored AES-GCM-encrypted. See [docs/pairing.md](docs/pairing.md)
-
-**Fleet Monitor** — Cross-server heatmaps, metric comparison charts, alert thresholds, anomaly detection, and capacity forecasting
-
-**Agent Plugins** — Extensible plugin system with capabilities, permissions, and per-server installation
-
-**Server Templates** — Configuration templates with compliance tracking, drift detection, and auto-remediation
-
-**Remote Docker** — Agent-backed Docker operations for connected servers; remote app/site deployment is still evolving
-
-**Remote Service Tunnels** — Expose a private or NAT'd service (e.g. a home media server) through an edge server over an agent-managed WireGuard tunnel, reusing nginx, DNS, and certificates
-
-**API Key Rotation** — Secure credential rotation with acknowledgment handshake
-
-**Server Onboarding** — A guided onboarding state machine (validate → install prerequisites → install Docker → pair agent → ready) driven on the job bus with a live progress log
-
-**Per-Server Proxy Stack** — Opt-in Dockerized Traefik or Caddy per server with a compose preview before switching; host nginx remains the default
-
-**Cross-Server Metrics** — Historical metrics with comparison charts and retention policies
-
-### 📊 Monitoring & Alerts
-
-**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
-
-**Notifications** — Discord, Slack, Telegram, email (HTML templates), and generic webhooks
-
-**Per-User Preferences** — Individual notification channels, severity filters, and quiet hours
-
-### 👥 Team & Access Control
-
-**Multi-User** — Admin, developer, and viewer roles with team invitations
-
-**Workspaces** — Multi-tenant workspace isolation with quotas and member management
-
-**RBAC** — Granular per-feature permissions (read/write per module)
-
-**SSO & OAuth** — Google, GitHub, OpenID Connect, and SAML 2.0 with account linking
-
-**Audit Logging** — Track all user actions with detailed activity dashboard
-
-**API Keys** — Tiered API keys (standard/elevated/unlimited) with rate limiting, usage analytics, and OpenAPI documentation
-
-**API Token Scopes** — Fine-grained, additive scopes for API keys (enforced for programmatic `X-API-Key` callers; JWT/session users stay RBAC-governed)
-
-**Shared Resources** — Polymorphic tags and attachable shared variable groups with a merged "resolved" view and masked secrets
-
-**Webhook Subscriptions** — Event-driven webhooks with HMAC signatures, retry logic, and custom headers
-
-### 🎨 Customization
-
-**Lean by default** — The guided setup wizard installs only the extensions matched to the use cases you pick (WordPress, web apps, self-hosting, DevOps) and nothing else. Uncheck anything you don't want; add more anytime from Extensions. WordPress is offered at setup rather than force-installed.
-
-**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
-
-**Accent Colors** — 8 preset accent colors plus custom hex picker
-
-**Custom Branding** — White-label the sidebar with your own logo, brand name, or full-width banner
-
-**Dashboard Widgets** — Toggle and reorder dashboard widgets to fit your workflow
-
----
-
## 🚀 Quick Start
> ⏱️ Up and running in under 2 minutes
@@ -432,43 +86,147 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions
## 📸 Screenshots
-<p align="center">
+> Captured from a mock-data demo build — every hostname, IP, domain, and metric below is fictional.
+
+| Dashboard | Services |
+| :--------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Dashboard](docs/screenshots/dashboard.png) | ![Services](docs/screenshots/services.png) |
+| _Live server metrics, KPI cards, and recent activity_ | _Static, Node.js, Python, PHP, and Docker apps_ |
+
+| Docker | WordPress |
+| :-------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Docker](docs/screenshots/docker.png) | ![WordPress](docs/screenshots/wordpress.png) |
+| _Containers, images, volumes, and networks with live CPU/RAM_ | _Per-site status, Quick Actions, and live health checks_ |
-![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+| Agent Fleet | Marketplace |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Agent Fleet](docs/screenshots/fleet.png) | ![Marketplace](docs/screenshots/marketplace.png) |
+| _Fleet health, version rollouts, and command queue_ | _One-click app templates and installable extensions_ |
-</p>
+| Monitoring | Security |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Monitoring](docs/screenshots/monitoring.png) | ![Security](docs/screenshots/security.png) |
+| _Live gauges, alert rules, and notification channels_ | _Posture score, ClamAV, file integrity, firewall, Fail2Ban_ |
<details>
-<summary><strong>View More Screenshots</strong></summary>
+<summary><strong>View all screenshots</strong></summary>
<br>
-<p align="center">
- <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
-</p>
+| AI Assistant | Service Detail |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![AI Assistant](docs/screenshots/ai.png) | ![Service Detail](docs/screenshots/service-detail.png) |
+| _Prompture-powered assistant that runs tools on your infra_ | _Deployments, git connection, live usage, logs, and settings_ |
+
+| Databases | SQL Console |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Databases](docs/screenshots/databases.png) | ![SQL Console](docs/screenshots/sql.png) |
+| _MySQL / PostgreSQL / SQLite explorer with a source tree_ | _Run SQL from the browser with a typed results grid_ |
+
+| Domains | DNS Zones |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Domains](docs/screenshots/domains.png) | ![DNS Zones](docs/screenshots/dns.png) |
+| _SSL status, expiry tracking, and auto-renewal_ | _Cloudflare, Route 53, DigitalOcean — full record editing_ |
+
+| Backups | Mail |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Backups](docs/screenshots/backups.png) | ![Mail](docs/screenshots/email.png) |
+| _Scheduled backups with S3/B2 sync and one-click restore_ | _Postfix, Dovecot, OpenDKIM, SpamAssassin, and Roundcube_ |
+
+| Cron Jobs | File Manager |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Cron Jobs](docs/screenshots/cron.png) | ![File Manager](docs/screenshots/files.png) |
+| _Visual cron editor with human-readable timing_ | _Browse, edit, and upload files with per-mount disk usage_ |
+
+| Logs & Terminal | Servers |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Logs & Terminal](docs/screenshots/terminal.png) | ![Servers](docs/screenshots/servers.png) |
+| _Log viewer, process list, journald, and SSH sessions_ | _Every server in one panel with live CPU/RAM/disk telemetry_ |
+
+| Remote Access | Settings |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Remote Access](docs/screenshots/remote-access.png) | ![Settings](docs/screenshots/settings.png) |
+| _Expose NAT-ed services publicly via WireGuard-paired agents_ | _Profile, appearance/branding, users, and connections_ |
+
+| Login | |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Login](docs/screenshots/login.png) | |
+| _Email/password sign-in with SSO and 2FA support_ | |
+
+</details>
+
+## 🎯 Features
+
+> **The core is feature-complete.** New capabilities ship as installable **extensions** through the built-in Marketplace — the core stays lean and stable, with ongoing work focused on UI polish and community-reported fixes.
+
+### 🚀 Apps & Deployment
-<p align="center">
- <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
-</p>
+| | |
+|---|---|
+| **One-Click WordPress**<br>PHP-FPM 8.x sites published at real subdomains, with URL-swap previews, custom domains, and wildcard HTTPS. | **Any Stack**<br>Flask/Django on Gunicorn, Node.js on PM2, static sites — from Git, Docker, a manual path, or a zip upload. |
+| **Docker & Compose**<br>Image-update detection with one-click apply, auto-sleep for idle containers, CPU-driven auto-scaling, live logs, and terminal access. | **Marketplace**<br>100+ one-click app templates on a declarative schema with auto-resolved secrets, hosts, and URLs — nothing hardcoded. |
+| **Build Packs**<br>Zero-Dockerfile deploys: inspects a repo and generates a Dockerfile + compose from a build plan. | **Automations**<br>Node-based visual automation for tasks, deployments, and CI/CD — cron, webhook, and event triggers, running in a managed container. Ships as an extension. |
+| **Previews & Snapshots**<br>Ephemeral PR preview environments, plus immutable, secret-masked config snapshots with diff and one-click restore. | **Projects & Environments**<br>Workspace → Project → Environment grouping, and a WordPress prod/staging/dev pipeline with code/DB promotion. |
-<p align="center">
- <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
-</p>
+### 🏗️ Infrastructure
-<p align="center">
- <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
-</p>
+| | |
+|---|---|
+| **Domains & SSL**<br>Nginx virtual hosts, automatic Let's Encrypt with renewal, hardened TLS 1.2+/AEAD, Cloudflare-aware configs, automatic CAA. | **DNS Zones**<br>Full record management across Cloudflare, Route 53, and DigitalOcean — propagation checks and dynamic DNS for changing IPs. |
+| **Databases**<br>MySQL/MariaDB and PostgreSQL with user management, a live source tree, and a browser SQL console. | **Cloud Provisioning**<br>Spin up servers on DigitalOcean, Hetzner, Vultr, and Linode with cost tracking. |
+| **Connections Hub**<br>Git providers, clouds, DNS, registrars, SMTP relays, and S3/B2 storage — every external account in one place, encrypted at rest. | **Backups**<br>Scheduled app/database/file backups to S3, B2, or local with retention policies, one-click restore, and optional client-side encryption. |
+| **Files, FTP & Cron**<br>Web file manager with S3/B2 bucket browsing, vsftpd user management, and a visual cron editor. | **Email Server**<br>Postfix + Dovecot with DKIM/SPF/DMARC, SpamAssassin, Roundcube webmail, and forwarding rules. |
-<p align="center">
- <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
-</p>
+### 🔒 Security
-</details>
+| | |
+|---|---|
+| **Web Application Firewall**<br>Per-app ModSecurity v3 + OWASP Core Rule Set with detect/block modes and tunable paranoia. | **Passkeys & 2FA**<br>WebAuthn passwordless sign-in (hardware keys, Touch ID, Windows Hello) plus TOTP with backup codes. |
+| **Malware & Integrity**<br>ClamAV scanning with quarantine, file-integrity monitoring, and Lynis vulnerability audits. | **SSH & Hardening**<br>Fail2ban, SSH key management, IP allow/block lists, and automatic OS security updates. |
+| **Container Scanning**<br>Per-image CVE scanning with grype and SBOM generation with syft. | **Encrypted Secrets**<br>Provider credentials and secrets sealed with Fernet, plus an inbound webhook gateway for external automation. |
+
+### 🖥️ Multi-Server
+
+| | |
+|---|---|
+| **Cross-Platform Agent**<br>Go agent for Linux, Windows, and macOS — HMAC-SHA256 auth over a real-time WebSocket gateway. Native Windows service + MSI, `.deb`/`.rpm`, ARM64. [More →](https://github.com/jhd3197/serverkit-agent) | **Fleet Management**<br>Inventory, approval queue, staged version rollouts, LAN auto-discovery, and an offline command queue. |
+| **Easy Enrollment**<br>Short-code pairing with fingerprint verification or pre-shared tokens; host credentials stored AES-GCM-encrypted. [More →](docs/pairing.md) | **Fleet Monitor**<br>Cross-server heatmaps, metric comparisons, alert thresholds, anomaly detection, and capacity forecasting. |
+| **Server Templates**<br>Expected-state templates with drift detection, compliance dashboards, and auto-remediation. | **Remote Access Tunnels**<br>Expose a private/NAT'd service through an edge server over agent-managed WireGuard — no port forwarding. |
+| **Guided Onboarding**<br>Validate → prerequisites → Docker → pair agent, with a live progress log. | **Per-Server Proxy**<br>Opt-in Dockerized Traefik or Caddy per server with compose preview; host nginx stays the default. |
+
+### 📊 Monitoring & Alerts
+
+| | |
+|---|---|
+| **Real-Time Metrics**<br>CPU, RAM, disk, and network over WebSocket, with historical retention and uptime tracking. | **GPU Monitoring**<br>NVIDIA utilization, memory, temperature, and per-process/per-container usage. |
+| **Status Pages**<br>Public pages with HTTP/TCP/DNS/Ping checks, component monitoring, and incident management. | **Notifications**<br>Discord, Slack, Telegram, HTML email, and webhooks — per-user channels, severity filters, and quiet hours. |
+
+### 👥 Team & Access
+
+| | |
+|---|---|
+| **Workspaces**<br>Multi-tenant isolation with quotas and member management. | **RBAC**<br>Admin/developer/viewer roles with granular per-feature read/write permissions. |
+| **SSO & OAuth**<br>Google, GitHub, OpenID Connect, and SAML 2.0 with account linking. | **API Keys**<br>Tiered keys with rate limiting, fine-grained scopes, usage analytics, and OpenAPI docs. |
+| **Audit Logging**<br>Every user action tracked, with a detailed activity dashboard. | **Webhooks & Shared Config**<br>Outbound subscriptions with HMAC signatures and retries, plus shared tags and variable groups. |
+
+### 🎨 Customization
+
+| | |
+|---|---|
+| **Lean by Default**<br>The setup wizard installs only the extensions matching your use cases — add more anytime from the Marketplace. | **Sidebar Presets**<br>Full, Web Hosting, Email Admin, DevOps, or Minimal views with collapsible groups and per-user layouts. |
+| **Your Brand**<br>8 preset accent colors plus a custom hex picker, and white-label logo, name, or banner. | **Dashboard Widgets**<br>Toggle and reorder widgets to fit your workflow. |
---
## 🏗️ Architecture
+<img width="100%" alt="ServerKit architecture: clients and public visitors reach an nginx edge layer that splits panel traffic to the Flask API and public traffic to app containers; the ServerKit panel holds the React SPA, REST API, Socket.IO agent gateway, services, models, jobs, notifications and the extension runtime; a runtime layer on the same server holds Docker app containers, databases and panel state; a remote agent fleet of Go agents connects back over the /agent namespace." src="docs/images/architecture/system-overview.png" />
+
+**Nginx** terminates TLS and splits traffic two ways: panel requests go to the **Flask API**, everything else is proxied to the **Docker container** serving that domain. The panel keeps its own state in SQLite or PostgreSQL, runs background work through a job scheduler and notification bus, and loads optional functionality from the **extension runtime**. Remote servers are managed by a **Go agent** that connects back over a Socket.IO namespace.
+
+<details>
+<summary><strong>View as ASCII diagram</strong></summary>
+
```
┌──────────────────┐
│ INTERNET │
@@ -482,72 +240,58 @@ See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions
│ │ NGINX (Reverse Proxy) │ │
│ │ :80 / :443 │ │
│ │ │ │
-│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ │ │
-│ └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
-│ │ proxy_pass │ proxy_pass │ proxy_pass │
-│ ▼ ▼ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DOCKER CONTAINERS │ │
-│ │ │ │
-│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
-│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │
-│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │
-│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │
-│ └──────────┼──────────────────────────────────────────────────────────┘ │
-│ │ │
-│ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DATABASES │ │
-│ │ MySQL :3306 PostgreSQL :5432 Redis :6379 │ │
-│ └─────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────┘
+│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ /api/v1/ ──┐ │ │
+│ └───────────────┼──────────────┼──────────────────┼──────────────┼────┘ │
+│ │ proxy_pass │ proxy_pass │ proxy_pass │ │
+│ ▼ ▼ ▼ │ │
+│ ┌────────────────────────────────────────────────────────────┐ │ │
+│ │ DOCKER CONTAINERS │ │ │
+│ │ │ │ │
+│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │
+│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │ │
+│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │ │
+│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │ │
+│ └──────────┼─────────────────────────────────────────────────┘ │ │
+│ │ ▼ │
+│ │ ┌─────────────────────────────────┐ │
+│ │ │ SERVERKIT PANEL │ │
+│ │ │ React SPA · Flask REST API │ │
+│ │ │ Socket.IO · Jobs · Notify │ │
+│ │ │ Extension runtime │ │
+│ │ │ Gunicorn -w 1 (threaded) │ │
+│ │ └────────────────┬────────────────┘ │
+│ ▼ │ │
+│ ┌──────────────────────────────────┐ ┌─────────────▼────────────────┐ │
+│ │ DATABASES │ │ PANEL STATE │ │
+│ │ MySQL :3306 PostgreSQL :5432 │ │ SQLite (default) or │ │
+│ │ Redis :6379 MongoDB :27017 │ │ PostgreSQL · Alembic │ │
+│ └──────────────────────────────────┘ └──────────────────────────────┘ │
+└───────────────────────────────────────────────────────┼──────────────────┘
+ │
+ Socket.IO /agent (HMAC) │
+ + HTTP long-poll fallback ▼
+ ┌──────────────────────────────────────┐
+ │ REMOTE SERVERS — Go agent fleet │
+ │ server A · server B · server C │
+ └──────────────────────────────────────┘
```
-**[View Full Architecture Documentation →](docs/ARCHITECTURE.md)** — Request flow, template system, port allocation, database linking, and troubleshooting.
+</details>
+
+**[View Full Architecture Documentation →](docs/ARCHITECTURE.md)** — Request flow, extension platform, template system, port allocation, jobs, notifications, and the agent fleet.
---
## 🗺️ Roadmap
-- [x] Core infrastructure — Flask + React + JWT + WebSocket
-- [x] Application management — PHP, Python, Node.js, Docker
-- [x] Domain & SSL — Nginx virtual hosts, Let's Encrypt
-- [x] Databases — MySQL, PostgreSQL
-- [x] File & FTP management
-- [x] Monitoring & alerts — Metrics, webhooks, uptime tracking
-- [x] Security — 2FA, ClamAV, file integrity, Fail2ban, Lynis
-- [x] Firewall — UFW/firewalld integration
-- [x] Multi-server monitoring — Go agent, centralized dashboard
-- [x] Git deployment — Webhooks, auto-deploy, rollback, zero-downtime
-- [x] Backup & restore — S3, Backblaze B2, scheduled backups
-- [x] Email server — Postfix, Dovecot, DKIM/SPF/DMARC, Roundcube
-- [x] Team & permissions — RBAC, invitations, audit logging
-- [x] API enhancements — API keys, rate limiting, OpenAPI docs, webhook subscriptions
-- [x] SSO & OAuth — Google, GitHub, OIDC, SAML
-- [x] Database migrations — Flask-Migrate/Alembic, versioned schema
-- [x] Agent fleet management — Version rollouts, approval queue, discovery, command queue
-- [x] Cross-server monitoring — Fleet heatmaps, comparison charts, anomaly detection, capacity forecasting
-- [ ] Remote app/site deployment through connected agents
-- [x] Agent plugin system — Extensible agent with capabilities, permissions, per-server install
-- [x] Server templates & config sync — Drift detection, compliance dashboards, auto-remediation
-- [x] Multi-tenancy — Workspaces with quotas, member management, isolation
-- [x] DNS zone management — Full record management with propagation checking
-- [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 gateway
-- [x] Remote access — Expose private/NAT'd services via agent-managed WireGuard tunnels
-- [x] Connections hub — Unified external accounts (source, cloud, DNS, registrars, SMTP, storage)
-- [x] WordPress publishing — Real subdomains, URL-swap, custom domains, wildcard HTTPS
-
-Full details: [ROADMAP.md](ROADMAP.md)
+**ServerKit's core is feature-complete** — every planned core phase has shipped, from the first Flask + React infrastructure to multi-server fleets, SSO, the automation engine, and the extension marketplace.
+
+Development now happens in two places:
+
+- **🧩 Extensions** — new functionality ships as installable extensions through the Marketplace (100+ one-click templates and growing). The core stays lean; you install only what you need.
+- **✨ Core polish** — ongoing UI/UX refinements and fixes for issues reported by the community. No new core features are planned.
+
+Full history: [ROADMAP.md](ROADMAP.md)
---
@@ -558,7 +302,7 @@ Full details: [ROADMAP.md](ROADMAP.md)
| [Architecture](docs/ARCHITECTURE.md) | System design, request flow, diagrams |
| [Installation Guide](docs/INSTALLATION.md) | Complete setup instructions |
| [Deployment Guide](docs/DEPLOYMENT.md) | CLI commands and production deployment |
-| [Agent](agent/README.md) | Install & run the multi-server agent (Linux/Windows/macOS) |
+| [Agent](https://github.com/jhd3197/serverkit-agent) | Install & run the multi-server agent (Linux/Windows/macOS) — separate repo |
| [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 |
@@ -576,7 +320,7 @@ Full details: [ROADMAP.md](ROADMAP.md)
| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO, Flask-Migrate |
| Frontend | React 18, Vite, SCSS, Recharts |
| Database | SQLite / PostgreSQL |
-| Web Server | Nginx, Gunicorn (GeventWebSocket) |
+| Web Server | Nginx, Gunicorn (single threaded worker — `-w 1 --threads N`) |
| Containers | Docker, Docker Compose |
| 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 |
@@ -593,7 +337,17 @@ Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
fork → feature branch → commit → push → pull request
```
-**Priority areas:** Cloud provider integrations, marketplace extensions, UI/UX improvements, documentation, test coverage.
+**Priority areas:** Marketplace extensions, UI/UX improvements, documentation, test coverage.
+
+---
+
+## 💛 Support ServerKit
+
+ServerKit is free and open source. If it saves you time, you can help keep it going:
+
+- ⭐ [Star the repo](https://github.com/jhd3197/ServerKit) — it costs nothing and helps a lot
+- 💖 [GitHub Sponsors](https://github.com/sponsors/jhd3197)
+- ☕ [Buy Me a Coffee](https://buymeacoffee.com/jhd3197)
---
@@ -603,6 +357,10 @@ fork → feature branch → commit → push → pull request
> ServerKit manages your servers from the browser; Faro is the desktop companion for hands-on file transfer, shells, and ad-hoc work across all your boxes. [Grab a build →](https://github.com/jhd3197/faro/releases/latest)
+**[LocalKit](https://github.com/jhd3197/LocalKit)** — Spin up local WordPress sites in one click. Each site runs as its own isolated Docker Compose project, and you can push code or push/pull databases straight to your ServerKit server through the `serverkit-localkit` extension.
+
+**[DeviceKit](https://github.com/jhd3197/DeviceKit)** — A unified Android device fleet & test-automation platform. Control a fleet of devices from one dashboard — run automations, stream screens in real time, catch visual regressions, and debug failures with AI-powered analysis.
+
---
## 💬 Community
@@ -613,12 +371,6 @@ Join the Discord to ask questions, share feedback, or get help with your setup.
---
-## ⭐ Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=jhd3197/ServerKit&type=Date)](https://star-history.com/#jhd3197/ServerKit&Date)
-
----
-
<div align="center">
**ServerKit** — Simple. Modern. Self-hosted.
diff --git a/docs/README.es.md b/docs/README.es.md
index 25fafcdf..c4b701ae 100644
--- a/docs/README.es.md
+++ b/docs/README.es.md
@@ -1,8 +1,8 @@
<div align="center">
-# ServerKit
+<img width="100%" alt="ServerKit — Despliega, gestiona y monitorea servidores" src="screenshots/poster.png" />
-<img width="100%" alt="ServerKit — Deploy, manage, and monitor servers" src="screenshots/poster.png" />
+# ServerKit
**Despliega, gestiona y monitorea servidores.**
@@ -18,6 +18,8 @@ ni el coste de las plataformas gestionadas.
![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
[![Discord](https://img.shields.io/discord/1470639209059455008?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/ZKk6tkCQfG)
+[![GitHub Stars](https://img.shields.io/github/stars/jhd3197/ServerKit?style=flat-square&color=f5c542)](https://github.com/jhd3197/ServerKit/stargazers)
+[![Downloads](https://img.shields.io/github/downloads/jhd3197/ServerKit/total?style=flat-square)](https://github.com/jhd3197/ServerKit/releases)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](../LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=flat-square&logo=react&logoColor=black)](https://reactjs.org)
@@ -27,82 +29,12 @@ ni el coste de las plataformas gestionadas.
<br>
-[Funcionalidades](#-funcionalidades) · [Inicio Rápido](#-inicio-rápido) · [Capturas de Pantalla](#-capturas-de-pantalla) · [Arquitectura](#-arquitectura) · [Hoja de Ruta](#-hoja-de-ruta) · [Documentación](#-documentación) · [Contribuir](#-contribuir) · [Discord](#-comunidad)
+[Inicio Rápido](#-inicio-rápido) · [Capturas](#-capturas-de-pantalla) · [Funcionalidades](#-funcionalidades) · [Arquitectura](#-arquitectura) · [Hoja de Ruta](#-hoja-de-ruta) · [Documentación](#-documentación) · [Contribuir](#-contribuir) · [Discord](#-comunidad)
</div>
---
-<p align="center">
- <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
-</p>
-
----
-
-## 🎯 Funcionalidades
-
-### Aplicaciones y Contenedores
-
-🐘 **PHP / WordPress** — PHP-FPM 8.x con instalación de WordPress en un clic
-
-🐍 **Aplicaciones Python** — Despliega Flask y Django con Gunicorn
-
-🟢 **Node.js** — Aplicaciones gestionadas con PM2 y transmisión de logs en tiempo real
-
-📦 **Despliegues Manuales y Zip** — Despliega desde una ruta local/manual o subiendo un zip, junto a los orígenes Git y Docker
-
-🐳 **Docker** — Gestión completa de contenedores y Docker Compose
-
-♻️ **Ciclo de Vida de Contenedores** — Detección de actualizaciones de imagen con aplicación en un clic, suspensión automática de contenedores inactivos y escalado horizontal automático según la CPU
-
-🔑 **Variables de Entorno** — Gestión segura y cifrada de variables por aplicación
-
-### Infraestructura
-
-🌐 **Gestión de Dominios** — Hosts virtuales Nginx con configuración sencilla
-
-🔒 **SSL / TLS** — Let's Encrypt automático con renovación automática, HTTPS opcional (en la medida de lo posible) que nunca bloquea una instalación, cifrados reforzados TLS 1.2+/AEAD, configuraciones compatibles con Cloudflare y registros CAA automáticos
-
-🗄️ **Bases de Datos** — Soporte para MySQL/MariaDB y PostgreSQL
-
-🛡️ **Firewall (UFW)** — Gestión visual de reglas de firewall
-
-⏰ **Tareas Programadas (Cron)** — Programa tareas con un editor visual
-
-📁 **Gestor de Archivos** — Navega y edita archivos desde la interfaz web, incluyendo la navegación y vista previa de buckets de S3 / Backblaze B2
-
-📡 **Servidor FTP** — Gestión de usuarios y accesos de vsftpd
-
-### Seguridad
-
-🔐 **Autenticación de Dos Factores** — Basada en TOTP con códigos de respaldo
-
-🔑 **Passkeys / WebAuthn** — Inicio de sesión sin contraseña y como segundo factor con llaves de hardware, Touch ID y Windows Hello
-
-🧱 **Firewall de Aplicaciones Web** — ModSecurity v3 + OWASP Core Rule Set por aplicación con modos de detección/bloqueo, paranoia ajustable y eventos en el registro de auditoría
-
-🦠 **Análisis de Malware** — Integración con ClamAV y cuarentena
-
-📋 **Monitorización de Integridad de Archivos** — Detecta cambios no autorizados en archivos
-
-🚨 **Alertas de Seguridad** — Notificaciones de amenazas en tiempo real
-
-🧱 **Fail2ban y SSH** — Protección contra fuerza bruta y gestión de claves SSH
-
-### Monitorización y Alertas
-
-📊 **Métricas en Tiempo Real** — Monitorización de CPU, RAM, disco y red vía WebSocket
-
-🎮 **Monitorización de GPU** — Utilización, memoria, temperatura y consumo de GPU NVIDIA, con uso por proceso y por contenedor
-
-📈 **Seguimiento de Disponibilidad** — Datos históricos de tiempo de actividad del servidor
-
-🔔 **Notificaciones** — Discord, Slack, Telegram y webhooks genéricos
-
-🖥️ **Multi-Servidor** — Monitorización y gestión remota de servidores basada en agentes
-
----
-
## 🚀 Inicio Rápido
> ⏱️ En funcionamiento en menos de 2 minutos
@@ -113,7 +45,19 @@ ni el coste de las plataformas gestionadas.
curl -fsSL https://serverkit.ai/install.sh | bash
```
-> Funciona en Ubuntu 22.04+ y Debian 12+. Configura todo automáticamente.
+> Funciona en Ubuntu 22.04+, Debian 12+, Fedora y RHEL/Rocky/AlmaLinux 9+. Configura todo automáticamente.
+>
+> Opcional: `PANEL_DOMAIN=panel.example.com` establece el dominio e intenta obtener un certificado de Let's Encrypt; `SERVERKIT_OFFLINE_TARBALL=...` instala desde un tarball local.
+
+### Actualización
+
+```bash
+sudo serverkit update
+```
+
+Actualización atómica blue/green con comprobaciones previas, copia de seguridad de la
+base de datos, migración y rollback automático. Usa `--dry-run` para previsualizar,
+`--branch dev` para compilaciones de desarrollo o `--release [versión]` para tarballs de release.
### Opción 2: Docker
@@ -142,43 +86,147 @@ Consulta la [Guía de Instalación](INSTALLATION.md) para instrucciones paso a p
## 📸 Capturas de Pantalla
-<p align="center">
+> Capturadas desde una compilación de demostración con datos ficticios — todos los nombres de host, IP, dominios y métricas que se ven a continuación son inventados.
+
+| Panel Principal | Servicios |
+| :--------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Panel Principal](screenshots/dashboard.png) | ![Servicios](screenshots/services.png) |
+| _Métricas del servidor en vivo, tarjetas KPI y actividad reciente_ | _Aplicaciones estáticas, Node.js, Python, PHP y Docker_ |
-![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+| Docker | WordPress |
+| :-------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Docker](screenshots/docker.png) | ![WordPress](screenshots/wordpress.png) |
+| _Contenedores, imágenes, volúmenes y redes con CPU/RAM en vivo_ | _Estado por sitio, Acciones Rápidas y comprobaciones de salud en vivo_ |
-</p>
+| Flota de Agentes | Marketplace |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Flota de Agentes](screenshots/fleet.png) | ![Marketplace](screenshots/marketplace.png) |
+| _Salud de la flota, despliegues de versiones y cola de comandos_ | _Plantillas de aplicaciones en un clic y extensiones instalables_ |
+
+| Monitorización | Seguridad |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Monitorización](screenshots/monitoring.png) | ![Seguridad](screenshots/security.png) |
+| _Indicadores en vivo, reglas de alerta y canales de notificación_ | _Puntuación de postura, ClamAV, integridad de archivos, firewall, Fail2Ban_ |
<details>
-<summary><strong>Ver Más Capturas</strong></summary>
+<summary><strong>Ver todas las capturas</strong></summary>
<br>
-<p align="center">
- <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
-</p>
+| Asistente de IA | Detalle de Servicio |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Asistente de IA](screenshots/ai.png) | ![Detalle de Servicio](screenshots/service-detail.png) |
+| _Asistente impulsado por Prompture que ejecuta herramientas sobre tu infraestructura_ | _Despliegues, conexión con Git, uso en vivo, logs y ajustes_ |
+
+| Bases de Datos | Consola SQL |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Bases de Datos](screenshots/databases.png) | ![Consola SQL](screenshots/sql.png) |
+| _Explorador de MySQL / PostgreSQL / SQLite con árbol de orígenes_ | _Ejecuta SQL desde el navegador con una tabla de resultados tipada_ |
+
+| Dominios | Zonas DNS |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Dominios](screenshots/domains.png) | ![Zonas DNS](screenshots/dns.png) |
+| _Estado SSL, seguimiento de caducidad y renovación automática_ | _Cloudflare, Route 53, DigitalOcean — edición completa de registros_ |
+
+| Copias de Seguridad | Correo |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Copias de Seguridad](screenshots/backups.png) | ![Correo](screenshots/email.png) |
+| _Copias programadas con sincronización a S3/B2 y restauración en un clic_ | _Postfix, Dovecot, OpenDKIM, SpamAssassin y Roundcube_ |
+
+| Tareas Programadas | Gestor de Archivos |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Tareas Programadas](screenshots/cron.png) | ![Gestor de Archivos](screenshots/files.png) |
+| _Editor visual de cron con horarios legibles por humanos_ | _Navega, edita y sube archivos con uso de disco por punto de montaje_ |
+
+| Logs y Terminal | Servidores |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Logs y Terminal](screenshots/terminal.png) | ![Servidores](screenshots/servers.png) |
+| _Visor de logs, lista de procesos, journald y sesiones SSH_ | _Todos los servidores en un panel con telemetría de CPU/RAM/disco en vivo_ |
+
+| Acceso Remoto | Ajustes |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Acceso Remoto](screenshots/remote-access.png) | ![Ajustes](screenshots/settings.png) |
+| _Expón públicamente servicios tras NAT mediante agentes emparejados con WireGuard_ | _Perfil, apariencia/marca, usuarios y conexiones_ |
+
+| Inicio de Sesión | |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Inicio de Sesión](screenshots/login.png) | |
+| _Acceso con email/contraseña, con soporte para SSO y 2FA_ | |
-<p align="center">
- <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
-</p>
+</details>
-<p align="center">
- <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
-</p>
+## 🎯 Funcionalidades
-<p align="center">
- <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
-</p>
+> **El núcleo está completo.** Las nuevas capacidades se distribuyen como **extensiones** instalables desde el Marketplace integrado — el núcleo se mantiene ligero y estable, y el trabajo en curso se centra en pulir la UI y corregir lo que reporta la comunidad.
-<p align="center">
- <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
-</p>
+### 🚀 Aplicaciones y Despliegue
-</details>
+| | |
+|---|---|
+| **WordPress en Un Clic**<br>Sitios PHP-FPM 8.x publicados en subdominios reales, con vistas previas mediante intercambio de URL, dominios personalizados y HTTPS comodín. | **Cualquier Stack**<br>Flask/Django sobre Gunicorn, Node.js sobre PM2, sitios estáticos — desde Git, Docker, una ruta manual o la subida de un zip. |
+| **Docker y Compose**<br>Detección de actualizaciones de imagen con aplicación en un clic, suspensión automática de contenedores inactivos, autoescalado según la CPU, logs en vivo y acceso a terminal. | **Marketplace**<br>Más de 100 plantillas de aplicaciones en un clic sobre un esquema declarativo con secretos, hosts y URLs resueltos automáticamente — nada codificado a mano. |
+| **Build Packs**<br>Despliegues sin Dockerfile: inspecciona un repositorio y genera un Dockerfile + compose a partir de un plan de compilación. | **Automatizaciones**<br>Automatización visual basada en nodos para tareas, despliegues y CI/CD — disparadores por cron, webhook y eventos, ejecutándose en un contenedor gestionado. Se distribuye como extensión. |
+| **Vistas Previas e Instantáneas**<br>Entornos de vista previa efímeros para PRs, además de instantáneas de configuración inmutables y con secretos enmascarados, con diff y restauración en un clic. | **Proyectos y Entornos**<br>Agrupación Espacio de trabajo → Proyecto → Entorno, y un flujo de WordPress prod/staging/dev con promoción de código y base de datos. |
+
+### 🏗️ Infraestructura
+
+| | |
+|---|---|
+| **Dominios y SSL**<br>Hosts virtuales Nginx, Let's Encrypt automático con renovación, TLS 1.2+/AEAD reforzado, configuraciones compatibles con Cloudflare y CAA automático. | **Zonas DNS**<br>Gestión completa de registros en Cloudflare, Route 53 y DigitalOcean — comprobaciones de propagación y DNS dinámico para IPs cambiantes. |
+| **Bases de Datos**<br>MySQL/MariaDB y PostgreSQL con gestión de usuarios, un árbol de orígenes en vivo y una consola SQL en el navegador. | **Aprovisionamiento en la Nube**<br>Levanta servidores en DigitalOcean, Hetzner, Vultr y Linode con seguimiento de costes. |
+| **Centro de Conexiones**<br>Proveedores Git, nubes, DNS, registradores, relés SMTP y almacenamiento S3/B2 — todas las cuentas externas en un solo lugar, cifradas en reposo. | **Copias de Seguridad**<br>Copias programadas de aplicaciones, bases de datos y archivos hacia S3, B2 o local, con políticas de retención, restauración en un clic y cifrado opcional en el cliente. |
+| **Archivos, FTP y Cron**<br>Gestor de archivos web con navegación de buckets S3/B2, gestión de usuarios de vsftpd y un editor visual de cron. | **Servidor de Correo**<br>Postfix + Dovecot con DKIM/SPF/DMARC, SpamAssassin, webmail Roundcube y reglas de reenvío. |
+
+### 🔒 Seguridad
+
+| | |
+|---|---|
+| **Firewall de Aplicaciones Web**<br>ModSecurity v3 + OWASP Core Rule Set por aplicación, con modos de detección/bloqueo y paranoia ajustable. | **Passkeys y 2FA**<br>Inicio de sesión sin contraseña con WebAuthn (llaves de hardware, Touch ID, Windows Hello) más TOTP con códigos de respaldo. |
+| **Malware e Integridad**<br>Análisis con ClamAV y cuarentena, monitorización de integridad de archivos y auditorías de vulnerabilidades con Lynis. | **SSH y Refuerzo**<br>Fail2ban, gestión de claves SSH, listas de IPs permitidas/bloqueadas y actualizaciones de seguridad automáticas del sistema. |
+| **Análisis de Contenedores**<br>Análisis de CVE por imagen con grype y generación de SBOM con syft. | **Secretos Cifrados**<br>Credenciales de proveedores y secretos sellados con Fernet, además de una pasarela de webhooks entrantes para automatización externa. |
+
+### 🖥️ Multi-Servidor
+
+| | |
+|---|---|
+| **Agente Multiplataforma**<br>Agente en Go para Linux, Windows y macOS — autenticación HMAC-SHA256 sobre una pasarela WebSocket en tiempo real. Servicio nativo de Windows + MSI, `.deb`/`.rpm`, ARM64. [Más →](https://github.com/jhd3197/serverkit-agent) | **Gestión de Flota**<br>Inventario, cola de aprobación, despliegues escalonados de versiones, descubrimiento automático en LAN y una cola de comandos sin conexión. |
+| **Enrolamiento Sencillo**<br>Emparejamiento con código corto y verificación de huella o tokens precompartidos; las credenciales del host se almacenan cifradas con AES-GCM. [Más →](pairing.md) | **Monitor de Flota**<br>Mapas de calor entre servidores, comparación de métricas, umbrales de alerta, detección de anomalías y previsión de capacidad. |
+| **Plantillas de Servidor**<br>Plantillas de estado esperado con detección de desviaciones, paneles de cumplimiento y auto-remediación. | **Túneles de Acceso Remoto**<br>Expón un servicio privado o tras NAT a través de un servidor de borde mediante WireGuard gestionado por el agente — sin redirección de puertos. |
+| **Onboarding Guiado**<br>Validar → prerrequisitos → Docker → emparejar agente, con un registro de progreso en vivo. | **Proxy por Servidor**<br>Traefik o Caddy dockerizados y opcionales por servidor, con vista previa del compose; el nginx del host sigue siendo el predeterminado. |
+
+### 📊 Monitorización y Alertas
+
+| | |
+|---|---|
+| **Métricas en Tiempo Real**<br>CPU, RAM, disco y red vía WebSocket, con retención histórica y seguimiento de disponibilidad. | **Monitorización de GPU**<br>Utilización, memoria y temperatura de NVIDIA, con uso por proceso y por contenedor. |
+| **Páginas de Estado**<br>Páginas públicas con comprobaciones HTTP/TCP/DNS/Ping, monitorización de componentes y gestión de incidentes. | **Notificaciones**<br>Discord, Slack, Telegram, email HTML y webhooks — canales por usuario, filtros de severidad y horas de silencio. |
+
+### 👥 Equipo y Acceso
+
+| | |
+|---|---|
+| **Espacios de Trabajo**<br>Aislamiento multi-inquilino con cuotas y gestión de miembros. | **RBAC**<br>Roles de administrador/desarrollador/observador con permisos granulares de lectura/escritura por funcionalidad. |
+| **SSO y OAuth**<br>Google, GitHub, OpenID Connect y SAML 2.0 con vinculación de cuentas. | **Claves de API**<br>Claves por niveles con limitación de tasa, ámbitos detallados, analíticas de uso y documentación OpenAPI. |
+| **Registro de Auditoría**<br>Cada acción de usuario queda registrada, con un panel de actividad detallado. | **Webhooks y Configuración Compartida**<br>Suscripciones salientes con firmas HMAC y reintentos, además de etiquetas y grupos de variables compartidos. |
+
+### 🎨 Personalización
+
+| | |
+|---|---|
+| **Ligero por Defecto**<br>El asistente de configuración instala solo las extensiones que encajan con tus casos de uso — añade más cuando quieras desde el Marketplace. | **Presets de Barra Lateral**<br>Vistas Completa, Hosting Web, Administración de Correo, DevOps o Mínima, con grupos plegables y diseños por usuario. |
+| **Tu Marca**<br>8 colores de acento predefinidos más un selector hexadecimal personalizado, y logotipo, nombre o banner de marca blanca. | **Widgets del Panel**<br>Activa y reordena widgets para adaptarlos a tu flujo de trabajo. |
---
## 🏗️ Arquitectura
+<img width="100%" alt="Arquitectura de ServerKit: los clientes y visitantes públicos llegan a una capa de borde nginx que dirige el tráfico del panel a la API de Flask y el tráfico público a los contenedores de aplicaciones; el panel de ServerKit contiene la SPA de React, la API REST, la pasarela de agentes Socket.IO, los servicios, modelos, trabajos, notificaciones y el runtime de extensiones; una capa de runtime en el mismo servidor alberga los contenedores Docker de aplicaciones, las bases de datos y el estado del panel; una flota remota de agentes en Go se conecta de vuelta a través del namespace /agent." src="images/architecture/system-overview.png" />
+
+**Nginx** termina TLS y divide el tráfico en dos: las peticiones del panel van a la **API de Flask** y todo lo demás se redirige al **contenedor Docker** que sirve ese dominio. El panel mantiene su propio estado en SQLite o PostgreSQL, ejecuta trabajo en segundo plano mediante un planificador de tareas y un bus de notificaciones, y carga funcionalidad opcional desde el **runtime de extensiones**. Los servidores remotos se gestionan con un **agente en Go** que se conecta de vuelta a través de un namespace de Socket.IO.
+
+<details>
+<summary><strong>Ver como diagrama ASCII</strong></summary>
+
```
┌──────────────────┐
│ INTERNET │
@@ -192,61 +240,58 @@ Consulta la [Guía de Instalación](INSTALLATION.md) para instrucciones paso a p
│ │ NGINX (Reverse Proxy) │ │
│ │ :80 / :443 │ │
│ │ │ │
-│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ │ │
-│ └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
-│ │ proxy_pass │ proxy_pass │ proxy_pass │
-│ ▼ ▼ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DOCKER CONTAINERS │ │
-│ │ │ │
-│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
-│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │
-│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │
-│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │
-│ └──────────┼──────────────────────────────────────────────────────────┘ │
-│ │ │
-│ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DATABASES │ │
-│ │ MySQL :3306 PostgreSQL :5432 Redis :6379 │ │
-│ └─────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────┘
+│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ /api/v1/ ──┐ │ │
+│ └───────────────┼──────────────┼──────────────────┼──────────────┼────┘ │
+│ │ proxy_pass │ proxy_pass │ proxy_pass │ │
+│ ▼ ▼ ▼ │ │
+│ ┌────────────────────────────────────────────────────────────┐ │ │
+│ │ DOCKER CONTAINERS │ │ │
+│ │ │ │ │
+│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │
+│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │ │
+│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │ │
+│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │ │
+│ └──────────┼─────────────────────────────────────────────────┘ │ │
+│ │ ▼ │
+│ │ ┌─────────────────────────────────┐ │
+│ │ │ SERVERKIT PANEL │ │
+│ │ │ React SPA · Flask REST API │ │
+│ │ │ Socket.IO · Jobs · Notify │ │
+│ │ │ Extension runtime │ │
+│ │ │ Gunicorn -w 1 (threaded) │ │
+│ │ └────────────────┬────────────────┘ │
+│ ▼ │ │
+│ ┌──────────────────────────────────┐ ┌─────────────▼────────────────┐ │
+│ │ DATABASES │ │ PANEL STATE │ │
+│ │ MySQL :3306 PostgreSQL :5432 │ │ SQLite (default) or │ │
+│ │ Redis :6379 MongoDB :27017 │ │ PostgreSQL · Alembic │ │
+│ └──────────────────────────────────┘ └──────────────────────────────┘ │
+└───────────────────────────────────────────────────────┼──────────────────┘
+ │
+ Socket.IO /agent (HMAC) │
+ + HTTP long-poll fallback ▼
+ ┌──────────────────────────────────────┐
+ │ REMOTE SERVERS — Go agent fleet │
+ │ server A · server B · server C │
+ └──────────────────────────────────────┘
```
-**[Ver Documentación Completa de Arquitectura →](ARCHITECTURE.md)** — Flujo de peticiones, sistema de plantillas, asignación de puertos, vinculación de bases de datos y resolución de problemas.
+</details>
+
+**[Ver Documentación Completa de Arquitectura →](ARCHITECTURE.md)** — Flujo de peticiones, plataforma de extensiones, sistema de plantillas, asignación de puertos, trabajos, notificaciones y la flota de agentes.
---
## 🗺️ Hoja de Ruta
-- [x] Infraestructura base — Flask + React + JWT + WebSocket
-- [x] Gestión de aplicaciones — PHP, Python, Node.js, Docker
-- [x] Dominios y SSL — Hosts virtuales Nginx, Let's Encrypt
-- [x] Bases de datos — MySQL, PostgreSQL
-- [x] Gestión de archivos y FTP
-- [x] Monitorización y alertas — Métricas, webhooks, seguimiento de disponibilidad
-- [x] Seguridad — 2FA, ClamAV, integridad de archivos, Fail2ban
-- [x] Firewall — Integración con UFW
-- [x] Gestión multi-servidor — Agente en Go, panel centralizado
-- [x] Despliegue con Git — Webhooks, despliegue automático, rollback, sin tiempo de inactividad
-- [ ] Copias de seguridad y restauración — S3, Backblaze B2, copias programadas
-- [ ] Servidor de correo — Postfix, Dovecot, DKIM/SPF/DMARC
-- [ ] Equipos y permisos — RBAC, registro de auditoría
-- [ ] Aplicación móvil — React Native con notificaciones push
-- [ ] Marketplace de plugins — Extensiones, widgets personalizados, temas
-- [x] Firewall de Aplicaciones Web — ModSecurity v3 + OWASP CRS por aplicación
-- [x] Seguridad de contenedores — Análisis de CVE de imágenes (grype) + SBOM (syft)
-- [x] Autenticación sin contraseña — WebAuthn / passkeys
-- [x] DNS dinámico — Actualizaciones A/AAAA autenticadas por token
-- [x] Monitorización de GPU — Utilización, memoria y procesos de NVIDIA
-- [x] Ciclo de vida de contenedores — Aplicación de actualizaciones de imagen, suspensión automática, escalado horizontal automático
-- [x] Refuerzo de TLS — HTTPS opcional, configuraciones compatibles con Cloudflare, CAA automático
-- [x] Gestor de secretos y pasarela de webhooks entrantes
-- [x] Acceso remoto — Expón servicios privados/tras NAT mediante túneles WireGuard gestionados por el agente
-- [x] Centro de conexiones — Cuentas externas unificadas (origen, nube, DNS, registradores, SMTP, almacenamiento)
-- [x] Publicación de WordPress — Subdominios reales, intercambio de URL, dominios personalizados, HTTPS comodín
-
-Detalles completos: [ROADMAP.md](../ROADMAP.md)
+**El núcleo de ServerKit está completo** — todas las fases previstas del núcleo se han entregado, desde la primera infraestructura Flask + React hasta las flotas multi-servidor, SSO, el motor de automatización y el marketplace de extensiones.
+
+El desarrollo ocurre ahora en dos frentes:
+
+- **🧩 Extensiones** — la nueva funcionalidad se distribuye como extensiones instalables desde el Marketplace (más de 100 plantillas en un clic y creciendo). El núcleo se mantiene ligero; instalas solo lo que necesitas.
+- **✨ Pulido del núcleo** — refinamientos continuos de UI/UX y correcciones de problemas reportados por la comunidad. No hay nuevas funcionalidades de núcleo planificadas.
+
+Historial completo: [ROADMAP.md](../ROADMAP.md)
---
@@ -257,8 +302,12 @@ Detalles completos: [ROADMAP.md](../ROADMAP.md)
| [Arquitectura](ARCHITECTURE.md) | Diseño del sistema, flujo de peticiones, diagramas |
| [Guía de Instalación](INSTALLATION.md) | Instrucciones completas de configuración |
| [Guía de Despliegue](DEPLOYMENT.md) | Comandos CLI y despliegue en producción |
+| [Agente](https://github.com/jhd3197/serverkit-agent) | Instala y ejecuta el agente multi-servidor (Linux/Windows/macOS) — repositorio aparte |
+| [Emparejamiento del Agente](pairing.md) | Enrolamiento seguro del agente con código corto |
| [Referencia de la API](API.md) | Endpoints de la API REST |
| [Nuevas Funcionalidades](NEW_FEATURES.md) | Referencia de endpoints y páginas de las últimas funcionalidades de `dev` |
+| [Mejoras](ENHANCEMENTS.md) | Guía de las diez capacidades de experiencia de desarrollo, equipo/escala, flota y seguridad |
+| [Registro de Cambios](../CHANGELOG.md) | Historial de versiones y cambios destacados |
| [Hoja de Ruta](../ROADMAP.md) | Hoja de ruta de desarrollo y funcionalidades planificadas |
| [Contribuir](../CONTRIBUTING.md) | Cómo contribuir |
@@ -268,12 +317,15 @@ Detalles completos: [ROADMAP.md](../ROADMAP.md)
| Capa | Tecnología |
|-------|------------|
-| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
-| Frontend | React 18, Vite, SCSS |
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO, Flask-Migrate |
+| Frontend | React 18, Vite, SCSS, Recharts |
| Base de Datos | SQLite / PostgreSQL |
-| Servidor Web | Nginx, Gunicorn |
+| Servidor Web | Nginx, Gunicorn (worker único con hilos — `-w 1 --threads N`) |
| Contenedores | Docker, Docker Compose |
-| Seguridad | ClamAV, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), Cryptography |
+| Seguridad | ClamAV, Lynis, Fail2ban, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), cifrado Fernet |
+| Autenticación | JWT, OAuth 2.0, OIDC, SAML 2.0, WebAuthn / passkeys |
+| Correo | Postfix, Dovecot, SpamAssassin, Roundcube |
+| Agente | Go (multi-servidor), HMAC-SHA256, WebSocket |
---
@@ -282,10 +334,20 @@ Detalles completos: [ROADMAP.md](../ROADMAP.md)
¡Las contribuciones son bienvenidas! Por favor, lee primero [CONTRIBUTING.md](../CONTRIBUTING.md).
```
-fork → rama de funcionalidad → commit → push → pull request
+fork → feature branch → commit → push → pull request
```
-**Áreas prioritarias:** Implementación de copias de seguridad, canales de notificación adicionales, mejoras de UI/UX, documentación.
+**Áreas prioritarias:** Extensiones para el Marketplace, mejoras de UI/UX, documentación, cobertura de tests.
+
+---
+
+## 💛 Apoya a ServerKit
+
+ServerKit es libre y de código abierto. Si te ahorra tiempo, puedes ayudar a mantenerlo en marcha:
+
+- ⭐ [Dale una estrella al repositorio](https://github.com/jhd3197/ServerKit) — no cuesta nada y ayuda mucho
+- 💖 [GitHub Sponsors](https://github.com/sponsors/jhd3197)
+- ☕ [Buy Me a Coffee](https://buymeacoffee.com/jhd3197)
---
@@ -295,6 +357,10 @@ fork → rama de funcionalidad → commit → push → pull request
> ServerKit gestiona tus servidores desde el navegador; Faro es el compañero de escritorio para transferencias de archivos, shells y trabajo puntual en todos tus servidores. [Descarga una versión →](https://github.com/jhd3197/faro/releases/latest)
+**[LocalKit](https://github.com/jhd3197/LocalKit)** — Levanta sitios WordPress locales en un clic. Cada sitio se ejecuta como su propio proyecto aislado de Docker Compose, y puedes enviar código o enviar/traer bases de datos directamente a tu servidor ServerKit mediante la extensión `serverkit-localkit`.
+
+**[DeviceKit](https://github.com/jhd3197/DeviceKit)** — Una plataforma unificada de flota de dispositivos Android y automatización de pruebas. Controla una flota de dispositivos desde un solo panel — ejecuta automatizaciones, transmite pantallas en tiempo real, detecta regresiones visuales y depura fallos con análisis asistido por IA.
+
---
## 💬 Comunidad
diff --git a/docs/README.pt.md b/docs/README.pt.md
index 8720eba5..3ddf2de6 100644
--- a/docs/README.pt.md
+++ b/docs/README.pt.md
@@ -1,8 +1,8 @@
<div align="center">
-# ServerKit
+<img width="100%" alt="ServerKit — Implante, gerencie e monitore servidores" src="screenshots/poster.png" />
-<img width="100%" alt="ServerKit — Deploy, manage, and monitor servers" src="screenshots/poster.png" />
+# ServerKit
**Implante, gerencie e monitore servidores.**
@@ -18,6 +18,8 @@ ou o custo de plataformas gerenciadas.
![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
[![Discord](https://img.shields.io/discord/1470639209059455008?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/ZKk6tkCQfG)
+[![GitHub Stars](https://img.shields.io/github/stars/jhd3197/ServerKit?style=flat-square&color=f5c542)](https://github.com/jhd3197/ServerKit/stargazers)
+[![Downloads](https://img.shields.io/github/downloads/jhd3197/ServerKit/total?style=flat-square)](https://github.com/jhd3197/ServerKit/releases)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](../LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=flat-square&logo=react&logoColor=black)](https://reactjs.org)
@@ -27,82 +29,12 @@ ou o custo de plataformas gerenciadas.
<br>
-[Funcionalidades](#-funcionalidades) · [Início Rápido](#-início-rápido) · [Capturas de Tela](#-capturas-de-tela) · [Arquitetura](#-arquitetura) · [Roadmap](#-roadmap) · [Documentação](#-documentação) · [Contribuindo](#-contribuindo) · [Discord](#-comunidade)
+[Início Rápido](#-início-rápido) · [Capturas de Tela](#-capturas-de-tela) · [Funcionalidades](#-funcionalidades) · [Arquitetura](#-arquitetura) · [Roadmap](#-roadmap) · [Documentação](#-documentação) · [Contribuindo](#-contribuindo) · [Discord](#-comunidade)
</div>
---
-<p align="center">
- <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
-</p>
-
----
-
-## 🎯 Funcionalidades
-
-### Aplicações & Containers
-
-🐘 **PHP / WordPress** — PHP-FPM 8.x com instalação do WordPress em um clique
-
-🐍 **Aplicações Python** — Deploy de Flask e Django com Gunicorn
-
-🟢 **Node.js** — Aplicações gerenciadas pelo PM2 com streaming de logs
-
-📦 **Deploys Manuais & Zip** — Faça deploy a partir de um caminho local/manual ou de um upload zip, além das fontes Git e Docker
-
-🐳 **Docker** — Gerenciamento completo de containers e Docker Compose
-
-🔄 **Ciclo de Vida de Containers** — Detecção de atualizações de imagem com aplicação em um clique, suspensão automática de containers ociosos e auto-escalonamento horizontal orientado por CPU
-
-🔑 **Variáveis de Ambiente** — Gerenciamento seguro e criptografado por aplicação
-
-### Infraestrutura
-
-🌐 **Gerenciamento de Domínios** — Virtual hosts Nginx com configuração simplificada
-
-🔒 **SSL / TLS** — Let's Encrypt automático com renovação automática, HTTPS opcional (de melhor esforço) que nunca bloqueia uma instalação, cifras TLS 1.2+/AEAD reforçadas, configurações compatíveis com Cloudflare e registros CAA automáticos
-
-🗄️ **Bancos de Dados** — Suporte a MySQL/MariaDB e PostgreSQL
-
-🛡️ **Firewall (UFW)** — Gerenciamento visual de regras de firewall
-
-⏰ **Cron Jobs** — Agendamento de tarefas com editor visual
-
-📁 **Gerenciador de Arquivos** — Navegue e edite arquivos pela interface web, incluindo navegar e visualizar buckets S3 / Backblaze B2
-
-📡 **Servidor FTP** — Gerencie usuários e acessos do vsftpd
-
-### Segurança
-
-🔐 **Autenticação de Dois Fatores** — Baseada em TOTP com códigos de recuperação
-
-🔑 **Passkeys / WebAuthn** — Login sem senha e como segundo fator com chaves de hardware, Touch ID e Windows Hello
-
-🧯 **Firewall de Aplicações Web** — ModSecurity v3 + OWASP Core Rule Set por aplicação, com modos de detecção/bloqueio, paranoia ajustável e eventos no log de auditoria
-
-🦠 **Varredura de Malware** — Integração com ClamAV e quarentena
-
-📋 **Monitoramento de Integridade de Arquivos** — Detecção de alterações não autorizadas
-
-🚨 **Alertas de Segurança** — Notificações de ameaças em tempo real
-
-🧱 **Fail2ban & SSH** — Proteção contra força bruta e gerenciamento de chaves SSH
-
-### Monitoramento & Alertas
-
-📊 **Métricas em Tempo Real** — Monitoramento de CPU, RAM, disco e rede via WebSocket
-
-🎮 **Monitoramento de GPU** — Utilização, memória, temperatura e consumo de GPUs NVIDIA, com uso por processo e por container
-
-📈 **Rastreamento de Uptime** — Histórico de disponibilidade do servidor
-
-🔔 **Notificações** — Discord, Slack, Telegram e webhooks genéricos
-
-🖥️ **Multi-Servidor** — Monitoramento e gerenciamento remoto de servidores baseado em agentes
-
----
-
## 🚀 Início Rápido
> ⏱️ Pronto para usar em menos de 2 minutos
@@ -113,7 +45,19 @@ ou o custo de plataformas gerenciadas.
curl -fsSL https://serverkit.ai/install.sh | bash
```
-> Funciona no Ubuntu 22.04+ e Debian 12+. Configura tudo automaticamente.
+> Funciona no Ubuntu 22.04+, Debian 12+, Fedora e RHEL/Rocky/AlmaLinux 9+. Configura tudo automaticamente.
+>
+> Opcional: `PANEL_DOMAIN=panel.example.com` define o domínio e tenta usar o Let's Encrypt; `SERVERKIT_OFFLINE_TARBALL=...` instala a partir de um tarball local.
+
+### Atualização
+
+```bash
+sudo serverkit update
+```
+
+Atualização atômica blue/green com verificações prévias, backup do banco de dados, migração e
+rollback automático. Use `--dry-run` para pré-visualizar, `--branch dev` para builds de desenvolvimento
+ou `--release [versão]` para tarballs de release.
### Opção 2: Docker
@@ -142,43 +86,147 @@ Consulte o [Guia de Instalação](INSTALLATION.md) para instruções passo a pas
## 📸 Capturas de Tela
-<p align="center">
+> Capturadas em um build de demonstração com dados fictícios — todos os hostnames, IPs, domínios e métricas abaixo são fictícios.
+
+| Dashboard | Serviços |
+| :--------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Dashboard](screenshots/dashboard.png) | ![Serviços](screenshots/services.png) |
+| _Métricas do servidor em tempo real, cartões de KPI e atividade recente_ | _Aplicações estáticas, Node.js, Python, PHP e Docker_ |
-![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+| Docker | WordPress |
+| :-------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Docker](screenshots/docker.png) | ![WordPress](screenshots/wordpress.png) |
+| _Containers, imagens, volumes e redes com CPU/RAM em tempo real_ | _Status por site, Ações Rápidas e verificações de saúde ao vivo_ |
-</p>
+| Frota de Agentes | Marketplace |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Frota de Agentes](screenshots/fleet.png) | ![Marketplace](screenshots/marketplace.png) |
+| _Saúde da frota, distribuição de versões e fila de comandos_ | _Templates de aplicações em um clique e extensões instaláveis_ |
+
+| Monitoramento | Segurança |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Monitoramento](screenshots/monitoring.png) | ![Segurança](screenshots/security.png) |
+| _Medidores ao vivo, regras de alerta e canais de notificação_ | _Pontuação de postura, ClamAV, integridade de arquivos, firewall, Fail2Ban_ |
<details>
-<summary><strong>Ver Mais Capturas de Tela</strong></summary>
+<summary><strong>Ver todas as capturas de tela</strong></summary>
<br>
-<p align="center">
- <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
-</p>
+| Assistente de IA | Detalhe do Serviço |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Assistente de IA](screenshots/ai.png) | ![Detalhe do Serviço](screenshots/service-detail.png) |
+| _Assistente com tecnologia Prompture que executa ferramentas na sua infraestrutura_ | _Deploys, conexão git, uso em tempo real, logs e configurações_ |
+
+| Bancos de Dados | Console SQL |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Bancos de Dados](screenshots/databases.png) | ![Console SQL](screenshots/sql.png) |
+| _Explorador MySQL / PostgreSQL / SQLite com árvore de origem_ | _Execute SQL pelo navegador com uma grade de resultados tipada_ |
+
+| Domínios | Zonas DNS |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Domínios](screenshots/domains.png) | ![Zonas DNS](screenshots/dns.png) |
+| _Status SSL, acompanhamento de expiração e renovação automática_ | _Cloudflare, Route 53, DigitalOcean — edição completa de registros_ |
+
+| Backups | E-mail |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Backups](screenshots/backups.png) | ![E-mail](screenshots/email.png) |
+| _Backups agendados com sincronização S3/B2 e restauração em um clique_ | _Postfix, Dovecot, OpenDKIM, SpamAssassin e Roundcube_ |
+
+| Cron Jobs | Gerenciador de Arquivos |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Cron Jobs](screenshots/cron.png) | ![Gerenciador de Arquivos](screenshots/files.png) |
+| _Editor visual de cron com agendamento legível por humanos_ | _Navegue, edite e envie arquivos com uso de disco por ponto de montagem_ |
+
+| Logs & Terminal | Servidores |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Logs & Terminal](screenshots/terminal.png) | ![Servidores](screenshots/servers.png) |
+| _Visualizador de logs, lista de processos, journald e sessões SSH_ | _Todos os servidores em um painel com telemetria de CPU/RAM/disco ao vivo_ |
+
+| Acesso Remoto | Configurações |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Acesso Remoto](screenshots/remote-access.png) | ![Configurações](screenshots/settings.png) |
+| _Exponha publicamente serviços atrás de NAT via agentes pareados por WireGuard_ | _Perfil, aparência/identidade visual, usuários e conexões_ |
+
+| Login | |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Login](screenshots/login.png) | |
+| _Login com e-mail/senha, com suporte a SSO e 2FA_ | |
-<p align="center">
- <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
-</p>
+</details>
-<p align="center">
- <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
-</p>
+## 🎯 Funcionalidades
-<p align="center">
- <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
-</p>
+> **O núcleo está completo em funcionalidades.** Novos recursos são entregues como **extensões** instaláveis pelo Marketplace integrado — o núcleo permanece enxuto e estável, com o trabalho em andamento focado em refinamentos de UI e correções reportadas pela comunidade.
-<p align="center">
- <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
-</p>
+### 🚀 Aplicações & Deploy
-</details>
+| | |
+|---|---|
+| **WordPress em Um Clique**<br>Sites PHP-FPM 8.x publicados em subdomínios reais, com pré-visualizações por troca de URL, domínios personalizados e HTTPS wildcard. | **Qualquer Stack**<br>Flask/Django no Gunicorn, Node.js no PM2, sites estáticos — a partir do Git, Docker, um caminho manual ou um upload zip. |
+| **Docker & Compose**<br>Detecção de atualizações de imagem com aplicação em um clique, suspensão automática de containers ociosos, auto-escalonamento orientado por CPU, logs ao vivo e acesso ao terminal. | **Marketplace**<br>Mais de 100 templates de aplicações em um clique sobre um schema declarativo com secrets, hosts e URLs resolvidos automaticamente — nada fixo no código. |
+| **Build Packs**<br>Deploys sem Dockerfile: inspeciona um repositório e gera um Dockerfile + compose a partir de um plano de build. | **Automações**<br>Automação visual baseada em nós para tarefas, deploys e CI/CD — gatilhos de cron, webhook e eventos, executando em um container gerenciado. Entregue como extensão. |
+| **Prévias & Snapshots**<br>Ambientes efêmeros de prévia de PR, além de snapshots de configuração imutáveis e com secrets mascarados, com diff e restauração em um clique. | **Projetos & Ambientes**<br>Agrupamento Workspace → Projeto → Ambiente, e um pipeline WordPress prod/staging/dev com promoção de código e banco de dados. |
+
+### 🏗️ Infraestrutura
+
+| | |
+|---|---|
+| **Domínios & SSL**<br>Virtual hosts Nginx, Let's Encrypt automático com renovação, TLS 1.2+/AEAD reforçado, configurações compatíveis com Cloudflare, CAA automático. | **Zonas DNS**<br>Gerenciamento completo de registros no Cloudflare, Route 53 e DigitalOcean — verificações de propagação e DNS dinâmico para IPs que mudam. |
+| **Bancos de Dados**<br>MySQL/MariaDB e PostgreSQL com gerenciamento de usuários, árvore de origem ao vivo e um console SQL no navegador. | **Provisionamento em Nuvem**<br>Crie servidores na DigitalOcean, Hetzner, Vultr e Linode com acompanhamento de custos. |
+| **Hub de Conexões**<br>Provedores Git, nuvens, DNS, registradores, relays SMTP e armazenamento S3/B2 — todas as contas externas em um só lugar, criptografadas em repouso. | **Backups**<br>Backups agendados de aplicações/bancos de dados/arquivos para S3, B2 ou local, com políticas de retenção, restauração em um clique e criptografia opcional do lado do cliente. |
+| **Arquivos, FTP & Cron**<br>Gerenciador de arquivos web com navegação de buckets S3/B2, gerenciamento de usuários vsftpd e um editor visual de cron. | **Servidor de E-mail**<br>Postfix + Dovecot com DKIM/SPF/DMARC, SpamAssassin, webmail Roundcube e regras de encaminhamento. |
+
+### 🔒 Segurança
+
+| | |
+|---|---|
+| **Firewall de Aplicações Web**<br>ModSecurity v3 + OWASP Core Rule Set por aplicação, com modos de detecção/bloqueio e paranoia ajustável. | **Passkeys & 2FA**<br>Login sem senha com WebAuthn (chaves de hardware, Touch ID, Windows Hello) mais TOTP com códigos de recuperação. |
+| **Malware & Integridade**<br>Varredura com ClamAV e quarentena, monitoramento de integridade de arquivos e auditorias de vulnerabilidades com Lynis. | **SSH & Reforço**<br>Fail2ban, gerenciamento de chaves SSH, listas de permissão/bloqueio de IP e atualizações automáticas de segurança do SO. |
+| **Varredura de Containers**<br>Varredura de CVEs por imagem com grype e geração de SBOM com syft. | **Secrets Criptografados**<br>Credenciais de provedores e secrets selados com Fernet, além de um gateway de webhooks de entrada para automação externa. |
+
+### 🖥️ Multi-Servidor
+
+| | |
+|---|---|
+| **Agente Multiplataforma**<br>Agente em Go para Linux, Windows e macOS — autenticação HMAC-SHA256 sobre um gateway WebSocket em tempo real. Serviço nativo do Windows + MSI, `.deb`/`.rpm`, ARM64. [Mais →](https://github.com/jhd3197/serverkit-agent) | **Gerenciamento de Frota**<br>Inventário, fila de aprovação, distribuição escalonada de versões, descoberta automática na LAN e uma fila de comandos offline. |
+| **Registro Fácil**<br>Pareamento por código curto com verificação de fingerprint ou tokens pré-compartilhados; credenciais de host armazenadas com criptografia AES-GCM. [Mais →](pairing.md) | **Monitor de Frota**<br>Mapas de calor entre servidores, comparações de métricas, limiares de alerta, detecção de anomalias e previsão de capacidade. |
+| **Templates de Servidor**<br>Templates de estado esperado com detecção de desvio, dashboards de conformidade e correção automática. | **Túneis de Acesso Remoto**<br>Exponha um serviço privado/atrás de NAT através de um servidor de borda usando WireGuard gerenciado pelo agente — sem redirecionamento de portas. |
+| **Onboarding Guiado**<br>Validar → pré-requisitos → Docker → parear agente, com um log de progresso ao vivo. | **Proxy por Servidor**<br>Traefik ou Caddy dockerizados e opcionais por servidor, com prévia do compose; o nginx do host continua sendo o padrão. |
+
+### 📊 Monitoramento & Alertas
+
+| | |
+|---|---|
+| **Métricas em Tempo Real**<br>CPU, RAM, disco e rede via WebSocket, com retenção histórica e acompanhamento de uptime. | **Monitoramento de GPU**<br>Utilização, memória e temperatura de GPUs NVIDIA, além de uso por processo e por container. |
+| **Páginas de Status**<br>Páginas públicas com verificações HTTP/TCP/DNS/Ping, monitoramento de componentes e gerenciamento de incidentes. | **Notificações**<br>Discord, Slack, Telegram, e-mail HTML e webhooks — canais por usuário, filtros de severidade e horários de silêncio. |
+
+### 👥 Equipe & Acesso
+
+| | |
+|---|---|
+| **Workspaces**<br>Isolamento multi-tenant com quotas e gerenciamento de membros. | **RBAC**<br>Papéis de admin/desenvolvedor/visualizador com permissões granulares de leitura/escrita por funcionalidade. |
+| **SSO & OAuth**<br>Google, GitHub, OpenID Connect e SAML 2.0 com vinculação de contas. | **Chaves de API**<br>Chaves em camadas com rate limiting, escopos refinados, análise de uso e documentação OpenAPI. |
+| **Log de Auditoria**<br>Cada ação do usuário registrada, com um dashboard detalhado de atividades. | **Webhooks & Configuração Compartilhada**<br>Assinaturas de saída com assinaturas HMAC e retentativas, além de tags e grupos de variáveis compartilhados. |
+
+### 🎨 Personalização
+
+| | |
+|---|---|
+| **Enxuto por Padrão**<br>O assistente de configuração instala apenas as extensões que correspondem aos seus casos de uso — adicione mais quando quiser pelo Marketplace. | **Presets de Barra Lateral**<br>Visões Completa, Hospedagem Web, Admin de E-mail, DevOps ou Mínima, com grupos recolhíveis e layouts por usuário. |
+| **Sua Marca**<br>8 cores de destaque predefinidas mais um seletor hexadecimal personalizado, e logo, nome ou banner white-label. | **Widgets do Dashboard**<br>Ative e reordene widgets para se adequar ao seu fluxo de trabalho. |
---
## 🏗️ Arquitetura
+<img width="100%" alt="Arquitetura do ServerKit: clientes e visitantes públicos chegam a uma camada de borda nginx que divide o tráfego do painel para a API Flask e o tráfego público para os containers das aplicações; o painel ServerKit contém a SPA React, a API REST, o gateway de agentes Socket.IO, os serviços, models, jobs, notificações e o runtime de extensões; uma camada de runtime no mesmo servidor contém os containers Docker das aplicações, os bancos de dados e o estado do painel; uma frota remota de agentes em Go se conecta de volta pelo namespace /agent." src="images/architecture/system-overview.png" />
+
+O **Nginx** termina o TLS e divide o tráfego em dois caminhos: as requisições do painel vão para a **API Flask**, todo o resto é encaminhado por proxy para o **container Docker** que serve aquele domínio. O painel mantém seu próprio estado em SQLite ou PostgreSQL, executa trabalho em segundo plano através de um agendador de jobs e de um barramento de notificações, e carrega funcionalidades opcionais a partir do **runtime de extensões**. Servidores remotos são gerenciados por um **agente em Go** que se conecta de volta através de um namespace Socket.IO.
+
+<details>
+<summary><strong>Ver como diagrama ASCII</strong></summary>
+
```
┌──────────────────┐
│ INTERNET │
@@ -192,61 +240,58 @@ Consulte o [Guia de Instalação](INSTALLATION.md) para instruções passo a pas
│ │ NGINX (Reverse Proxy) │ │
│ │ :80 / :443 │ │
│ │ │ │
-│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ │ │
-│ └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
-│ │ proxy_pass │ proxy_pass │ proxy_pass │
-│ ▼ ▼ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DOCKER CONTAINERS │ │
-│ │ │ │
-│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
-│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │
-│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │
-│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │
-│ └──────────┼──────────────────────────────────────────────────────────┘ │
-│ │ │
-│ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DATABASES │ │
-│ │ MySQL :3306 PostgreSQL :5432 Redis :6379 │ │
-│ └─────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────┘
+│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ /api/v1/ ──┐ │ │
+│ └───────────────┼──────────────┼──────────────────┼──────────────┼────┘ │
+│ │ proxy_pass │ proxy_pass │ proxy_pass │ │
+│ ▼ ▼ ▼ │ │
+│ ┌────────────────────────────────────────────────────────────┐ │ │
+│ │ DOCKER CONTAINERS │ │ │
+│ │ │ │ │
+│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │
+│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │ │
+│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │ │
+│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │ │
+│ └──────────┼─────────────────────────────────────────────────┘ │ │
+│ │ ▼ │
+│ │ ┌─────────────────────────────────┐ │
+│ │ │ SERVERKIT PANEL │ │
+│ │ │ React SPA · Flask REST API │ │
+│ │ │ Socket.IO · Jobs · Notify │ │
+│ │ │ Extension runtime │ │
+│ │ │ Gunicorn -w 1 (threaded) │ │
+│ │ └────────────────┬────────────────┘ │
+│ ▼ │ │
+│ ┌──────────────────────────────────┐ ┌─────────────▼────────────────┐ │
+│ │ DATABASES │ │ PANEL STATE │ │
+│ │ MySQL :3306 PostgreSQL :5432 │ │ SQLite (default) or │ │
+│ │ Redis :6379 MongoDB :27017 │ │ PostgreSQL · Alembic │ │
+│ └──────────────────────────────────┘ └──────────────────────────────┘ │
+└───────────────────────────────────────────────────────┼──────────────────┘
+ │
+ Socket.IO /agent (HMAC) │
+ + HTTP long-poll fallback ▼
+ ┌──────────────────────────────────────┐
+ │ REMOTE SERVERS — Go agent fleet │
+ │ server A · server B · server C │
+ └──────────────────────────────────────┘
```
-**[Ver Documentação Completa da Arquitetura →](ARCHITECTURE.md)** — Fluxo de requisições, sistema de templates, alocação de portas, vinculação de bancos de dados e solução de problemas.
+</details>
+
+**[Ver Documentação Completa da Arquitetura →](ARCHITECTURE.md)** — Fluxo de requisições, plataforma de extensões, sistema de templates, alocação de portas, jobs, notificações e a frota de agentes.
---
## 🗺️ Roadmap
-- [x] Infraestrutura base — Flask + React + JWT + WebSocket
-- [x] Gerenciamento de aplicações — PHP, Python, Node.js, Docker
-- [x] Domínio & SSL — Virtual hosts Nginx, Let's Encrypt
-- [x] Bancos de dados — MySQL, PostgreSQL
-- [x] Gerenciamento de arquivos & FTP
-- [x] Monitoramento & alertas — Métricas, webhooks, rastreamento de uptime
-- [x] Segurança — 2FA, ClamAV, integridade de arquivos, Fail2ban
-- [x] Firewall — Integração com UFW
-- [x] Gerenciamento multi-servidor — Agente em Go, painel centralizado
-- [x] Deploy via Git — Webhooks, deploy automático, rollback, zero-downtime
-- [ ] Backup & restauração — S3, Backblaze B2, backups agendados
-- [ ] Servidor de e-mail — Postfix, Dovecot, DKIM/SPF/DMARC
-- [ ] Equipes & permissões — RBAC, log de auditoria
-- [ ] Aplicativo mobile — React Native com notificações push
-- [ ] Marketplace de plugins — Extensões, widgets personalizados, temas
-- [x] Firewall de aplicações web — ModSecurity v3 + OWASP CRS por aplicação
-- [x] Segurança de containers — Varredura de CVEs de imagem (grype) + SBOM (syft)
-- [x] Autenticação sem senha — WebAuthn / passkeys
-- [x] DNS dinâmico — Atualizações A/AAAA autenticadas por token
-- [x] Monitoramento de GPU — Utilização, memória e processos NVIDIA
-- [x] Ciclo de vida de containers — Aplicação de atualização de imagem, suspensão automática, auto-escalonamento horizontal
-- [x] Reforço de TLS — HTTPS opcional, configurações compatíveis com Cloudflare, CAA automático
-- [x] Gerenciador de secrets & gateway de webhooks de entrada
-- [x] Acesso remoto — Exponha serviços privados/NAT via túneis WireGuard gerenciados por agente
-- [x] Hub de conexões — Contas externas unificadas (fonte, nuvem, DNS, registradores, SMTP, armazenamento)
-- [x] Publicação WordPress — Subdomínios reais, troca de URL, domínios personalizados, HTTPS wildcard
-
-Detalhes completos: [ROADMAP.md](../ROADMAP.md)
+**O núcleo do ServerKit está completo em funcionalidades** — todas as fases centrais planejadas foram entregues, desde a infraestrutura inicial em Flask + React até frotas multi-servidor, SSO, o motor de automação e o marketplace de extensões.
+
+O desenvolvimento agora acontece em duas frentes:
+
+- **🧩 Extensões** — novas funcionalidades são entregues como extensões instaláveis pelo Marketplace (mais de 100 templates em um clique, e crescendo). O núcleo permanece enxuto; você instala apenas o que precisa.
+- **✨ Refinamento do núcleo** — refinamentos contínuos de UI/UX e correções para problemas reportados pela comunidade. Nenhuma nova funcionalidade central está planejada.
+
+Histórico completo: [ROADMAP.md](../ROADMAP.md)
---
@@ -257,8 +302,12 @@ Detalhes completos: [ROADMAP.md](../ROADMAP.md)
| [Arquitetura](ARCHITECTURE.md) | Design do sistema, fluxo de requisições, diagramas |
| [Guia de Instalação](INSTALLATION.md) | Instruções completas de configuração |
| [Guia de Deploy](DEPLOYMENT.md) | Comandos CLI e deploy em produção |
+| [Agente](https://github.com/jhd3197/serverkit-agent) | Instale e execute o agente multi-servidor (Linux/Windows/macOS) — repositório separado |
+| [Pareamento de Agentes](pairing.md) | Registro seguro de agentes por código curto |
| [Referência da API](API.md) | Endpoints da API REST |
| [Novas Funcionalidades](NEW_FEATURES.md) | Referência de endpoints e páginas das funcionalidades mais recentes de `dev` |
+| [Melhorias](ENHANCEMENTS.md) | Guia das dez capacidades de experiência do desenvolvedor, equipe/escala, frota e segurança |
+| [Changelog](../CHANGELOG.md) | Histórico de releases e mudanças notáveis |
| [Roadmap](../ROADMAP.md) | Roadmap de desenvolvimento e funcionalidades planejadas |
| [Contribuindo](../CONTRIBUTING.md) | Como contribuir |
@@ -268,12 +317,15 @@ Detalhes completos: [ROADMAP.md](../ROADMAP.md)
| Camada | Tecnologia |
|-------|------------|
-| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
-| Frontend | React 18, Vite, SCSS |
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO, Flask-Migrate |
+| Frontend | React 18, Vite, SCSS, Recharts |
| Banco de Dados | SQLite / PostgreSQL |
-| Servidor Web | Nginx, Gunicorn |
+| Servidor Web | Nginx, Gunicorn (worker único com threads — `-w 1 --threads N`) |
| Containers | Docker, Docker Compose |
-| Segurança | ClamAV, TOTP (pyotp), Cryptography, ModSecurity v3 + OWASP CRS, grype, syft |
+| Segurança | ClamAV, Lynis, Fail2ban, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), criptografia Fernet |
+| Autenticação | JWT, OAuth 2.0, OIDC, SAML 2.0, WebAuthn / passkeys |
+| E-mail | Postfix, Dovecot, SpamAssassin, Roundcube |
+| Agente | Go (multi-servidor), HMAC-SHA256, WebSocket |
---
@@ -285,7 +337,17 @@ Contribuições são bem-vindas! Por favor, leia o [CONTRIBUTING.md](../CONTRIBU
fork → branch de feature → commit → push → pull request
```
-**Áreas prioritárias:** Implementações de backup, canais de notificação adicionais, melhorias de UI/UX, documentação.
+**Áreas prioritárias:** Extensões do Marketplace, melhorias de UI/UX, documentação, cobertura de testes.
+
+---
+
+## 💛 Apoie o ServerKit
+
+O ServerKit é gratuito e de código aberto. Se ele economiza o seu tempo, você pode ajudar a mantê-lo:
+
+- ⭐ [Dê uma estrela ao repositório](https://github.com/jhd3197/ServerKit) — não custa nada e ajuda muito
+- 💖 [GitHub Sponsors](https://github.com/sponsors/jhd3197)
+- ☕ [Buy Me a Coffee](https://buymeacoffee.com/jhd3197)
---
@@ -295,6 +357,10 @@ fork → branch de feature → commit → push → pull request
> O ServerKit gerencia seus servidores pelo navegador; o Faro é o companheiro de desktop para transferência de arquivos, shells e trabalho pontual em todos os seus servidores. [Baixe uma versão →](https://github.com/jhd3197/faro/releases/latest)
+**[LocalKit](https://github.com/jhd3197/LocalKit)** — Crie sites WordPress locais em um clique. Cada site roda como seu próprio projeto Docker Compose isolado, e você pode enviar código ou enviar/baixar bancos de dados diretamente para o seu servidor ServerKit através da extensão `serverkit-localkit`.
+
+**[DeviceKit](https://github.com/jhd3197/DeviceKit)** — Uma plataforma unificada de frota de dispositivos Android e automação de testes. Controle uma frota de dispositivos a partir de um único dashboard — execute automações, transmita telas em tempo real, detecte regressões visuais e depure falhas com análise assistida por IA.
+
---
## 💬 Comunidade
diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md
index c4df0034..5f8dc4fc 100644
--- a/docs/README.zh-CN.md
+++ b/docs/README.zh-CN.md
@@ -1,8 +1,8 @@
<div align="center">
-# ServerKit
+<img width="100%" alt="ServerKit — 部署、管理和监控服务器" src="screenshots/poster.png" />
-<img width="100%" alt="ServerKit — Deploy, manage, and monitor servers" src="screenshots/poster.png" />
+# ServerKit
**部署、管理和监控服务器。**
@@ -18,6 +18,8 @@ Docker 容器和安全策略——无需 Kubernetes 的复杂性,
![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
[![Discord](https://img.shields.io/discord/1470639209059455008?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/ZKk6tkCQfG)
+[![GitHub Stars](https://img.shields.io/github/stars/jhd3197/ServerKit?style=flat-square&color=f5c542)](https://github.com/jhd3197/ServerKit/stargazers)
+[![Downloads](https://img.shields.io/github/downloads/jhd3197/ServerKit/total?style=flat-square)](https://github.com/jhd3197/ServerKit/releases)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](../LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=flat-square&logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=flat-square&logo=react&logoColor=black)](https://reactjs.org)
@@ -27,82 +29,12 @@ Docker 容器和安全策略——无需 Kubernetes 的复杂性,
<br>
-[功能特性](#-功能特性) · [快速开始](#-快速开始) · [截图预览](#-截图预览) · [系统架构](#-系统架构) · [路线图](#-路线图) · [文档](#-文档) · [参与贡献](#-参与贡献) · [社区](#-社区)
+[快速开始](#-快速开始) · [截图预览](#-截图预览) · [功能特性](#-功能特性) · [系统架构](#-系统架构) · [路线图](#-路线图) · [文档](#-文档) · [参与贡献](#-参与贡献) · [Discord](#-社区)
</div>
---
-<p align="center">
- <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
-</p>
-
----
-
-## 🎯 功能特性
-
-### 应用与容器
-
-🐘 **PHP / WordPress** — PHP-FPM 8.x,支持一键安装 WordPress
-
-🐍 **Python 应用** — 使用 Gunicorn 部署 Flask 和 Django
-
-🟢 **Node.js** — PM2 进程管理,支持日志实时推送
-
-📦 **Manual & Zip Deploys** — 除 Git 和 Docker 源外,还支持从本地/手动路径或上传的 zip 包部署
-
-🐳 **Docker** — 全面的容器和 Docker Compose 管理
-
-♻️ **Container Lifecycle** — 镜像更新检测与一键应用、空闲容器自动休眠,以及基于 CPU 的水平自动扩缩容
-
-🔑 **环境变量** — 安全加密的应用级变量管理
-
-### 基础设施
-
-🌐 **域名管理** — Nginx 虚拟主机,配置简便
-
-🔒 **SSL / TLS** — Let's Encrypt 自动签发与自动续期、可选的(尽力而为)HTTPS(绝不阻断安装)、强化的 TLS 1.2+/AEAD 加密套件、Cloudflare 感知配置,以及自动 CAA 记录
-
-🗄️ **数据库** — 支持 MySQL/MariaDB 和 PostgreSQL
-
-🛡️ **防火墙 (UFW)** — 可视化防火墙规则管理
-
-⏰ **定时任务** — 可视化编辑器调度 Cron 任务
-
-📁 **文件管理器** — 通过 Web 界面浏览和编辑文件,包括浏览和预览 S3 / Backblaze B2 存储桶
-
-📡 **FTP 服务器** — 管理 vsftpd 用户和访问权限
-
-### 安全
-
-🔐 **双因素认证** — 基于 TOTP 的验证,支持备用恢复码
-
-🔑 **Passkeys / WebAuthn** — 无密码登录与二次验证,支持硬件密钥、Touch ID 和 Windows Hello
-
-🛡️ **Web Application Firewall** — 应用级 ModSecurity v3 + OWASP Core Rule Set,支持检测/拦截模式、可调偏执级别,以及审计日志事件
-
-🦠 **恶意软件扫描** — 集成 ClamAV,支持隔离处理
-
-📋 **文件完整性监控** — 检测未授权的文件变更
-
-🚨 **安全告警** — 实时威胁通知
-
-🧱 **Fail2ban 和 SSH** — 暴力破解防护与 SSH 密钥管理
-
-### 监控与告警
-
-📊 **实时指标** — 通过 WebSocket 监控 CPU、内存、磁盘、网络
-
-🎮 **GPU Monitoring** — NVIDIA GPU 利用率、显存、温度和功耗,支持按进程和按容器统计用量
-
-📈 **运行时间追踪** — 服务器历史在线率数据
-
-🔔 **通知推送** — 支持 Discord、Slack、Telegram 及通用 Webhook
-
-🖥️ **多服务器管理** — 基于 Agent 的远程服务器监控与管理
-
----
-
## 🚀 快速开始
> ⏱️ 不到 2 分钟即可启动运行
@@ -113,7 +45,19 @@ Docker 容器和安全策略——无需 Kubernetes 的复杂性,
curl -fsSL https://serverkit.ai/install.sh | bash
```
-> 支持 Ubuntu 22.04+ 和 Debian 12+,自动完成所有配置。
+> 支持 Ubuntu 22.04+、Debian 12+、Fedora 以及 RHEL/Rocky/AlmaLinux 9+,自动完成所有配置。
+>
+> 可选项:`PANEL_DOMAIN=panel.example.com` 用于设置域名并尝试签发 Let's Encrypt 证书;`SERVERKIT_OFFLINE_TARBALL=...` 用于从本地 tarball 安装。
+
+### 更新
+
+```bash
+sudo serverkit update
+```
+
+原子化的蓝绿更新,包含预检、数据库备份、迁移以及自动回滚。
+使用 `--dry-run` 预览,`--branch dev` 安装开发版构建,
+或 `--release [version]` 安装发布版 tarball。
### 方式二:Docker
@@ -142,43 +86,147 @@ docker compose up -d # 访问 http://localhost
## 📸 截图预览
-<p align="center">
+> 截图取自使用模拟数据的演示构建——下方所有主机名、IP、域名和指标均为虚构。
+
+| 仪表盘 | 服务 |
+| :--------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Dashboard](screenshots/dashboard.png) | ![Services](screenshots/services.png) |
+| _实时服务器指标、KPI 卡片与近期活动_ | _静态站点、Node.js、Python、PHP 与 Docker 应用_ |
-![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+| Docker | WordPress |
+| :-------------------------------------------------------------: | :------------------------------------------------------------: |
+| ![Docker](screenshots/docker.png) | ![WordPress](screenshots/wordpress.png) |
+| _容器、镜像、卷与网络,并实时显示 CPU/内存_ | _各站点状态、快捷操作与实时健康检查_ |
-</p>
+| Agent 集群 | 应用市场 |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Agent Fleet](screenshots/fleet.png) | ![Marketplace](screenshots/marketplace.png) |
+| _集群健康状况、版本灰度发布与命令队列_ | _一键应用模板与可安装扩展_ |
+
+| 监控 | 安全 |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Monitoring](screenshots/monitoring.png) | ![Security](screenshots/security.png) |
+| _实时仪表盘、告警规则与通知渠道_ | _安全评分、ClamAV、文件完整性、防火墙、Fail2Ban_ |
<details>
-<summary><strong>查看更多截图</strong></summary>
+<summary><strong>查看全部截图</strong></summary>
<br>
-<p align="center">
- <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
-</p>
+| AI 助手 | 服务详情 |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![AI Assistant](screenshots/ai.png) | ![Service Detail](screenshots/service-detail.png) |
+| _由 Prompture 驱动、可在你的基础设施上调用工具的助手_ | _部署记录、Git 连接、实时用量、日志与设置_ |
+
+| 数据库 | SQL 控制台 |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Databases](screenshots/databases.png) | ![SQL Console](screenshots/sql.png) |
+| _带源码树的 MySQL / PostgreSQL / SQLite 浏览器_ | _在浏览器中执行 SQL,并以带类型的结果表格展示_ |
+
+| 域名 | DNS 区域 |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Domains](screenshots/domains.png) | ![DNS Zones](screenshots/dns.png) |
+| _SSL 状态、到期追踪与自动续期_ | _Cloudflare、Route 53、DigitalOcean——完整记录编辑_ |
+
+| 备份 | 邮件 |
+| :-------------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![Backups](screenshots/backups.png) | ![Mail](screenshots/email.png) |
+| _定时备份,支持 S3/B2 同步与一键恢复_ | _Postfix、Dovecot、OpenDKIM、SpamAssassin 与 Roundcube_ |
+
+| 定时任务 | 文件管理器 |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Cron Jobs](screenshots/cron.png) | ![File Manager](screenshots/files.png) |
+| _可视化 Cron 编辑器,时间表达式可读性强_ | _浏览、编辑与上传文件,并按挂载点显示磁盘用量_ |
+
+| 日志与终端 | 服务器 |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Logs & Terminal](screenshots/terminal.png) | ![Servers](screenshots/servers.png) |
+| _日志查看器、进程列表、journald 与 SSH 会话_ | _在同一面板中管理所有服务器,实时展示 CPU/内存/磁盘遥测_ |
+
+| 远程访问 | 设置 |
+| :--------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Remote Access](screenshots/remote-access.png) | ![Settings](screenshots/settings.png) |
+| _通过 WireGuard 配对的 Agent 将 NAT 后的服务对外暴露_ | _个人资料、外观/品牌、用户与连接_ |
+
+| 登录 | |
+| :-------------------------------------------------------------: | :-------------------------------------------------------------: |
+| ![Login](screenshots/login.png) | |
+| _邮箱/密码登录,支持 SSO 与双因素认证_ | |
-<p align="center">
- <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
-</p>
+</details>
-<p align="center">
- <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
-</p>
+## 🎯 功能特性
-<p align="center">
- <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
-</p>
+> **核心功能已臻完备。** 新能力以可安装的**扩展**形式通过内置应用市场发布——核心保持精简稳定,后续工作聚焦于 UI 打磨与社区反馈的问题修复。
-<p align="center">
- <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
-</p>
+### 🚀 应用与部署
-</details>
+| | |
+|---|---|
+| **一键 WordPress**<br>PHP-FPM 8.x 站点发布在真实子域名上,支持 URL 替换预览、自定义域名与通配符 HTTPS。 | **任意技术栈**<br>基于 Gunicorn 的 Flask/Django、基于 PM2 的 Node.js、静态站点——支持从 Git、Docker、手动路径或 zip 上传部署。 |
+| **Docker 与 Compose**<br>镜像更新检测与一键应用、空闲容器自动休眠、基于 CPU 的自动扩缩容、实时日志与终端访问。 | **应用市场**<br>100+ 一键应用模板,基于声明式 schema,自动解析密钥、主机与 URL——没有任何硬编码。 |
+| **Build Packs**<br>零 Dockerfile 部署:检查代码仓库并依据构建计划生成 Dockerfile + compose。 | **自动化**<br>基于节点的可视化自动化,用于任务、部署与 CI/CD——支持 cron、Webhook 与事件触发,运行在托管容器中。以扩展形式发布。 |
+| **预览与快照**<br>临时的 PR 预览环境,以及不可变、密钥已脱敏的配置快照,支持差异对比与一键恢复。 | **项目与环境**<br>工作区 → 项目 → 环境的分组结构,并提供 WordPress 生产/预发/开发流水线,支持代码与数据库晋级。 |
+
+### 🏗️ 基础设施
+
+| | |
+|---|---|
+| **域名与 SSL**<br>Nginx 虚拟主机、自动签发与续期的 Let's Encrypt 证书、强化的 TLS 1.2+/AEAD、Cloudflare 感知配置、自动 CAA。 | **DNS 区域**<br>在 Cloudflare、Route 53 与 DigitalOcean 上进行完整记录管理——支持传播检查与应对 IP 变动的动态 DNS。 |
+| **数据库**<br>MySQL/MariaDB 与 PostgreSQL,支持用户管理、实时源码树与浏览器端 SQL 控制台。 | **云端开通**<br>在 DigitalOcean、Hetzner、Vultr 与 Linode 上创建服务器,并跟踪成本。 |
+| **连接中心**<br>Git 提供商、云平台、DNS、域名注册商、SMTP 中继与 S3/B2 存储——所有外部账户集中管理,静态加密存储。 | **备份**<br>将应用/数据库/文件定时备份到 S3、B2 或本地,支持保留策略、一键恢复与可选的客户端加密。 |
+| **文件、FTP 与 Cron**<br>Web 文件管理器,支持浏览 S3/B2 存储桶、vsftpd 用户管理以及可视化 Cron 编辑器。 | **邮件服务器**<br>Postfix + Dovecot,支持 DKIM/SPF/DMARC、SpamAssassin、Roundcube 网页邮箱与转发规则。 |
+
+### 🔒 安全
+
+| | |
+|---|---|
+| **Web 应用防火墙**<br>应用级 ModSecurity v3 + OWASP Core Rule Set,支持检测/拦截模式与可调偏执级别。 | **Passkeys 与双因素认证**<br>WebAuthn 无密码登录(硬件密钥、Touch ID、Windows Hello),以及带备用码的 TOTP。 |
+| **恶意软件与完整性**<br>ClamAV 扫描与隔离、文件完整性监控,以及 Lynis 漏洞审计。 | **SSH 与系统加固**<br>Fail2ban、SSH 密钥管理、IP 允许/阻止列表,以及自动操作系统安全更新。 |
+| **容器扫描**<br>使用 grype 进行逐镜像 CVE 扫描,并用 syft 生成 SBOM。 | **加密密钥**<br>提供商凭据与密钥使用 Fernet 加密封存,另有面向外部自动化的入站 Webhook 网关。 |
+
+### 🖥️ 多服务器
+
+| | |
+|---|---|
+| **跨平台 Agent**<br>适用于 Linux、Windows 和 macOS 的 Go Agent——通过实时 WebSocket 网关进行 HMAC-SHA256 认证。原生 Windows 服务 + MSI、`.deb`/`.rpm`、ARM64。[了解更多 →](https://github.com/jhd3197/serverkit-agent) | **集群管理**<br>资产清单、审批队列、分阶段版本灰度、局域网自动发现,以及离线命令队列。 |
+| **轻松接入**<br>带指纹校验的短码配对或预共享令牌;主机凭据以 AES-GCM 加密存储。[了解更多 →](pairing.md) | **集群监控**<br>跨服务器热力图、指标对比、告警阈值、异常检测与容量预测。 |
+| **服务器模板**<br>预期状态模板,支持漂移检测、合规仪表盘与自动修复。 | **远程访问隧道**<br>通过边缘服务器上由 Agent 托管的 WireGuard 暴露私有/NAT 后的服务——无需端口转发。 |
+| **引导式接入**<br>校验 → 前置依赖 → Docker → 配对 Agent,并提供实时进度日志。 | **按服务器代理**<br>可选为每台服务器启用 Docker 化的 Traefik 或 Caddy,并提供 compose 预览;主机 nginx 仍为默认方案。 |
+
+### 📊 监控与告警
+
+| | |
+|---|---|
+| **实时指标**<br>通过 WebSocket 监控 CPU、内存、磁盘与网络,并提供历史留存与运行时间追踪。 | **GPU 监控**<br>NVIDIA 利用率、显存、温度,以及按进程/按容器的用量统计。 |
+| **状态页**<br>公开状态页,支持 HTTP/TCP/DNS/Ping 检查、组件监控与事故管理。 | **通知推送**<br>Discord、Slack、Telegram、HTML 邮件与 Webhook——支持按用户配置渠道、严重级别过滤与免打扰时段。 |
+
+### 👥 团队与权限
+
+| | |
+|---|---|
+| **工作区**<br>多租户隔离,支持配额与成员管理。 | **RBAC**<br>管理员/开发者/查看者角色,支持按功能细分的读/写权限。 |
+| **SSO 与 OAuth**<br>Google、GitHub、OpenID Connect 与 SAML 2.0,支持账户关联。 | **API 密钥**<br>分级密钥,支持速率限制、细粒度作用域、用量分析与 OpenAPI 文档。 |
+| **审计日志**<br>记录每一次用户操作,并提供详细的活动仪表盘。 | **Webhook 与共享配置**<br>出站订阅,支持 HMAC 签名与重试,另有共享标签与变量组。 |
+
+### 🎨 自定义
+
+| | |
+|---|---|
+| **默认精简**<br>安装向导只安装与你的使用场景相匹配的扩展——随时可从应用市场添加更多。 | **侧边栏预设**<br>完整、Web 托管、邮件管理、DevOps 或极简视图,支持可折叠分组与按用户布局。 |
+| **你的品牌**<br>8 种预设主题色外加自定义 hex 取色器,以及白标 logo、名称或横幅。 | **仪表盘小组件**<br>可开关与重排小组件,以贴合你的工作流。 |
---
## 🏗️ 系统架构
+<img width="100%" alt="ServerKit 架构:客户端与公网访客先抵达 nginx 边缘层,由其将面板流量分发到 Flask API,将公开流量代理到应用容器;ServerKit 面板包含 React SPA、REST API、Socket.IO Agent 网关、服务层、模型层、任务、通知与扩展运行时;同一台服务器上的运行时层承载 Docker 应用容器、数据库与面板状态;远程 Go Agent 集群通过 /agent 命名空间回连。" src="images/architecture/system-overview.png" />
+
+**Nginx** 终止 TLS 并将流量一分为二:面板请求转发到 **Flask API**,其余请求代理到为该域名提供服务的 **Docker 容器**。面板将自身状态保存在 SQLite 或 PostgreSQL 中,通过任务调度器与通知总线运行后台工作,并从**扩展运行时**加载可选功能。远程服务器由 **Go Agent** 管理,它通过 Socket.IO 命名空间回连。
+
+<details>
+<summary><strong>查看 ASCII 图</strong></summary>
+
```
┌──────────────────┐
│ INTERNET │
@@ -192,61 +240,58 @@ docker compose up -d # 访问 http://localhost
│ │ NGINX (Reverse Proxy) │ │
│ │ :80 / :443 │ │
│ │ │ │
-│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ │ │
-│ └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
-│ │ proxy_pass │ proxy_pass │ proxy_pass │
-│ ▼ ▼ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DOCKER CONTAINERS │ │
-│ │ │ │
-│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
-│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │
-│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │
-│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │
-│ └──────────┼──────────────────────────────────────────────────────────┘ │
-│ │ │
-│ ▼ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ DATABASES │ │
-│ │ MySQL :3306 PostgreSQL :5432 Redis :6379 │ │
-│ └─────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────┘
+│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ /api/v1/ ──┐ │ │
+│ └───────────────┼──────────────┼──────────────────┼──────────────┼────┘ │
+│ │ proxy_pass │ proxy_pass │ proxy_pass │ │
+│ ▼ ▼ ▼ │ │
+│ ┌────────────────────────────────────────────────────────────┐ │ │
+│ │ DOCKER CONTAINERS │ │ │
+│ │ │ │ │
+│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │ │
+│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │ │
+│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │ │
+│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │ │
+│ └──────────┼─────────────────────────────────────────────────┘ │ │
+│ │ ▼ │
+│ │ ┌─────────────────────────────────┐ │
+│ │ │ SERVERKIT PANEL │ │
+│ │ │ React SPA · Flask REST API │ │
+│ │ │ Socket.IO · Jobs · Notify │ │
+│ │ │ Extension runtime │ │
+│ │ │ Gunicorn -w 1 (threaded) │ │
+│ │ └────────────────┬────────────────┘ │
+│ ▼ │ │
+│ ┌──────────────────────────────────┐ ┌─────────────▼────────────────┐ │
+│ │ DATABASES │ │ PANEL STATE │ │
+│ │ MySQL :3306 PostgreSQL :5432 │ │ SQLite (default) or │ │
+│ │ Redis :6379 MongoDB :27017 │ │ PostgreSQL · Alembic │ │
+│ └──────────────────────────────────┘ └──────────────────────────────┘ │
+└───────────────────────────────────────────────────────┼──────────────────┘
+ │
+ Socket.IO /agent (HMAC) │
+ + HTTP long-poll fallback ▼
+ ┌──────────────────────────────────────┐
+ │ REMOTE SERVERS — Go agent fleet │
+ │ server A · server B · server C │
+ └──────────────────────────────────────┘
```
-**[查看完整架构文档 →](ARCHITECTURE.md)** — 请求流程、模板系统、端口分配、数据库关联及故障排查。
+</details>
+
+**[查看完整架构文档 →](ARCHITECTURE.md)** — 请求流程、扩展平台、模板系统、端口分配、任务、通知与 Agent 集群。
---
## 🗺️ 路线图
-- [x] 核心基础设施 — Flask + React + JWT + WebSocket
-- [x] 应用管理 — PHP、Python、Node.js、Docker
-- [x] 域名与 SSL — Nginx 虚拟主机、Let's Encrypt
-- [x] 数据库 — MySQL、PostgreSQL
-- [x] 文件与 FTP 管理
-- [x] 监控与告警 — 指标、Webhook、运行时间追踪
-- [x] 安全 — 双因素认证、ClamAV、文件完整性、Fail2ban
-- [x] 防火墙 — UFW 集成
-- [x] 多服务器管理 — Go Agent、集中式仪表盘
-- [x] Git 部署 — Webhook、自动部署、回滚、零停机
-- [ ] 备份与恢复 — S3、Backblaze B2、定时备份
-- [ ] 邮件服务器 — Postfix、Dovecot、DKIM/SPF/DMARC
-- [ ] 团队与权限 — RBAC、审计日志
-- [ ] 移动应用 — React Native,支持推送通知
-- [ ] 插件市场 — 扩展、自定义组件、主题
-- [x] Web 应用防火墙 — 应用级 ModSecurity v3 + OWASP CRS
-- [x] 容器安全 — 镜像 CVE 扫描(grype)+ SBOM(syft)
-- [x] 无密码认证 — WebAuthn / passkeys
-- [x] 动态 DNS — 基于令牌认证的 A/AAAA 更新
-- [x] GPU 监控 — NVIDIA 利用率、显存与进程
-- [x] 容器生命周期 — 镜像更新应用、自动休眠、水平自动扩缩容
-- [x] TLS 强化 — 可选 HTTPS、Cloudflare 感知配置、自动 CAA
-- [x] 密钥管理器与入站 Webhook 网关
-- [x] 远程访问 — 通过 Agent 托管的 WireGuard 隧道暴露私有/NAT 后的服务
-- [x] 连接中心 — 统一管理外部账户(源码、云、DNS、注册商、SMTP、存储)
-- [x] WordPress 发布 — 真实子域名、URL 替换、自定义域名、通配符 HTTPS
-
-完整详情:[ROADMAP.md](../ROADMAP.md)
+**ServerKit 的核心功能已臻完备**——从最初的 Flask + React 基础设施,到多服务器集群、SSO、自动化引擎与扩展应用市场,所有规划中的核心阶段均已交付。
+
+后续开发集中在两个方向:
+
+- **🧩 扩展** — 新功能以可安装扩展的形式通过应用市场发布(100+ 一键模板并持续增加)。核心保持精简;你只安装自己需要的部分。
+- **✨ 核心打磨** — 持续的 UI/UX 优化,以及针对社区反馈问题的修复。不再规划新的核心功能。
+
+完整历史:[ROADMAP.md](../ROADMAP.md)
---
@@ -257,8 +302,12 @@ docker compose up -d # 访问 http://localhost
| [系统架构](ARCHITECTURE.md) | 系统设计、请求流程、架构图 |
| [安装指南](INSTALLATION.md) | 完整的安装配置说明 |
| [部署指南](DEPLOYMENT.md) | CLI 命令与生产环境部署 |
+| [Agent](https://github.com/jhd3197/serverkit-agent) | 安装并运行多服务器 Agent(Linux/Windows/macOS)——独立仓库 |
+| [Agent 配对](pairing.md) | 安全的短码 Agent 接入 |
| [API 参考](API.md) | REST API 接口文档 |
| [新功能](NEW_FEATURES.md) | 最新 `dev` 功能的接口与页面参考 |
+| [增强能力](ENHANCEMENTS.md) | 十项开发者体验、团队/规模化、集群与安全能力的说明指南 |
+| [更新日志](../CHANGELOG.md) | 发布历史与重要变更 |
| [路线图](../ROADMAP.md) | 开发路线图与规划功能 |
| [参与贡献](../CONTRIBUTING.md) | 如何参与贡献 |
@@ -268,12 +317,15 @@ docker compose up -d # 访问 http://localhost
| 层级 | 技术 |
|-------|------------|
-| 后端 | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
-| 前端 | React 18, Vite, SCSS |
+| 后端 | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO, Flask-Migrate |
+| 前端 | React 18, Vite, SCSS, Recharts |
| 数据库 | SQLite / PostgreSQL |
-| Web 服务器 | Nginx, Gunicorn |
+| Web 服务器 | Nginx, Gunicorn(单进程多线程 worker —— `-w 1 --threads N`) |
| 容器 | Docker, Docker Compose |
-| 安全 | ClamAV, TOTP (pyotp), Cryptography, ModSecurity v3 + OWASP CRS, grype, syft |
+| 安全 | ClamAV, Lynis, Fail2ban, ModSecurity v3 + OWASP CRS, grype, syft, TOTP (pyotp), Fernet 加密 |
+| 认证 | JWT, OAuth 2.0, OIDC, SAML 2.0, WebAuthn / passkeys |
+| 邮件 | Postfix, Dovecot, SpamAssassin, Roundcube |
+| Agent | Go(多服务器), HMAC-SHA256, WebSocket |
---
@@ -282,10 +334,20 @@ docker compose up -d # 访问 http://localhost
欢迎贡献代码!请先阅读 [CONTRIBUTING.md](../CONTRIBUTING.md)。
```
-Fork → 创建功能分支 → 提交代码 → 推送 → 发起 Pull Request
+fork → feature branch → commit → push → pull request
```
-**优先领域:** 备份功能实现、更多通知渠道、UI/UX 改进、文档完善。
+**优先领域:** 应用市场扩展、UI/UX 改进、文档完善、测试覆盖率。
+
+---
+
+## 💛 支持 ServerKit
+
+ServerKit 是免费且开源的。如果它为你节省了时间,你可以这样帮助它持续发展:
+
+- ⭐ [给仓库点个 Star](https://github.com/jhd3197/ServerKit) — 分文不花,却帮助很大
+- 💖 [GitHub Sponsors](https://github.com/sponsors/jhd3197)
+- ☕ [Buy Me a Coffee](https://buymeacoffee.com/jhd3197)
---
@@ -295,6 +357,10 @@ Fork → 创建功能分支 → 提交代码 → 推送 → 发起 Pull Request
> ServerKit 在浏览器中管理你的服务器;Faro 则是桌面端的得力搭档,用于动手进行文件传输、终端操作以及跨服务器的临时任务。[获取构建版本 →](https://github.com/jhd3197/faro/releases/latest)
+**[LocalKit](https://github.com/jhd3197/LocalKit)** — 一键创建本地 WordPress 站点。每个站点都作为独立隔离的 Docker Compose 项目运行,你还可以通过 `serverkit-localkit` 扩展,直接把代码推送、或把数据库推送/拉取到你的 ServerKit 服务器。
+
+**[DeviceKit](https://github.com/jhd3197/DeviceKit)** — 统一的 Android 设备集群与测试自动化平台。在一个仪表盘中控制整个设备集群——运行自动化任务、实时串流屏幕、捕捉视觉回归,并借助 AI 驱动的分析排查故障。
+
---
## 💬 社区