# 1panel-dev/1panel architecture

> Architecture diagram of the GitHub repository 1panel-dev/1panel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1panel-dev/1panel
- Repository: https://github.com/1panel-dev/1panel

## Overview

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: [`agent/app/api/v2/app.go`](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/api/v2/app.go) (Management API), [`core/init/router/router.go`](https://github.com/1panel-dev/1panel/blob/dev-v2/core/init/router/router.go) (Core routes), [`core/app/api/v2/mcp_enrollment.go`](https://github.com/1panel-dev/1panel/blob/dev-v2/core/app/api/v2/mcp_enrollment.go) (MCP enrollment API), [`agent/init/router/router.go`](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/init/router/router.go) (Agent routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_web["Web panel<br/>[App.vue]"]
end

subgraph group_control["Control Plane"]
  node_core_server["Core server<br/>[server.go]"]
  node_core_router["Core routes<br/>[router.go]"]
  node_mcp_enrollment_api["MCP enrollment API<br/>[mcp_enrollment.go]"]
  node_mcp_enrollment_service["MCP enrollment<br/>[mcp_enrollment.go]"]
end

subgraph group_host["Host Management"]
  node_agent_server["Agent server<br/>[server.go]"]
  node_agent_router["Agent routes<br/>[router.go]"]
  node_agent_api["Management API<br/>[app.go]"]
  node_app_contracts["App contracts<br/>[app.go]"]
end

subgraph group_operations["Operations"]
  node_app_management["App marketplace<br/>[app.go]"]
  node_app_sync_job["App catalog sync<br/>[app.go]"]
  node_website_management["Website management<br/>[website.go]"]
  node_backup_management["Backup and restore<br/>[backup.go]"]
  node_cloud_storage["Cloud storage"]
  node_ai_management["AI management<br/>[ai.go]"]
  node_agent_management["AI agents<br/>[agents.go]"]
  node_container_management["Container management<br/>[container.go]"]
  node_database_management["Database management<br/>[database.go]"]
  node_firewall_rules["Firewall controls<br/>[manager.go]"]
  node_docker_guard["Docker guard<br/>[manager.go]"]
  node_vm_storage["VM storage<br/>[vm-storage.go]"]
end

node_user(("Panel user"))

node_user -->|"operates"| node_web
node_core_server -->|"serves routes"| node_core_router
node_core_router -.->|"registers routes"| node_mcp_enrollment_api
node_mcp_enrollment_api -->|"calls"| node_mcp_enrollment_service
node_agent_server -->|"builds routes"| node_agent_router
node_agent_router -->|"registers handlers"| node_agent_api
node_agent_api -->|"uses contracts"| node_app_contracts
node_app_sync_job -->|"syncs catalog"| node_app_management
node_backup_management -.->|"selects provider"| node_cloud_storage
node_agent_api -.->|"dispatches requests"| node_website_management
node_agent_api -.->|"dispatches requests"| node_backup_management
node_agent_api -.->|"dispatches requests"| node_ai_management
node_agent_api -.->|"dispatches requests"| node_agent_management
node_agent_api -.->|"dispatches requests"| node_container_management
node_agent_api -.->|"dispatches requests"| node_database_management
node_agent_api -.->|"dispatches requests"| node_firewall_rules
node_agent_api -.->|"dispatches requests"| node_docker_guard
node_agent_api -.->|"dispatches requests"| node_vm_storage

click node_web "https://github.com/1panel-dev/1panel/blob/dev-v2/frontend/src/App.vue"
click node_core_server "https://github.com/1panel-dev/1panel/blob/dev-v2/core/server/server.go"
click node_core_router "https://github.com/1panel-dev/1panel/blob/dev-v2/core/init/router/router.go"
click node_mcp_enrollment_api "https://github.com/1panel-dev/1panel/blob/dev-v2/core/app/api/v2/mcp_enrollment.go"
click node_mcp_enrollment_service "https://github.com/1panel-dev/1panel/blob/dev-v2/core/app/service/mcp_enrollment.go"
click node_agent_server "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/server/server.go"
click node_agent_router "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/init/router/router.go"
click node_agent_api "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/api/v2/app.go"
click node_app_contracts "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/dto/app.go"
click node_app_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/app.go"
click node_app_sync_job "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/cron/job/app.go"
click node_website_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/website.go"
click node_backup_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/backup.go"
click node_cloud_storage "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/cloud_storage/cloud_storage_client.go"
click node_ai_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/ai.go"
click node_agent_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/agents.go"
click node_container_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/container.go"
click node_database_management "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/database.go"
click node_firewall_rules "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/firewall/iptables_helper/manager.go"
click node_docker_guard "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/firewall/docker_guard/manager.go"
click node_vm_storage "https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/vm-storage.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_user toneBlue
class node_core_server,node_core_router,node_mcp_enrollment_api,node_mcp_enrollment_service toneAmber
class node_agent_server,node_agent_router,node_agent_api,node_app_contracts toneMint
class node_app_management,node_app_sync_job,node_website_management,node_backup_management,node_cloud_storage,node_ai_management,node_agent_management,node_container_management,node_database_management,node_firewall_rules,node_docker_guard,node_vm_storage toneRose
```

## Components

### User Interface

- [Web panel](https://github.com/1panel-dev/1panel/blob/dev-v2/frontend/src/App.vue): `frontend/src/App.vue`

### Control Plane

- [Core server](https://github.com/1panel-dev/1panel/blob/dev-v2/core/server/server.go): `core/server/server.go`
- [Core routes](https://github.com/1panel-dev/1panel/blob/dev-v2/core/init/router/router.go): `core/init/router/router.go`
- [MCP enrollment API](https://github.com/1panel-dev/1panel/blob/dev-v2/core/app/api/v2/mcp_enrollment.go): `core/app/api/v2/mcp_enrollment.go`
- [MCP enrollment](https://github.com/1panel-dev/1panel/blob/dev-v2/core/app/service/mcp_enrollment.go): `core/app/service/mcp_enrollment.go`

### Host Management

- [Agent server](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/server/server.go): `agent/server/server.go`
- [Agent routes](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/init/router/router.go): `agent/init/router/router.go`
- [Management API](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/api/v2/app.go): `agent/app/api/v2/app.go`
- [App contracts](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/dto/app.go): `agent/app/dto/app.go`

### Operations

- [App marketplace](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/app.go): `agent/app/service/app.go`
- [App catalog sync](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/cron/job/app.go): `agent/cron/job/app.go`
- [Website management](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/website.go): `agent/app/service/website.go`
- [Backup and restore](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/backup.go): `agent/app/service/backup.go`
- [Cloud storage](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/cloud_storage/cloud_storage_client.go): `agent/utils/cloud_storage/cloud_storage_client.go`
- [AI management](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/ai.go): `agent/app/service/ai.go`
- [AI agents](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/agents.go): `agent/app/service/agents.go`
- [Container management](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/container.go): `agent/app/service/container.go`
- [Database management](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/database.go): `agent/app/service/database.go`
- [Firewall controls](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/firewall/iptables_helper/manager.go): `agent/utils/firewall/iptables_helper/manager.go`
- [Docker guard](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/utils/firewall/docker_guard/manager.go): `agent/utils/firewall/docker_guard/manager.go`
- [VM storage](https://github.com/1panel-dev/1panel/blob/dev-v2/agent/app/service/vm-storage.go): `agent/app/service/vm-storage.go`

### Other components

- **Panel user**

## Connections

- Panel user → Web panel: operates (evidence: `README.md`)
- Core server → Core routes: serves routes (evidence: `core/server/server.go`)
- Core routes → MCP enrollment API: registers routes
- MCP enrollment API → MCP enrollment: calls (evidence: `core/app/api/v2/mcp_enrollment.go`)
- Agent server → Agent routes: builds routes (evidence: `agent/server/server.go`)
- Agent routes → Management API: registers handlers (evidence: `agent/init/router/router.go`)
- Management API → App contracts: uses contracts (evidence: `agent/app/api/v2/app.go`)
- App catalog sync → App marketplace: syncs catalog (evidence: `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
