KPanel

> 设计协作

Free

与 kejilion.sh 双向互通的现代 Linux 服务器管理面板

327 stars0 likes3 views

Website GitHub

About

与 kejilion.sh 双向互通的现代 Linux 服务器管理面板

把服务器，变成你的运维工作台。

与 kejilion.sh 双向互通的开源 Linux 服务器管理面板。

桌面模式与经典模式共享同一套主机状态，让系统、网站、Docker、文件、集群与 AI 助手在一个控制面中协同工作。

产品官网 · English · 开始部署 · 图文教程 · 版本发布

KPanel 面向单管理员 Linux 服务器场景：从一台主机开始，在需要时连接更多节点。它不把资源锁进面板私有数据库； kejilion.sh、SSH、Compose 与 KPanel 始终面向同一台主机的真实状态。

  一套能力，两种工作方式

  桌面模式适合多窗口协作，经典模式适合快速巡检；切换的是界面，不是系统。


  真实主机，不造第二套事实

  系统、Nginx、Docker 与文件本身就是事实来源，既有资源无需导入即可继续管理。






  AI 是工作窗口

  多 Provider、多模型与结构化工具直接使用 KPanel 已掌握的状态，默认人工确认，高风险操作始终确认。


  从单机到多节点

  KPanel 节点可配对集中观测；非面板主机可通过无需 Docker 的轻量节点，以出站 HTTPS 提供只读观测。

一套能力，两种工作方式

桌面模式保留拖拽、最小化、最大化、任务栏与多窗口；经典模式提供熟悉的侧栏、结构化表单和高密度信息。两者共享同一账户、同一 Agent 与同一主机状态，无需迁移任何资源。

桌面模式 · 把复杂任务摊开来做
经典模式 · 保持面板应有的直接




监控、终端、集群和 AI 助手可以并行展开，适合排障与跨模块操作。
清晰侧栏、连续配置和快速巡检，保留传统服务器面板的效率。

AI 是工作窗口，不是第二套控制面

KPanel 的轻量 AI 助手直接理解面板已经掌握的主机与容器状态，通过固定、结构化的 KPanel 工具完成查询、分析和建议，不提供任意宿主机 Shell 或通用联网工具。

支持 OpenAI-compatible、Anthropic 与 Gemini Provider，以及多模型、多会话。
会话默认使用人工审批；可选安全自动审批，高风险动作始终需要确认。
工具过程、关键变更与结果可审计；主机资源仍由 KPanel Agent 实时读取和统一管理。
AI 数据独立保存，不会成为 Docker、Nginx、系统配置或文件的第二份事实来源。

一屏看全局，也能回到单机细节

KPanel 把多节点概览与主机历史趋势放在同一条工作路径中：远端 KPanel 提供只读概要，本机与新授权 v2 节点支持多主机终端；CPU、内存、磁盘、网络与容器历史可按时间回看。

核心能力

场景	KPanel 提供什么
主机与历史监控	查看 CPU、内存、磁盘、负载、网络、连接与容器历史；查看实时进程，并管理主机名、SSH、DNS、时区、Swap、软件源、内核预设、系统更新与清理。
网站与 Nginx	发现已有站点、证书与真实 Nginx 配置；管理静态站、PHP 站、反向代理、负载均衡、域名重定向及 LDNMP 环境。
Docker 与应用	管理容器、镜像、网络、卷、日志、性能、更新、备份和迁移；应用市场动态对齐 `app.kejilion.sh`，展示真实安装状态与任务进度。
文件、终端与体检	管理主机文件、实时进程与系统设置；通过受控终端处理本机或已授权 v2 KPanel 节点任务，并运行网络、硬件和综合体检。
集群与轻量节点	KPanel 节点可配对集中观测；本机与新授权 v2 节点支持多主机终端。非面板 Linux 主机可使用无需 Docker 的轻量节点，通过出站 HTTPS 提供只读观测。
AI、任务与审计	多 Provider、多模型、多会话的 AI 工作区；固定工具、审批边界、后台任务、资源版本冲突检测、审计与失败恢复。

