ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
feat(panel): wire imports, database tools and quick wins into the app
Juan Denis91e6f5cb29cb
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4d296859..077cf52c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -28,6 +28,39 @@ awaiting a stable release:### Added+- **Import a site (migration pipeline)** — a 5-step wizard at `/imports`+ (entry points on Services and WordPress) restores cPanel/WHM, DirectAdmin+ and Hestia/Vesta backup archives onto ServerKit: the archive is analysed+ into a report (domains, databases, DB users, crontab, warnings), then a+ resumable job maps it to an app, managed databases (MySQL password hashes+ preserved where the engine allows) and cron entries, with per-step logs and+ retry-from-failed-step. Uploads and fetch-by-URL both supported, with SSRF+ and archive-traversal guards throughout.+- **WordPress: import over SSH** — point at any live WordPress site with SSH+ credentials (`/wordpress/ssh-import`): probe shows the pinned host key and+ site facts, then a job pulls the docroot, dumps the database through the+ tunnel and rebuilds it as a managed site with the URL search-replaced.+- **Database tools** — the Database Explorer gains a live processlist with+ kill/terminate per server or container; a curated config tuner (RAM-aware+ suggested values for vetted MySQL/PostgreSQL settings, applied with backups+ and clean rollback, never auto-applied); managed database users tracked as+ first-class rows; and one-click "Open in Adminer" SSO via a single-use,+ five-minute shadow credential scoped to one database.+- **Per-app resource limits** — CPU and memory limits are first-class fields+ on an app (Settings → Resource Limits) showing live usage vs limit, applied+ to the container without touching the user's own compose file.+- **One-time login links** — admins can mint single-use, short-TTL,+ optionally IP-bound login URLs from Settings → Users, for "log in and take+ a look" support situations; links are hashed at rest and reaped hourly.+- **Demo mode** — an opt-in flag that blocks every mutating API call with+ `403 demo_mode` and offers seeded read-only credentials on the login page,+ for running a public demo of a real panel.+- **Cloud-metadata egress guard** — a default-on (opt-out) firewall rule+ blocking app containers from 169.254.169.254, closing the SSRF-to-cloud-IAM+ credential-theft class on cloud VPSes (Security → Firewall).+- **Server speed test** — an on-demand download/upload/latency test on the+ Monitoring page, using the Ookla/speedtest CLI when present with a+ pure-Python fallback.- **Extensions platform (Phase 7 — settings slot + manifest linting)** — extensionscan now contribute sections to the Settings page (a `settings.section` widgetslot rendered below the active tab), and `plugin.json` manifests are shape-checkeddiff --git a/backend/app/__init__.py b/backend/app/__init__.pyindex 071667af..28b5e39c 100644--- a/backend/app/__init__.py+++ b/backend/app/__init__.py@@ -76,6 +76,10 @@ def create_app(config_name=None):from app.middleware.security import register_security_headersregister_security_headers(app)+ # Demo mode guard — config-gated (default off), blocks mutating API calls+ from app.middleware.demo import init_demo_mode+ init_demo_mode(app)+# Register API key authentication middlewarefrom app.middleware.api_key_auth import register_api_key_authregister_api_key_auth(app)@@ -163,6 +167,14 @@ def create_app(config_name=None):from app.api.databases import databases_bpapp.register_blueprint(databases_bp, url_prefix='/api/v1/databases')+ # Register blueprints - Managed DB users + Adminer SSO+ from app.api.managed_db_users import managed_db_users_bp+ app.register_blueprint(managed_db_users_bp, url_prefix='/api/v1/managed-databases')++ # Register blueprints - Curated DB config tuner+ from app.api.db_tuner import db_tuner_bp+ app.register_blueprint(db_tuner_bp, url_prefix='/api/v1/db-tuner')+# Register blueprints - Monitoring & Alertsfrom app.api.monitoring import monitoring_bpapp.register_blueprint(monitoring_bp, url_prefix='/api/v1/monitoring')@@ -450,6 +462,14 @@ def create_app(config_name=None):from app.api.ai import ai_bpapp.register_blueprint(ai_bp, url_prefix='/api/v1/ai')+ # Register blueprints - Server speed test (Monitoring card)+ from app.api.speed_test import speedtest_bp+ app.register_blueprint(speedtest_bp, url_prefix='/api/v1/speedtest')++ # Register blueprints - Site imports (panel migration pipeline)+ from app.api.site_imports import site_imports_bp+ app.register_blueprint(site_imports_bp, url_prefix='/api/v1/imports')+# Handle database migrations (Alembic) — must run before plugin loader# since the loader queries the installed_plugins table.with app.app_context():@@ -566,6 +586,18 @@ def create_app(config_name=None):ServerOnboardingService.register_jobs()from app.services.preview_service import PreviewServicePreviewService.register_jobs()+ from app.services.metadata_guard_service import MetadataGuardService+ MetadataGuardService.register_jobs()+ if not app.config.get('TESTING'):+ MetadataGuardService.ensure() # converge the metadata egress rule (no-op when unsupported)+ from app.services.speed_test_service import SpeedTestService+ SpeedTestService.register_jobs()+ from app.services import login_link_service+ login_link_service.register_jobs()+ from app.services.db_admin_sso_service import DbAdminSsoService+ DbAdminSsoService.register_jobs()+ from app.services.site_import_service import SiteImportService+ SiteImportService.register_jobs()start_job_system(app, seed=seed_builtin_schedules)# Request body size limitdiff --git a/backend/app/jobs/builtin_handlers.py b/backend/app/jobs/builtin_handlers.pyindex 2a092523..45b58260 100644--- a/backend/app/jobs/builtin_handlers.py+++ b/backend/app/jobs/builtin_handlers.py@@ -341,3 +341,17 @@ def seed_builtin_schedules():ScheduledJobService.ensure(name, kind, interval_seconds=interval, startup_delay_seconds=delay,)+ # One-time login-link reaper — handler registered by+ # login_link_service.register_jobs() at boot.+ from app.services import login_link_service+ ScheduledJobService.ensure(+ login_link_service.REAP_SCHEDULE_NAME, login_link_service.REAP_JOB_KIND,+ interval_seconds=3600, startup_delay_seconds=120,+ )+ # Adminer SSO shadow-credential reaper — handler registered by+ # DbAdminSsoService.register_jobs() at boot.+ from app.services import db_admin_sso_service+ ScheduledJobService.ensure(+ db_admin_sso_service.REAP_SCHEDULE_NAME, db_admin_sso_service.REAP_JOB_KIND,+ interval_seconds=300, startup_delay_seconds=120,+ )diff --git a/backend/app/models/__init__.py b/backend/app/models/__init__.pyindex 5f8f6fe2..8c961734 100644--- a/backend/app/models/__init__.py+++ b/backend/app/models/__init__.py@@ -64,6 +64,9 @@ from app.notifications.models import Notification, NotificationDeliveryfrom app.models.email_provider import EmailProviderConnectionfrom app.models.system_event import SystemEventfrom app.models.domain_registration import DomainRegistration+from app.models.login_link import LoginLink+from app.models.managed_database_user import ManagedDatabaseUser+from app.models.site_import import SiteImport__all__ = ['User', 'Application', 'Domain', 'EnvironmentVariable', 'EnvironmentVariableHistory',@@ -104,4 +107,7 @@ __all__ = ['ApplicationPreview', 'ApplicationPreviewSettings','ProxyStack','SiteBaseDomain',+ 'LoginLink',+ 'ManagedDatabaseUser',+ 'SiteImport',]diff --git a/backend/tests/test_jobs.py b/backend/tests/test_jobs.pyindex c62bf987..2b8b6fcd 100644--- a/backend/tests/test_jobs.py+++ b/backend/tests/test_jobs.py@@ -178,10 +178,11 @@ class TestBuiltins:assert len([k for k in kinds if k.startswith('builtin.')]) == 10builtin_handlers.seed_builtin_schedules()- assert ScheduledJob.query.count() == 10+ # 10 builtin.* schedules + the login-link and SSO-credential reapers.+ assert ScheduledJob.query.count() == 12# Seeding twice doesn't duplicate.builtin_handlers.seed_builtin_schedules()- assert ScheduledJob.query.count() == 10+ assert ScheduledJob.query.count() == 12class TestApi:diff --git a/frontend/src/App.jsx b/frontend/src/App.jsxindex 7ac46908..aef4a5be 100644--- a/frontend/src/App.jsx+++ b/frontend/src/App.jsx@@ -26,6 +26,7 @@ import CronJobs from './pages/CronJobs';import Security from './pages/Security';import Services from './pages/Services';import NewService from './pages/NewService';+import ImportWizard from './pages/ImportWizard';import ServiceDetail from './pages/ServiceDetail';import Templates from './pages/Templates';import Servers from './pages/Servers';@@ -79,6 +80,7 @@ const PAGE_TITLES = {'/setup': 'Setup','/services': 'Services','/services/new': 'New Service',+ '/imports': 'Import a Site','/projects': 'Projects','/shared-variables': 'Shared Variables','/fleet-proxy': 'Fleet Proxy',@@ -309,6 +311,7 @@ function AppRoutes() {{/* Settings sub-section in the URL (e.g. .../settings/git)so the Settings left-nav is shareable and survives a refresh. */}<Route path="services/:id/:tab/:section" element={<ServiceDetail />} />+ <Route path="imports" element={<ImportWizard />} /><Route path="apps" element={<Navigate to="/services" replace />} /><Route path="apps/:id" element={<LegacyAppRedirect />} /><Route path="apps/:id/:tab" element={<LegacyAppRedirect />} />diff --git a/frontend/src/services/api/index.js b/frontend/src/services/api/index.jsindex f8d989af..1695fd5c 100644--- a/frontend/src/services/api/index.js+++ b/frontend/src/services/api/index.js@@ -31,6 +31,11 @@ import * as projectMethods from './projects.js';import * as sharedResourceMethods from './sharedResources.js';import * as previewMethods from './previews.js';import * as proxyMethods from './proxy.js';+import * as metadataGuardMethods from './metadataGuard.js';+import * as speedTestMethods from './speedtest.js';+import * as dbProcessMethods from './dbProcesses.js';+import * as dbTunerMethods from './dbTuner.js';+import * as importMethods from './imports.js';class ApiService extends ApiClient {constructor() {@@ -69,6 +74,11 @@ class ApiService extends ApiClient {sharedResourceMethods,previewMethods,proxyMethods,+ metadataGuardMethods,+ speedTestMethods,+ dbProcessMethods,+ dbTunerMethods,+ importMethods,];for (const mod of modules) {for (const [key, fn] of Object.entries(mod)) {diff --git a/frontend/src/styles/main.scss b/frontend/src/styles/main.scssindex 6b5e0830..6aeaa297 100644--- a/frontend/src/styles/main.scss+++ b/frontend/src/styles/main.scss@@ -88,6 +88,8 @@@import 'pages/_applications';@import 'pages/_docker';@import 'pages/_databases';+@import 'pages/_db-processes';+@import 'pages/_db-tuner';@import 'pages/_domains';@import 'pages/_monitoring';@import 'pages/_backups';@@ -113,6 +115,7 @@@import 'pages/_email';@import 'pages/_setup-wizard';@import 'pages/_migration-wizard';+@import 'pages/_import-wizard';@import 'pages/_new-service';@import 'pages/_services';@import 'pages/_service-detail';