# laimeng2024/1panel architecture

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

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

## Overview

1Panel is a web-based Linux server control panel. The principal workflow is an administrator using the web interface to request server operations and view results; the README identifies host monitoring, file and database administration, container management, website deployment, application installation, security, and backup/restore as key capabilities. The sampled code confirms the app-store API-to-service path, app persistence, cloud-storage selection, and server startup. Many feature-specific implementations were not sampled, so those branches are shown at subsystem level and their internal links are not asserted.

Main entry points: [`backend/app/service/app.go`](https://github.com/laimeng2024/1panel/blob/dev/backend/app/service/app.go) (App store service), [`backend/init/router/router.go`](https://github.com/laimeng2024/1panel/blob/dev/backend/init/router/router.go) (API routing), [`frontend/src/App.vue`](https://github.com/laimeng2024/1panel/blob/dev/frontend/src/App.vue) (Panel UI), [`frontend/src/api/modules/app.ts`](https://github.com/laimeng2024/1panel/blob/dev/frontend/src/api/modules/app.ts) (App API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web interface"]
  node_webapp["Panel UI<br/>[App.vue]"]
  node_appclient["App API client<br/>[app.ts]"]
end

subgraph group_backend["API and services"]
  node_api["API routing<br/>[router.go]"]
  node_appapi["App API handlers<br/>[app.go]"]
  node_appservice["App store service<br/>[app.go]"]
  node_serverstart["HTTP server<br/>[server.go]"]
end

subgraph group_operations["Server operations"]
  node_server["Server operations"]
  node_host["Host monitoring"]
  node_files["File management"]
  node_databases["Database administration"]
  node_containers["Container management"]
  node_websites["Website deployment"]
  node_security["Security controls"]
  node_backup["Backup and restore"]
  node_cloudstorage["Cloud storage"]
end

subgraph group_persistence["Persistence"]
  node_appdata[("App catalog data<br/>[app.go]")]
  node_database[("Application database<br/>[app.go]")]
end

node_admin(("Administrator"))

node_admin -->|"uses"| node_webapp
node_webapp -.->|"requests"| node_appclient
node_appclient -.->|"calls"| node_api
node_api -.->|"routes"| node_appapi
node_appapi -->|"invokes"| node_appservice
node_appservice -->|"queries"| node_appdata
node_appdata -.->|"persists"| node_database
node_appservice -->|"installs with"| node_containers
node_admin -->|"manages"| node_host
node_admin -->|"manages"| node_files
node_admin -->|"administers"| node_databases
node_admin -->|"manages"| node_containers
node_admin -->|"deploys"| node_websites
node_admin -->|"configures"| node_security
node_admin -->|"backs up"| node_backup
node_backup -.->|"stores backups"| node_cloudstorage
node_serverstart -->|"serves"| node_api

click node_webapp "https://github.com/laimeng2024/1panel/blob/dev/frontend/src/App.vue"
click node_appclient "https://github.com/laimeng2024/1panel/blob/dev/frontend/src/api/modules/app.ts"
click node_api "https://github.com/laimeng2024/1panel/blob/dev/backend/init/router/router.go"
click node_appapi "https://github.com/laimeng2024/1panel/blob/dev/backend/app/api/v1/app.go"
click node_appservice "https://github.com/laimeng2024/1panel/blob/dev/backend/app/service/app.go"
click node_appdata "https://github.com/laimeng2024/1panel/blob/dev/backend/app/repo/app.go"
click node_server "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_host "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_files "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_databases "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_containers "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_websites "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_security "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_backup "https://github.com/laimeng2024/1panel/tree/dev/backend/app/service"
click node_cloudstorage "https://github.com/laimeng2024/1panel/blob/dev/backend/utils/cloud_storage/cloud_storage_client.go"
click node_database "https://github.com/laimeng2024/1panel/blob/dev/backend/app/model/app.go"
click node_serverstart "https://github.com/laimeng2024/1panel/blob/dev/backend/server/server.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_webapp,node_appclient toneBlue
class node_api,node_appapi,node_appservice,node_serverstart toneAmber
class node_server,node_host,node_files,node_databases,node_containers,node_websites,node_security,node_backup,node_cloudstorage toneMint
class node_appdata,node_database toneRose
class node_admin toneIndigo
```

## Components

### Web interface

- [Panel UI](https://github.com/laimeng2024/1panel/blob/dev/frontend/src/App.vue): `frontend/src/App.vue`
- [App API client](https://github.com/laimeng2024/1panel/blob/dev/frontend/src/api/modules/app.ts): `frontend/src/api/modules/app.ts`

### API and services

- [API routing](https://github.com/laimeng2024/1panel/blob/dev/backend/init/router/router.go): `backend/init/router/router.go`
- [App API handlers](https://github.com/laimeng2024/1panel/blob/dev/backend/app/api/v1/app.go): `backend/app/api/v1/app.go`
- [App store service](https://github.com/laimeng2024/1panel/blob/dev/backend/app/service/app.go): `backend/app/service/app.go`
- [HTTP server](https://github.com/laimeng2024/1panel/blob/dev/backend/server/server.go): `backend/server/server.go`

### Server operations

- [Server operations](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Host monitoring](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [File management](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Database administration](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Container management](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Website deployment](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Security controls](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Backup and restore](https://github.com/laimeng2024/1panel/tree/dev/backend/app/service): `backend/app/service`
- [Cloud storage](https://github.com/laimeng2024/1panel/blob/dev/backend/utils/cloud_storage/cloud_storage_client.go): `backend/utils/cloud_storage/cloud_storage_client.go`

### Persistence

- [App catalog data](https://github.com/laimeng2024/1panel/blob/dev/backend/app/repo/app.go): `backend/app/repo/app.go`
- [Application database](https://github.com/laimeng2024/1panel/blob/dev/backend/app/model/app.go): `backend/app/model/app.go`

### Other components

- **Administrator**

## Connections

- Administrator → Panel UI: uses (evidence: `README.md`)
- Panel UI → App API client: requests
- App API client → API routing: calls
- API routing → App API handlers: routes
- App API handlers → App store service: invokes (evidence: `backend/app/api/v1/app.go`)
- App store service → App catalog data: queries (evidence: `backend/app/service/app.go`)
- App catalog data → Application database: persists
- App store service → Container management: installs with (evidence: `backend/app/service/app.go`)
- Administrator → Host monitoring: manages (evidence: `README.md`)
- Administrator → File management: manages (evidence: `README.md`)
- Administrator → Database administration: administers (evidence: `README.md`)
- Administrator → Container management: manages (evidence: `README.md`)
- Administrator → Website deployment: deploys (evidence: `README.md`)
- Administrator → Security controls: configures (evidence: `README.md`)
- Administrator → Backup and restore: backs up (evidence: `README.md`)
- Backup and restore → Cloud storage: stores backups
- HTTP server → API routing: serves (evidence: `backend/server/server.go`)