Choyeon 面板

关于

FastAPI + Vue 3 的服务器控制面板，用于管理 systemd 单元、nginx 站点、部署与健康检查。

Choyeon Panel 统一管理服务器上的应用：启动/停止 systemd 单元、编辑 nginx 配置、执行部署脚本与健康检查。本站与多个家族站点均由它托管。

功能

• systemd 单元管理
• nginx 站点配置
• 一键部署与健康检查
• 本项目也由它托管部署

截图

更新日志

## 安装

```bash
git clone --branch <本 tag> https://github.com/Choyeon/choyeon-panel.git
cd choyeon-panel && sudo bash scripts/install.sh      # 就地部署到该目录
```

不想用 git 时，下载源码包 `choyeon-panel-<版本>.tar.gz`，解压后进入目录执行同一条命令。

## 已安装实例升级

```bash
sudo choyeonctl upgrade          # 拉代码 → 备份 → 构建 → 重启，健康检查失败自动回滚
sudo choyeonctl status --json    # healthy 必须为 true
sudo choyeonctl doctor --json    # counts.fail 必须为 0
```

只改了 `.env` 配置时用 `choyeonctl upgrade --no-pull` 重新渲染 systemd unit。

## 产物

- `choyeon-panel-<版本>.tar.gz` —— 源码包（不含 `.git`、`node_modules`、`.venv`、`data`、`web/dist`）
- `choyeon-panel-web-<版本>.tar.gz` —— 前端构建产物，解压为 `web/dist` 后可直接由后端托管
- `SHA256SUMS.txt` —— 校验：`sha256sum -c SHA256SUMS.txt`

变更明细见 [CHANGELOG.md](https://github.com/Choyeon/choyeon-panel/blob/main/CHANGELOG.md)；部署与排障规则见 [AGENTS.md](https://github.com/Choyeon/choyeon-panel/blob/main/AGENTS.md) / [RUNBOOK.md](https://github.com/Choyeon/choyeon-panel/blob/main/RUNBOOK.md)。


**Full Changelog**: https://github.com/Choyeon/choyeon-panel/compare/v1.1.8...v1.1.10