How 1panel-dev/1panel works
1Panel is a Linux server-management panel with a web UI, a central control plane, and an agent for host operations. The main workflow is a user operating the panel, which routes API requests to management capabilities; the agent provides host-side execution. Major documented branches include AI management, app installation, websites, security, and backup/restore. The excerpts show server and router wiring plus selected service internals; most domain implementations were not sampled, so their internal call relationships are omitted.
Main entry points: app.go Management API · router/router.go Core routes · mcp_enrollment.go MCP enrollment API · router/router.go Agent routes
Components 22
User Interface
- Web panel
frontend/src/App.vue
Control Plane
- Core server
core/server/server.go - Core routes
core/init/router/router.go - MCP enrollment API
core/app/api/v2/mcp_enrollment.go - MCP enrollment
core/app/service/mcp_enrollment.go
Host Management
- Agent server
agent/server/server.go - Agent routes
agent/init/router/router.go - Management API
agent/app/api/v2/app.go - App contracts
agent/app/dto/app.go
Operations
- App marketplace
agent/app/service/app.go - App catalog sync
agent/cron/job/app.go - Website management
agent/app/service/website.go - Backup and restore
agent/app/service/backup.go - Cloud storage
agent/utils/cloud_storage/cloud_storage_client.go - AI management
agent/app/service/ai.go - AI agents
agent/app/service/agents.go - Container management
agent/app/service/container.go - Database management
agent/app/service/database.go - Firewall controls
agent/utils/firewall/iptables_helper/manager.go - Docker guard
agent/utils/firewall/docker_guard/manager.go - VM storage
agent/app/service/vm-storage.go
Other components
- Panel user
Connections 18
- Panel user → Web panel: operates
README.md - Core server → Core routes: serves routes
core/server/server.go - Core routes → MCP enrollment API: registers routes
- MCP enrollment API → MCP enrollment: calls
core/app/api/v2/mcp_enrollment.go - Agent server → Agent routes: builds routes
agent/server/server.go - Agent routes → Management API: registers handlers
agent/init/router/router.go - Management API → App contracts: uses contracts
agent/app/api/v2/app.go - App catalog sync → App marketplace: syncs catalog
agent/cron/job/app.go - Backup and restore → Cloud storage: selects provider
- Management API → Website management: dispatches requests
- Management API → Backup and restore: dispatches requests
- Management API → AI management: dispatches requests
- Management API → AI agents: dispatches requests
- Management API → Container management: dispatches requests
- Management API → Database management: dispatches requests
- Management API → Firewall controls: dispatches requests
- Management API → Docker guard: dispatches requests
- Management API → VM storage: dispatches requests