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.

Revamp README and add translations

Juan Denisd2b9877d7412
diff --git a/README.md b/README.md
index 0c509984..b17220de 100644
--- a/README.md
+++ b/README.md
@@ -1,175 +1,101 @@
<div align="center">
+English | [Español](docs/README.es.md) | [中文版](docs/README.zh-CN.md) | [Português](docs/README.pt.md)
+
# ServerKit
<img width="700" alt="server-kit" src="https://github.com/user-attachments/assets/bfc59e75-8f90-4674-a222-e18213b628b7" />
-**Self-hosted infrastructure, made simple**
+**Self-hosted infrastructure, made simple.**
+
+A lightweight, modern server control panel for managing web apps, databases,
+Docker containers, and security — without the complexity of Kubernetes
+or the cost of managed platforms.
<br>
-[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.11+-3776AB.svg?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
-[![React](https://img.shields.io/badge/react-18-61DAFB.svg?style=for-the-badge&logo=react&logoColor=black)](https://reactjs.org)
-[![Docker](https://img.shields.io/badge/docker-ready-2496ED.svg?style=for-the-badge&logo=docker&logoColor=white)](https://docker.com)
+![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
+![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/pe4E5zmj)
+[![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)
[![Flask](https://img.shields.io/badge/flask-3.0-000000.svg?style=flat-square&logo=flask&logoColor=white)](https://flask.palletsprojects.com)
[![Nginx](https://img.shields.io/badge/nginx-reverse_proxy-009639.svg?style=flat-square&logo=nginx&logoColor=white)](https://nginx.org)
[![Let's Encrypt](https://img.shields.io/badge/SSL-Let's_Encrypt-003A70.svg?style=flat-square&logo=letsencrypt&logoColor=white)](https://letsencrypt.org)
-[![MySQL](https://img.shields.io/badge/mysql-8.0-4479A1.svg?style=flat-square&logo=mysql&logoColor=white)](https://mysql.com)
-[![PostgreSQL](https://img.shields.io/badge/postgresql-15-4169E1.svg?style=flat-square&logo=postgresql&logoColor=white)](https://postgresql.org)
-[![Ubuntu](https://img.shields.io/badge/ubuntu-22.04+-E95420.svg?style=flat-square&logo=ubuntu&logoColor=white)](https://ubuntu.com)
<br>
-[Features](#features) · [Quick Start](#quick-start) · [Documentation](#documentation) · [Architecture](docs/ARCHITECTURE.md) · [Contributing](#contributing)
+[Features](#-features) · [Quick Start](#-quick-start) · [Screenshots](#-screenshots) · [Architecture](#-architecture) · [Roadmap](#-roadmap) · [Docs](#-documentation) · [Contributing](#-contributing) · [Discord](#-community)
</div>
---
-## What is ServerKit?
-
-ServerKit is a lightweight, modern server control panel for managing web applications, databases, Docker containers, and security on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
-
-**Perfect for:** Developers, freelancers, and small teams who want full control over their infrastructure without the complexity of Kubernetes or the cost of managed platforms.
+<p align="center">
+ <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
+</p>
---
-## Architecture
+## 🎯 Features
-<details>
-<summary><strong>View How It Works</strong></summary>
+### Apps & Containers
-<br>
+🐘 **PHP / WordPress** — PHP-FPM 8.x with one-click WordPress installation
-```
- ┌──────────────────┐
- │ INTERNET │
- └────────┬─────────┘
- │
- ▼
-┌──────────────────────────────────────────────────────────────────────────┐
-│ YOUR SERVER │
-│ │
-│ ┌─────────────────────────────────────────────────────────────────────┐ │
-│ │ 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 │ │
-│ └─────────────────────────────────────────────────────────────────────┘ │
-└──────────────────────────────────────────────────────────────────────────┘
-```
+🐍 **Python Apps** — Deploy Flask and Django with Gunicorn
-</details>
+🟢 **Node.js** — PM2-managed applications with log streaming
-**[View Full Architecture Documentation →](docs/ARCHITECTURE.md)**
+🐳 **Docker** — Full container and Docker Compose management
-> Includes: Request flow diagrams, template system, port allocation, database linking, and troubleshooting guides.
+🔑 **Environment Variables** — Secure, encrypted per-app variable management
----
+### Infrastructure
-## Features
+🌐 **Domain Management** — Nginx virtual hosts with easy configuration
-### Application Management
-- **PHP / WordPress** - PHP-FPM 8.x with one-click WordPress installation
-- **Python Apps** - Deploy Flask and Django with Gunicorn
-- **Node.js** - PM2-managed Node applications
-- **Docker** - Full container and Docker Compose management
-- **Environment Variables** - Secure, encrypted variable management per app
+🔒 **SSL Certificates** — Automatic Let's Encrypt with auto-renewal
-### Infrastructure
-- **Domain Management** - Nginx virtual hosts with easy configuration
-- **SSL Certificates** - Automatic Let's Encrypt with auto-renewal
-- **Database Management** - MySQL/MariaDB and PostgreSQL support
-- **Firewall (UFW)** - Visual firewall rule management
-- **Cron Jobs** - Schedule tasks with a visual editor
-- **File Manager** - Browse and edit files via web interface
-- **FTP Server** - Manage vsftpd users and access
+🗄️ **Databases** — MySQL/MariaDB and PostgreSQL support
-### Security
-- **Two-Factor Authentication (2FA)** - TOTP-based with backup codes
-- **ClamAV Integration** - Malware scanning with quarantine
-- **File Integrity Monitoring** - Detect unauthorized file changes
-- **Failed Login Detection** - Monitor suspicious login attempts
-- **Security Alerts** - Real-time notifications for threats
+🛡️ **Firewall (UFW)** — Visual firewall rule management
-### Monitoring & Alerts
-- **Real-time Metrics** - CPU, RAM, disk, network monitoring
-- **Server Uptime Tracking** - Historical uptime data
-- **Alert Thresholds** - Customizable warning/critical levels
-- **Notification Webhooks:**
- - Discord
- - Slack
- - Telegram
- - Generic webhooks
-
-### Modern UI
-- Dark-themed responsive dashboard
-- Real-time WebSocket updates
-- Mobile-friendly interface
+⏰ **Cron Jobs** — Schedule tasks with a visual editor
----
+📁 **File Manager** — Browse and edit files via web interface
-## Screenshots
+📡 **FTP Server** — Manage vsftpd users and access
-<p align="center">
- <img alt="Dashboard" width="100%" src="https://github.com/user-attachments/assets/e4382ba7-7b3f-4175-baaf-cc9c782de067" />
-</p>
+### Security
-<p align="center">
-
-![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
-
-</p>
+🔐 **Two-Factor Auth** — TOTP-based with backup codes
-<details>
-<summary><strong>View More Screenshots</strong></summary>
+🦠 **Malware Scanning** — ClamAV integration with quarantine
-<br>
+📋 **File Integrity Monitoring** — Detect unauthorized file changes
-<p align="center">
- <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
-</p>
+🚨 **Security Alerts** — Real-time threat notifications
-<p align="center">
- <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
-</p>
+🧱 **Fail2ban & SSH** — Brute force protection and SSH key management
+### Monitoring & Alerts
-<p align="center">
- <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
-</p>
+📊 **Real-time Metrics** — CPU, RAM, disk, network monitoring via WebSocket
-<p align="center">
- <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
-</p>
+📈 **Uptime Tracking** — Historical server uptime data
-<p align="center">
- <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
-</p>
+🔔 **Notifications** — Discord, Slack, Telegram, and generic webhooks
-</details>
+🖥️ **Multi-Server** — Agent-based remote server monitoring and management
---
-## Quick Start
+## 🚀 Quick Start
+
+> ⏱️ Up and running in under 2 minutes
### Option 1: One-Line Install (Recommended)
@@ -182,237 +108,179 @@ curl -fsSL https://serverkit.ai/install.sh | bash
### Option 2: Docker
```bash
-# Clone the repository
git clone https://github.com/jhd3197/ServerKit.git
cd ServerKit
-
-# Configure environment
-cp .env.example .env
-nano .env # Set SECRET_KEY and JWT_SECRET_KEY
-
-# Start ServerKit
-docker compose up -d
-
-# Access at http://localhost
+cp .env.example .env # then edit .env with your secrets
+docker compose up -d # access at http://localhost
```
### Option 3: Manual Installation
-See [Installation Guide](docs/INSTALLATION.md) for detailed instructions.
-
----
-
-## Requirements
-
-| Requirement | Minimum | Recommended |
-|-------------|---------|-------------|
-| OS | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
-| CPU | 1 vCPU | 2+ vCPU |
-| RAM | 1 GB | 2+ GB |
-| Disk | 10 GB | 20+ GB |
-| Docker | 24.0+ | Latest |
+See the [Installation Guide](docs/INSTALLATION.md) for step-by-step instructions.
----
-
-## Tech Stack
+### Requirements
-| Layer | Technology |
-|-------|------------|
-| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
-| Frontend | React 18, Vite, LESS |
-| Database | SQLite / PostgreSQL |
-| Web Server | Nginx, Gunicorn |
-| Containers | Docker, Docker Compose |
-| Security | ClamAV, TOTP (pyotp), Cryptography |
+| | Minimum | Recommended |
+|---|---------|-------------|
+| **OS** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
+| **CPU** | 1 vCPU | 2+ vCPU |
+| **RAM** | 1 GB | 2+ GB |
+| **Disk** | 10 GB | 20+ GB |
+| **Docker** | 24.0+ | Latest |
---
-## Documentation
-
-| Document | Description |
-|----------|-------------|
-| [Architecture](docs/ARCHITECTURE.md) | System design, request flow, and diagrams |
-| [Installation Guide](docs/INSTALLATION.md) | Complete setup instructions |
-| [Deployment Guide](docs/DEPLOYMENT.md) | CLI commands and production deployment |
-| [API Reference](docs/API.md) | REST API documentation |
-| [Roadmap](ROADMAP.md) | Development roadmap and planned features |
-| [Contributing](CONTRIBUTING.md) | How to contribute |
+## 📸 Screenshots
----
+<p align="center">
-## Project Structure
+![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
-```
-ServerKit/
-├── backend/ # Flask API
-│ ├── app/
-│ │ ├── api/ # API endpoints
-│ │ ├── models/ # Database models
-│ │ └── services/ # Business logic
-│ ├── config.py
-│ └── requirements.txt
-│
-├── frontend/ # React application
-│ ├── src/
-│ │ ├── components/ # Reusable components
-│ │ ├── pages/ # Page components
-│ │ ├── services/ # API client
-│ │ └── styles/ # LESS stylesheets
-│ └── package.json
-│
-├── docs/ # Documentation
-├── docker-compose.yml # Docker configuration
-└── README.md
-```
+</p>
----
+<details>
+<summary><strong>View More Screenshots</strong></summary>
-## CLI Commands
+<br>
-ServerKit includes a management CLI:
+<p align="center">
+ <img alt="Docker" width="100%" src="https://github.com/user-attachments/assets/08fd47b9-778a-4170-8542-ed28579f8a12" />
+</p>
-```bash
-# Service Management
-serverkit start|stop|restart|status
+<p align="center">
+ <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
+</p>
-# User Management
-serverkit create-admin
-serverkit reset-password
+<p align="center">
+ <img width="100%" alt="Templates" src="https://github.com/user-attachments/assets/337bcf4a-d5aa-4496-b74a-b66e859304ad" />
+</p>
-# Database
-serverkit backup-db
-serverkit restore-db <backup-file>
+<p align="center">
+ <img width="100%" alt="Applications" src="https://github.com/user-attachments/assets/b5bdf80c-4ce1-4de9-b8b9-ae069a17a2b3" />
+</p>
-# Updates & Branches
-serverkit update # Update to latest version
-serverkit update --branch <name> # Switch to specific branch (e.g., dev)
-serverkit branch # Show current branch and commit
+<p align="center">
+ <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
+</p>
-# Utilities
-serverkit generate-keys
-serverkit logs [service]
-```
+</details>
---
-## Configuration
-
-Create a `.env` file from the example:
+## 🏗️ Architecture
-```bash
-cp .env.example .env
```
-
-Key configuration options:
-
-```env
-# Required - Generate unique values!
-SECRET_KEY=your-secret-key
-JWT_SECRET_KEY=your-jwt-secret
-
-# Database (SQLite default, PostgreSQL for production)
-DATABASE_URL=sqlite:///serverkit.db
-
-# Your domain
-CORS_ORIGINS=https://panel.yourdomain.com
+ ┌──────────────────┐
+ │ INTERNET │
+ └────────┬─────────┘
+ │
+ ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│ YOUR SERVER │
+│ │
+│ ┌─────────────────────────────────────────────────────────────────────┐ │
+│ │ 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 │ │
+│ └─────────────────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────────────┘
```
-Generate secure keys:
-```bash
-python -c "import secrets; print(secrets.token_hex(32))"
-```
+**[View Full Architecture Documentation →](docs/ARCHITECTURE.md)** — Request flow, template system, port allocation, database linking, and troubleshooting.
---
-## Notification Setup
+## 🗺️ 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
+- [x] Firewall — UFW integration
+- [x] Multi-server management — Go agent, centralized dashboard
+- [x] Git deployment — Webhooks, auto-deploy, rollback, zero-downtime
+- [ ] Backup & restore — S3, Backblaze B2, scheduled backups
+- [ ] Email server — Postfix, Dovecot, DKIM/SPF/DMARC
+- [ ] Team & permissions — RBAC, audit logging
+- [ ] Mobile app — React Native with push notifications
+- [ ] Plugin marketplace — Extensions, custom widgets, themes
+
+Full details: [ROADMAP.md](ROADMAP.md)
-ServerKit can send alerts to multiple channels:
-
-### Discord
-1. Create webhook: Server Settings → Integrations → Webhooks
-2. Copy URL to Settings → Notifications → Discord
+---
-### Slack
-1. Create app: api.slack.com → Incoming Webhooks
-2. Copy URL to Settings → Notifications → Slack
+## 📖 Documentation
-### Telegram
-1. Create bot via @BotFather
-2. Get chat ID from @userinfobot
-3. Configure in Settings → Notifications → Telegram
+| Document | Description |
+|----------|-------------|
+| [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 |
+| [API Reference](docs/API.md) | REST API endpoints |
+| [Roadmap](ROADMAP.md) | Development roadmap and planned features |
+| [Contributing](CONTRIBUTING.md) | How to contribute |
---
-## Security Features
-
-### Two-Factor Authentication
-- TOTP-based (Google Authenticator, Authy, etc.)
-- Backup codes for recovery
-- Enable in Settings → Security
+## 🧱 Tech Stack
-### Malware Scanning
-- ClamAV integration
-- Quick scan / Full scan options
-- Automatic quarantine
-- Configure in Security → Settings
-
-### File Integrity Monitoring
-- Baseline creation
-- Change detection
-- Alert on modifications
+| Layer | Technology |
+|-------|------------|
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
+| Frontend | React 18, Vite, LESS |
+| Database | SQLite / PostgreSQL |
+| Web Server | Nginx, Gunicorn |
+| Containers | Docker, Docker Compose |
+| Security | ClamAV, TOTP (pyotp), Cryptography |
---
-## API Overview
+## 🤝 Contributing
-Base URL: `http://localhost:5000/api/v1`
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
```
-Authentication:
- POST /auth/login # Login
- POST /auth/register # Register
- POST /auth/2fa/verify # 2FA verification
-
-Applications:
- GET /apps # List apps
- POST /apps # Create app
- GET /apps/:id # Get app
- DELETE /apps/:id # Delete app
-
-Security:
- GET /security/status # Security summary
- POST /security/scan/quick # Quick malware scan
- GET /security/events # Security events
-
-Notifications:
- GET /notifications/config # Get config
- PUT /notifications/config/:channel # Update channel
- POST /notifications/test/:channel # Test channel
+fork → feature branch → commit → push → pull request
```
-Full API documentation: [docs/API.md](docs/API.md)
+**Priority areas:** Backup implementations, additional notification channels, UI/UX improvements, documentation.
---
-## Contributing
-
-Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
+## 💬 Community
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+[![Discord](https://img.shields.io/badge/Discord-Join_Us-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/pe4E5zmj)
+Join the Discord to ask questions, share feedback, or get help with your setup.
---
-<p align="center">
- <strong>ServerKit</strong> — Simple. Modern. Self-hosted.<br>
- <a href="https://github.com/jhd3197/ServerKit/issues">Report Bug</a> ·
- <a href="https://github.com/jhd3197/ServerKit/issues">Request Feature</a>
-</p>
+<div align="center">
-<p align="center">
- Made with ❤️ by <a href="https://juandenis.com">Juan Denis</a>
-</p>
+**ServerKit** — Simple. Modern. Self-hosted.
+
+[Report Bug](https://github.com/jhd3197/ServerKit/issues) · [Request Feature](https://github.com/jhd3197/ServerKit/issues)
+
+Made with ❤️ by [Juan Denis](https://juandenis.com)
+
+</div>
diff --git a/docs/README.es.md b/docs/README.es.md
new file mode 100644
index 00000000..f8212c10
--- /dev/null
+++ b/docs/README.es.md
@@ -0,0 +1,286 @@
+<div align="center">
+
+[English](../README.md) | Español | [中文版](README.zh-CN.md) | [Português](README.pt.md)
+
+# ServerKit
+
+<img width="700" alt="server-kit" src="https://github.com/user-attachments/assets/bfc59e75-8f90-4674-a222-e18213b628b7" />
+
+**Infraestructura autoalojada, simplificada.**
+
+Un panel de control de servidores ligero y moderno para gestionar aplicaciones web, bases de datos,
+contenedores Docker y seguridad — sin la complejidad de Kubernetes
+ni el coste de las plataformas gestionadas.
+
+<br>
+
+![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
+![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/pe4E5zmj)
+
+[![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)
+[![Flask](https://img.shields.io/badge/flask-3.0-000000.svg?style=flat-square&logo=flask&logoColor=white)](https://flask.palletsprojects.com)
+[![Nginx](https://img.shields.io/badge/nginx-reverse_proxy-009639.svg?style=flat-square&logo=nginx&logoColor=white)](https://nginx.org)
+[![Let's Encrypt](https://img.shields.io/badge/SSL-Let's_Encrypt-003A70.svg?style=flat-square&logo=letsencrypt&logoColor=white)](https://letsencrypt.org)
+
+<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)
+
+</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
+
+🐳 **Docker** — Gestión completa de contenedores y Docker Compose
+
+🔑 **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
+
+🔒 **Certificados SSL** — Let's Encrypt automático con renovación automática
+
+🗄️ **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
+
+📡 **Servidor FTP** — Gestión de usuarios y accesos de vsftpd
+
+### Seguridad
+
+🔐 **Autenticación de Dos Factores** — Basada en TOTP con códigos de respaldo
+
+🦠 **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
+
+📈 **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
+
+### Opción 1: Instalación en Una Línea (Recomendada)
+
+```bash
+curl -fsSL https://serverkit.ai/install.sh | bash
+```
+
+> Funciona en Ubuntu 22.04+ y Debian 12+. Configura todo automáticamente.
+
+### Opción 2: Docker
+
+```bash
+git clone https://github.com/jhd3197/ServerKit.git
+cd ServerKit
+cp .env.example .env # luego edita .env con tus claves
+docker compose up -d # accede en http://localhost
+```
+
+### Opción 3: Instalación Manual
+
+Consulta la [Guía de Instalación](INSTALLATION.md) para instrucciones paso a paso.
+
+### Requisitos
+
+| | Mínimo | Recomendado |
+|---|---------|-------------|
+| **SO** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
+| **CPU** | 1 vCPU | 2+ vCPU |
+| **RAM** | 1 GB | 2+ GB |
+| **Disco** | 10 GB | 20+ GB |
+| **Docker** | 24.0+ | Última versión |
+
+---
+
+## 📸 Capturas de Pantalla
+
+<p align="center">
+
+![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+
+</p>
+
+<details>
+<summary><strong>Ver Más 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>
+
+<p align="center">
+ <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
+</p>
+
+<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>
+
+<p align="center">
+ <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
+</p>
+
+</details>
+
+---
+
+## 🏗️ Arquitectura
+
+```
+ ┌──────────────────┐
+ │ INTERNET │
+ └────────┬─────────┘
+ │
+ ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│ YOUR SERVER │
+│ │
+│ ┌─────────────────────────────────────────────────────────────────────┐ │
+│ │ 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 │ │
+│ └─────────────────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+**[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.
+
+---
+
+## 🗺️ 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
+
+Detalles completos: [ROADMAP.md](../ROADMAP.md)
+
+---
+
+## 📖 Documentación
+
+| Documento | Descripción |
+|----------|-------------|
+| [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 |
+| [Referencia de la API](API.md) | Endpoints de la API REST |
+| [Hoja de Ruta](../ROADMAP.md) | Hoja de ruta de desarrollo y funcionalidades planificadas |
+| [Contribuir](../CONTRIBUTING.md) | Cómo contribuir |
+
+---
+
+## 🧱 Stack Tecnológico
+
+| Capa | Tecnología |
+|-------|------------|
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
+| Frontend | React 18, Vite, LESS |
+| Base de Datos | SQLite / PostgreSQL |
+| Servidor Web | Nginx, Gunicorn |
+| Contenedores | Docker, Docker Compose |
+| Seguridad | ClamAV, TOTP (pyotp), Cryptography |
+
+---
+
+## 🤝 Contribuir
+
+¡Las contribuciones son bienvenidas! Por favor, lee primero [CONTRIBUTING.md](../CONTRIBUTING.md).
+
+```
+fork → rama de funcionalidad → commit → push → pull request
+```
+
+**Áreas prioritarias:** Implementación de copias de seguridad, canales de notificación adicionales, mejoras de UI/UX, documentación.
+
+---
+
+## 💬 Comunidad
+
+[![Discord](https://img.shields.io/badge/Discord-Únete-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/pe4E5zmj)
+
+Únete al Discord para hacer preguntas, compartir comentarios u obtener ayuda con tu configuración.
+
+---
+
+<div align="center">
+
+**ServerKit** — Simple. Moderno. Autoalojado.
+
+[Reportar un Error](https://github.com/jhd3197/ServerKit/issues) · [Solicitar una Funcionalidad](https://github.com/jhd3197/ServerKit/issues)
+
+Hecho con ❤️ por [Juan Denis](https://juandenis.com)
+
+</div>
diff --git a/docs/README.pt.md b/docs/README.pt.md
new file mode 100644
index 00000000..3a9bc43a
--- /dev/null
+++ b/docs/README.pt.md
@@ -0,0 +1,286 @@
+<div align="center">
+
+[English](../README.md) | [Español](README.es.md) | [中文版](README.zh-CN.md) | Português
+
+# ServerKit
+
+<img width="700" alt="server-kit" src="https://github.com/user-attachments/assets/bfc59e75-8f90-4674-a222-e18213b628b7" />
+
+**Infraestrutura auto-hospedada, de forma simples.**
+
+Um painel de controle de servidores leve e moderno para gerenciar aplicações web, bancos de dados,
+containers Docker e segurança — sem a complexidade do Kubernetes
+ou o custo de plataformas gerenciadas.
+
+<br>
+
+![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
+![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/pe4E5zmj)
+
+[![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)
+[![Flask](https://img.shields.io/badge/flask-3.0-000000.svg?style=flat-square&logo=flask&logoColor=white)](https://flask.palletsprojects.com)
+[![Nginx](https://img.shields.io/badge/nginx-reverse_proxy-009639.svg?style=flat-square&logo=nginx&logoColor=white)](https://nginx.org)
+[![Let's Encrypt](https://img.shields.io/badge/SSL-Let's_Encrypt-003A70.svg?style=flat-square&logo=letsencrypt&logoColor=white)](https://letsencrypt.org)
+
+<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)
+
+</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
+
+🐳 **Docker** — Gerenciamento completo de containers e Docker Compose
+
+🔑 **Variáveis de Ambiente** — Gerenciamento seguro e criptografado por aplicação
+
+### Infraestrutura
+
+🌐 **Gerenciamento de Domínios** — Virtual hosts Nginx com configuração simplificada
+
+🔒 **Certificados SSL** — Let's Encrypt automático com renovação automática
+
+🗄️ **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
+
+📡 **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
+
+🦠 **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
+
+📈 **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
+
+### Opção 1: Instalação em Uma Linha (Recomendado)
+
+```bash
+curl -fsSL https://serverkit.ai/install.sh | bash
+```
+
+> Funciona no Ubuntu 22.04+ e Debian 12+. Configura tudo automaticamente.
+
+### Opção 2: Docker
+
+```bash
+git clone https://github.com/jhd3197/ServerKit.git
+cd ServerKit
+cp .env.example .env # depois edite o .env com suas chaves secretas
+docker compose up -d # acesse em http://localhost
+```
+
+### Opção 3: Instalação Manual
+
+Consulte o [Guia de Instalação](INSTALLATION.md) para instruções passo a passo.
+
+### Requisitos
+
+| | Mínimo | Recomendado |
+|---|---------|-------------|
+| **SO** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
+| **CPU** | 1 vCPU | 2+ vCPU |
+| **RAM** | 1 GB | 2+ GB |
+| **Disco** | 10 GB | 20+ GB |
+| **Docker** | 24.0+ | Mais recente |
+
+---
+
+## 📸 Capturas de Tela
+
+<p align="center">
+
+![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+
+</p>
+
+<details>
+<summary><strong>Ver Mais 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>
+
+<p align="center">
+ <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
+</p>
+
+<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>
+
+<p align="center">
+ <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
+</p>
+
+</details>
+
+---
+
+## 🏗️ Arquitetura
+
+```
+ ┌──────────────────┐
+ │ INTERNET │
+ └────────┬─────────┘
+ │
+ ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│ YOUR SERVER │
+│ │
+│ ┌─────────────────────────────────────────────────────────────────────┐ │
+│ │ 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 │ │
+│ └─────────────────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+**[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.
+
+---
+
+## 🗺️ 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
+
+Detalhes completos: [ROADMAP.md](../ROADMAP.md)
+
+---
+
+## 📖 Documentação
+
+| Documento | Descrição |
+|----------|-------------|
+| [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 |
+| [Referência da API](API.md) | Endpoints da API REST |
+| [Roadmap](../ROADMAP.md) | Roadmap de desenvolvimento e funcionalidades planejadas |
+| [Contribuindo](../CONTRIBUTING.md) | Como contribuir |
+
+---
+
+## 🧱 Stack Tecnológica
+
+| Camada | Tecnologia |
+|-------|------------|
+| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
+| Frontend | React 18, Vite, LESS |
+| Banco de Dados | SQLite / PostgreSQL |
+| Servidor Web | Nginx, Gunicorn |
+| Containers | Docker, Docker Compose |
+| Segurança | ClamAV, TOTP (pyotp), Cryptography |
+
+---
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor, leia o [CONTRIBUTING.md](../CONTRIBUTING.md) primeiro.
+
+```
+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.
+
+---
+
+## 💬 Comunidade
+
+[![Discord](https://img.shields.io/badge/Discord-Junte--se_a_Nós-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/pe4E5zmj)
+
+Entre no Discord para tirar dúvidas, compartilhar feedback ou obter ajuda com sua configuração.
+
+---
+
+<div align="center">
+
+**ServerKit** — Simples. Moderno. Auto-hospedado.
+
+[Reportar Bug](https://github.com/jhd3197/ServerKit/issues) · [Solicitar Funcionalidade](https://github.com/jhd3197/ServerKit/issues)
+
+Feito com ❤️ por [Juan Denis](https://juandenis.com)
+
+</div>
diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md
new file mode 100644
index 00000000..c9bdc6fb
--- /dev/null
+++ b/docs/README.zh-CN.md
@@ -0,0 +1,286 @@
+<div align="center">
+
+[English](../README.md) | [Español](README.es.md) | 中文版 | [Português](README.pt.md)
+
+# ServerKit
+
+<img width="700" alt="server-kit" src="https://github.com/user-attachments/assets/bfc59e75-8f90-4674-a222-e18213b628b7" />
+
+**自托管基础设施,化繁为简。**
+
+一款轻量、现代的服务器控制面板,用于管理 Web 应用、数据库、
+Docker 容器和安全策略——无需 Kubernetes 的复杂性,
+也没有托管平台的高昂成本。
+
+<br>
+
+![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
+![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/pe4E5zmj)
+
+[![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)
+[![Flask](https://img.shields.io/badge/flask-3.0-000000.svg?style=flat-square&logo=flask&logoColor=white)](https://flask.palletsprojects.com)
+[![Nginx](https://img.shields.io/badge/nginx-reverse_proxy-009639.svg?style=flat-square&logo=nginx&logoColor=white)](https://nginx.org)
+[![Let's Encrypt](https://img.shields.io/badge/SSL-Let's_Encrypt-003A70.svg?style=flat-square&logo=letsencrypt&logoColor=white)](https://letsencrypt.org)
+
+<br>
+
+[功能特性](#-功能特性) · [快速开始](#-快速开始) · [截图预览](#-截图预览) · [系统架构](#-系统架构) · [路线图](#-路线图) · [文档](#-文档) · [参与贡献](#-参与贡献) · [社区](#-社区)
+
+</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 进程管理,支持日志实时推送
+
+🐳 **Docker** — 全面的容器和 Docker Compose 管理
+
+🔑 **环境变量** — 安全加密的应用级变量管理
+
+### 基础设施
+
+🌐 **域名管理** — Nginx 虚拟主机,配置简便
+
+🔒 **SSL 证书** — Let's Encrypt 自动签发与自动续期
+
+🗄️ **数据库** — 支持 MySQL/MariaDB 和 PostgreSQL
+
+🛡️ **防火墙 (UFW)** — 可视化防火墙规则管理
+
+⏰ **定时任务** — 可视化编辑器调度 Cron 任务
+
+📁 **文件管理器** — 通过 Web 界面浏览和编辑文件
+
+📡 **FTP 服务器** — 管理 vsftpd 用户和访问权限
+
+### 安全
+
+🔐 **双因素认证** — 基于 TOTP 的验证,支持备用恢复码
+
+🦠 **恶意软件扫描** — 集成 ClamAV,支持隔离处理
+
+📋 **文件完整性监控** — 检测未授权的文件变更
+
+🚨 **安全告警** — 实时威胁通知
+
+🧱 **Fail2ban 和 SSH** — 暴力破解防护与 SSH 密钥管理
+
+### 监控与告警
+
+📊 **实时指标** — 通过 WebSocket 监控 CPU、内存、磁盘、网络
+
+📈 **运行时间追踪** — 服务器历史在线率数据
+
+🔔 **通知推送** — 支持 Discord、Slack、Telegram 及通用 Webhook
+
+🖥️ **多服务器管理** — 基于 Agent 的远程服务器监控与管理
+
+---
+
+## 🚀 快速开始
+
+> ⏱️ 不到 2 分钟即可启动运行
+
+### 方式一:一键安装(推荐)
+
+```bash
+curl -fsSL https://serverkit.ai/install.sh | bash
+```
+
+> 支持 Ubuntu 22.04+ 和 Debian 12+,自动完成所有配置。
+
+### 方式二:Docker
+
+```bash
+git clone https://github.com/jhd3197/ServerKit.git
+cd ServerKit
+cp .env.example .env # 编辑 .env 文件,填入你的密钥
+docker compose up -d # 访问 http://localhost
+```
+
+### 方式三:手动安装
+
+参阅 [安装指南](INSTALLATION.md) 获取详细的分步说明。
+
+### 系统要求
+
+| | 最低配置 | 推荐配置 |
+|---|---------|-------------|
+| **操作系统** | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
+| **CPU** | 1 vCPU | 2+ vCPU |
+| **内存** | 1 GB | 2+ GB |
+| **磁盘** | 10 GB | 20+ GB |
+| **Docker** | 24.0+ | 最新版 |
+
+---
+
+## 📸 截图预览
+
+<p align="center">
+
+![Workflow-Builder](https://github.com/user-attachments/assets/fc58beac-5e2c-487e-a37b-eaa6473eb325)
+
+</p>
+
+<details>
+<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>
+
+<p align="center">
+ <img width="100%" alt="Workflow Builder" src="https://github.com/user-attachments/assets/1271f01d-f666-4609-8bc0-22a22c81eaf3" />
+</p>
+
+<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>
+
+<p align="center">
+ <img width="100%" alt="Applications Logs" src="https://github.com/user-attachments/assets/3c397d1e-1452-4111-baae-452fb7bfbed7" />
+</p>
+
+</details>
+
+---
+
+## 🏗️ 系统架构
+
+```
+ ┌──────────────────┐
+ │ INTERNET │
+ └────────┬─────────┘
+ │
+ ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│ YOUR SERVER │
+│ │
+│ ┌─────────────────────────────────────────────────────────────────────┐ │
+│ │ 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 │ │
+│ └─────────────────────────────────────────────────────────────────────┘ │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+**[查看完整架构文档 →](ARCHITECTURE.md)** — 请求流程、模板系统、端口分配、数据库关联及故障排查。
+
+---
+
+## 🗺️ 路线图
+
+- [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,支持推送通知
+- [ ] 插件市场 — 扩展、自定义组件、主题
+
+完整详情:[ROADMAP.md](../ROADMAP.md)
+
+---
+
+## 📖 文档
+
+| 文档 | 说明 |
+|----------|-------------|
+| [系统架构](ARCHITECTURE.md) | 系统设计、请求流程、架构图 |
+| [安装指南](INSTALLATION.md) | 完整的安装配置说明 |
+| [部署指南](DEPLOYMENT.md) | CLI 命令与生产环境部署 |
+| [API 参考](API.md) | REST API 接口文档 |
+| [路线图](../ROADMAP.md) | 开发路线图与规划功能 |
+| [参与贡献](../CONTRIBUTING.md) | 如何参与贡献 |
+
+---
+
+## 🧱 技术栈
+
+| 层级 | 技术 |
+|-------|------------|
+| 后端 | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
+| 前端 | React 18, Vite, LESS |
+| 数据库 | SQLite / PostgreSQL |
+| Web 服务器 | Nginx, Gunicorn |
+| 容器 | Docker, Docker Compose |
+| 安全 | ClamAV, TOTP (pyotp), Cryptography |
+
+---
+
+## 🤝 参与贡献
+
+欢迎贡献代码!请先阅读 [CONTRIBUTING.md](../CONTRIBUTING.md)。
+
+```
+Fork → 创建功能分支 → 提交代码 → 推送 → 发起 Pull Request
+```
+
+**优先领域:** 备份功能实现、更多通知渠道、UI/UX 改进、文档完善。
+
+---
+
+## 💬 社区
+
+[![Discord](https://img.shields.io/badge/Discord-加入我们-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/pe4E5zmj)
+
+加入 Discord 社区,提出问题、分享反馈,或获取安装部署方面的帮助。
+
+---
+
+<div align="center">
+
+**ServerKit** — 简洁。现代。自托管。
+
+[报告 Bug](https://github.com/jhd3197/ServerKit/issues) · [功能建议](https://github.com/jhd3197/ServerKit/issues)
+
+由 [Juan Denis](https://juandenis.com) 用 ❤️ 打造
+
+</div>