快速开始

准备一台 Linux 服务器，使用 root 用户执行：

bash

bash  [!TIP]
> 初次使用可阅读 [KPanel 官方图文教程](https://blog.kejilion.pro/kpanel-kejilion-web-server-panel/)；
> 需要审查构建产物、固定镜像 digest 或进行开发者部署时，请使用[完整部署文档](docs/deployment.md)。

> [!IMPORTANT]
> KPanel 具备宿主机管理能力。请只在可信服务器上使用官方部署入口；生产环境请先备份现有配置，
> 并为管理入口配置 HTTPS 与访问控制。

## 管理真实主机，边界也必须真实

  kejilion.sh · SSH · Compose · KPanel

  共同管理同一台 Linux 主机的真实状态

- **不接管既有环境**：安装器不会修改 `kejilion.sh`、`/home/web`、Nginx、防火墙或现有站点。
- **来源不限制管理**：脚本、KPanel、Compose 或人工创建的资源，都可以按实际状态继续管理。
- **权限分层**：Web/API 以非特权身份运行；宿主机操作由 Unix Socket 上的结构化 Agent 执行，root PTY 使用独立授权和有界生命周期。
- **入口保护**：登录限速、服务端 Session、CSRF、可选 TOTP、路径约束与供应链校验共同保护管理入口。
- **变更可恢复**：关键操作保留审计记录；配置写入前执行校验，失败时回滚并报告未完成的清理项。

完整原则见 [PROJECT_RULES.md](PROJECT_RULES.md)、[架构与事实来源](docs/architecture.md)、
[生态互通基线](docs/ecosystem-parity.md)与[操作边界审计](docs/operational-boundary-audit.md)。

## 当前边界

Compose / `daemon.json` 通用编辑器、系统重装非交互适配器，以及部分发行版的 DNS / 换源适配器仍在规划中。
这些是待实现能力；后续实现仍需经过鉴权、结构化输入、路径约束、并发控制、审计和失败恢复。

## 文档

| 主题 | 入口 |
| --- | --- |
| 开始使用 | [产品官网](https://kpanel.kejilion.sh/) · [图文教程](https://blog.kejilion.pro/kpanel-kejilion-web-server-panel/) · [部署文档](docs/deployment.md) · [平台支持](docs/platform-support.md) |
| 产品架构 | [架构与事实来源](docs/architecture.md) · [安全模型](docs/security-model.md) · [存储策略](docs/storage-strategy.md) |
| 核心能力 | [AI 工作区](docs/ai-workspace.md) · [集群监控](docs/cluster-monitoring.md) · [Docker 管理](docs/docker-management-v0.18.md) · [应用市场](docs/application-market.md) |
| 生态与质量 | [兼容基线](docs/compatibility.md) · [开发质量标准](docs/development-quality-standard.md) · [项目协作](docs/session-collaboration.md) |
| 版本信息 | [稳定版与预览版](docs/release-channels.md) · [更新记录](CHANGELOG.md) · [最新稳定版](https://github.com/kejilion/KPanel/releases/latest) |

更多安全、设计与工程文档

- [两步验证安全契约](docs/two-factor-authentication.md)
- [管理员密码恢复](docs/password-recovery.md)
- [多语言架构与本地化契约](docs/internationalization.md)
- [体检与第三方测试协议](docs/diagnostics.md)
- [网站业务分析](docs/legacy-site-contract.md)
- [多主机终端安全契约](docs/multi-host-terminal.md)

## 开源许可

KPanel 源代码采用 [GNU Affero General Public License v3.0 only](LICENSE)（SPDX：`AGPL-3.0-only`）。
通过网络向用户提供修改版 KPanel 服务时，应按该协议向这些用户提供对应源码。

Copyright © 2026 kejilion and KPanel contributors.

随 KPanel 分发的 `kejilion.sh` 和其他第三方组件继续使用各自的原始许可，详见[第三方许可声明](THIRD_PARTY_NOTICES.md)。
KPanel 名称和 Logo 的使用边界见[品牌说明](TRADEMARKS.md)。