Release v0.0.6 operations features

Author: so

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "emby302gateway-rs"
-version = "0.0.5"
+version = "0.0.6"
 edition = "2024"
 license = "MIT"
 

Cargo.toml

@@ -42,4 +42,5 @@ COPY --from=frontend-builder /app/frontend/dist /app/frontend/dist
 COPY data/config.toml.example /data/config.toml.example
 VOLUME ["/data"]
 EXPOSE 8090 8091 8092 8093 8094 8095
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 CMD ["/app/emby302gateway-rs", "--healthcheck"]
 ENTRYPOINT ["/app/emby302gateway-rs"]

Dockerfile

@@ -14,6 +14,11 @@ EmbyPanel 是一个 Rust + Vue 实现的 Emby STRM 直链反代面板。后端
 - 客户端 UA 拦截、播放频率限制、IP 屏蔽、用户禁用和解除封禁。
 - Webhook 通知，支持多个 POST JSON Webhook。
 - 实时播放、播放日志、运行信息日志，支持按服务器查看。
+- 运维健康检查、反代端口状态、今日请求统计、播放频率窗口状态。
+- 日志关键词搜索、级别筛选、时间筛选和 CSV 导出。
+- 配置文件备份/恢复，包含服务器、客户端管控、通知和日志配置。
+- 配置测试校验、配置审计日志、GitHub Release 更新检查。
+- `/data/logs/embypanel.log` 文件日志，支持级别、单文件大小和保留数量配置。
 - SQLite 持久化配置，Docker 下数据保存在 `/data/embypanel.db`。
 
 ## 目录结构
@@ -71,6 +76,13 @@ docker compose up -d
 docker logs -f embypanel
 ```
 
+查看健康状态：
+
+```bash
+docker ps --filter name=embypanel
+curl http://127.0.0.1:8090/healthz
+```
+
 停止：
 
 ```bash
@@ -93,6 +105,29 @@ ports:
 
 然后在面板中把服务器反代端口配置到同一范围内。
 
+## 备份和恢复
+
+面板提供独立“备份”页面。点击备份会生成配置文件并触发浏览器下载；点击还原会弹出本机文件选择框，选择配置文件后自动还原。还原会覆盖当前配置并自动重启全部反代服务。
+
+备份内容包含：
+
+- Emby 服务器配置和 API Key。
+- OpenList 地址和 Token。
+- 客户端管控配置、播放频率限制、Webhook 通知。
+- UA 规则只备份已禁用的拦截规则；自动记录且放行的客户端不会写入备份。
+- 播放频率封禁只备份仍有效的封禁；已过期或已解除的 IP/用户封禁会自动清理。
+- 系统日志文件配置。
+
+备份不包含面板管理员用户名、管理员密码、登录会话、运行日志文件和请求统计数据。
+
+## 运维接口
+
+- `GET /healthz`：公开健康检查，不需要登录，不返回敏感信息。
+- `GET /api/monitoring/healthz`：面板详细健康信息。
+- `GET /api/monitoring/proxy-status`：每个反代端口的监听状态、启动时间、最近请求和最近错误。
+- `GET /api/monitoring/stats`：今日请求、重定向、缓存命中、拦截、错误统计。统计持久化在 SQLite，并自动清理旧数据。
+- `GET /api/app-info/update-check`：登录后检查 GitHub Releases 是否有新版本。
+
 ## License
 
 本项目基于 MIT License 开源，详见 [LICENSE](LICENSE)。

README.md

@@ -1,5 +1,40 @@
 # 版本更新日志
 
+## v0.0.6
+
+发布时间：2026-05-24
+
+### 新增
+
+- 新增公开健康检查 `/healthz` 和面板详细健康检查。
+- 新增反代端口状态，显示监听状态、启动时间、最近请求和最近错误。
+- 新增请求统计，按服务器持久化保存今日请求、重定向、缓存命中、拦截和错误数，并自动清理旧数据。
+- 新增配置文件备份和还原，还原后自动刷新配置并重启反代服务。
+- 新增配置测试校验，可检测本地端口、Emby API Key 和连接状态。
+- 新增 GitHub Releases 更新检查。
+- 新增配置审计日志，记录服务器配置、客户端规则、通知、账户、备份恢复等管理操作。
+- 新增日志文件写入 `/data/logs/embypanel.log`，支持日志级别、单文件大小和保留数量配置。
+- 新增日志关键词、级别、时间范围筛选和 CSV 导出。
+- 新增播放频率限制窗口可视化，显示 IP 当前次数、阈值、剩余次数、重置时间和封禁状态。
+- 备份还原调整为独立页面，点击备份自动下载配置文件，点击还原弹出本机文件选择框，备份范围明确排除面板管理员用户名和密码。
+- 备份客户端 UA 规则时只保留已禁用的拦截规则，自动记录且放行的客户端不再写入备份。
+- 播放频率封禁记录改为自动清理，已过期或已解除的 IP/用户封禁不再保留到数据库和备份中。
+
+### 优化
+
+- CSV 日志导出改为带登录态下载，避免直接打开导出接口导致 401。
+- 配置测试时当前服务已经监听的反代端口不再误报为端口占用。
+- 代理 Emby 失败会记录到端口状态和今日错误统计。
+- 首页新增运维概览，服务器页新增配置测试，日志页新增文件日志配置，账户页新增审计日志。
+
+### 验证
+
+- `cargo fmt --check`
+- `cargo clippy --all-targets -- -D warnings`
+- `cargo test`
+- `cd frontend && npm run build`
+- `cargo build --release --locked`
+
 ## v0.0.5
 
 发布时间：2026-05-24