# kangle + easypanel 部署与模板套件

基于 kangle 3.5.21.16 + easypanel 2.6.29 的用户端面板模板、安装脚本与运维工具。

## 快速开始

### 已有 kangle 的机器：只换模板

```bash
git clone http://git.ciyunshuju.com/root/kangle-easypanel-template.git /tmp/tpl
bash /tmp/tpl/deploy/apply-panel-template.sh   # 自动备份，可回滚
bash /tmp/tpl/deploy/harden-php.sh             # opcache + 256M
```

### 全新机器：从零安装

```bash
bash deploy/install-stack.sh --check   # 先自检
bash deploy/install-stack.sh           # 安装
```

## 四个必须知道的坑（实测）

1. **kangle 3311 管理账号**默认是 `admin/kangle`，必须改：
   `config.xml` → `<admin user='...' password='...'>`
2. **面板登录凭据**在 `node.cfg.php` → `node_cfg['localhost']['user'/'passwd']`
3. **两者必须完全一致**。不一致时前端密码输对也登不上，且**没有任何错误提示**
4. **Ubuntu 上 PHP 缺 11 个 CentOS 库**（`libssl.so.10`、`libicu*.so.50` 等），
   需放到 `/opt/compat` 并 `ldconfig`

## 已验证环境

| 系统 | 结果 |
|---|---|
| CentOS 7.6 x64 | ✅ 生产运行（108 站点） |
| Ubuntu 22.04 x64 | ✅ 从零安装，登录 302，业务页正常 |

## 目录

```
install.sh                     一键入口（--check / 全量）
deploy/install-stack.sh        Kangle+面板+PHP+MySQL 安装
deploy/apply-panel-template.sh 模板部署
deploy/harden-php.sh           PHP 加固
template/                      用户端面板模板
control/db.ctl.php             数据库模块控制器
tools/quota_scan.sh            站点空间用量统计
docs/一键部署方案.md            彩虹脚本链路分析
docs/改动记录.md                模板改动明细
```

## 面板功能（模板层）

- 首页 6 组重构（网站/文件/数据库/安全/工具/监控）
- 数据库管理页（容量、连接信息、改密、导出、导入、phpMyAdmin）
- 计划任务（6 套餐 + 主机 cron 开通，3 类未实现功能置灰标注）
- 空间用量统计（quota_scan + cron，修复原版显示为空）

## 回滚

```bash
# 模板
tar xzf /root/kangle_backup/vhost_view_*.tar.gz -C /vhs/kangle/nodewww/webftp/vhost
# PHP 版本
bash /root/phpver_rollback.sh <备份文件>
```