42 lines
3.8 KiB
Markdown
42 lines
3.8 KiB
Markdown
# 服务器验收记录
|
||
|
||
日期:2026-10-11。代码:`feat/debian-server`;运行版本包含 `fcdf6f2`。这份记录只列公开运行状态,不包含访问密码、数据库密码、Cookie 或密钥。
|
||
|
||
## 自动检查
|
||
|
||
| 检查 | 结果 |
|
||
| --- | --- |
|
||
| Windows 后端完整测试 | 76 通过,6 个需要实际 MariaDB 的测试跳过 |
|
||
| Debian Python 3.11 后端完整测试 | 68 通过,14 个 Windows 平台测试跳过;包含 6 个实际 MariaDB 集成测试 |
|
||
| 前端测试 | Windows、Debian 均 3 通过 |
|
||
| TypeScript 与 Vite 生产构建 | 两端均通过,服务器实际使用构建后的网页 |
|
||
| 独立全分支审查 | 登录验证后的重试固定出口、账号登录固定出口、迁移拒绝不修改旧任务三项问题均已修复并通过回归验证 |
|
||
| `nginx -t` | 全服务器配置通过 |
|
||
|
||
后端有一条既有 Starlette 弃用提示。真实 MariaDB 测试使用独立 `kaoyan_studio_test` 数据库,未把测试记录写入正式库。
|
||
|
||
## 实际服务与数据
|
||
|
||
- 工作台、代理 API、抓取调度器均为 `active`、`enabled`;独立 Redis 容器运行且设置 `unless-stopped`。
|
||
- MariaDB 10.11.18,正式数据库 `kaoyan_studio`;HTTP 健康接口报告 `database=mysql`、`platform=linux`。
|
||
- 从本机在线 SQLite 快照迁移目录 27,901 条、历史线 0 条、院校索引 559 条、任务 4 个、完成单元 4,302 条、日志 4,319 条。
|
||
- 目录、历史线、任务、完成单元、日志与原 SQLite 内容相同;启动时两个院校索引名称被内置种子刷新,详见部署说明。目录的原始名称不变。
|
||
- 原全国任务 `19f9b363a1dd4f2b8a384d84351b1b61` 保持手动暂停,记录 27,901、完成单元 4,282;服务器重启后仍保持暂停。本机原任务也保持暂停。
|
||
- 登录 Cookie 在服务器以权限 0600 的密钥重新加密保存。实际第二页验证返回 `login_required`,界面据实显示需重新登录;不会继承 Windows 已验证标记。
|
||
- 请求间隔上下限 1.2、2.4 秒;自动代理轮换阈值 100 次成功请求。代理池启动时已有 56 个 HTTP 候选、没有 HTTPS 候选;工作台保留原电脑的 24 个 HTTPS 备用出口,实际验证请求通过其中的代理完成。
|
||
|
||
## HTTPS 与浏览器
|
||
|
||
- `https://186.241.68.230:9443` 从用户电脑可访问;使用系统信任的有效 IP 证书,API 验收和浏览器验收均未忽略证书错误。
|
||
- 未认证请求返回 401;提供工作台账号后目录查询、详情、任务、设置、代理服务接口均返回正常结果。
|
||
- 真实跨来源修改返回 403;同来源保存原设置返回 200。
|
||
- 通过页面使用的管理 API 停止和启动代理服务成功,只操作本项目 API 与调度器,独立 Redis 保持运行。
|
||
- Edge 无界面验收:数据概览、实际目录表格、Linux 登录提示、代理池状态、手机宽度正常,没有浏览器脚本异常。
|
||
- Cookie 说明、顶部运行位置与数据保存位置显示为服务器;Linux 页面不显示打开服务器 Edge 窗口的按钮。
|
||
- IP 证书的续期模拟成功,现有 `certbot.timer` 调用 Certbot 5.8.0,续期后 reload Nginx。
|
||
- 用户改为 HTTPS 回源后,`https://kaoyan.fjayson.com` 不再重定向循环;未认证返回 401,认证后健康接口、目录、任务和代理服务接口均返回 200,页面验收通过。同来源 POST 状态检查成功,跨来源修改返回 403,响应包含 `Cache-Control: private, no-store`。DNS 指向 CDN 节点本身不影响部署。
|
||
|
||
## 私密备份
|
||
|
||
服务器 `/var/backups/kaoyan-studio/` 权限 0700,数据库备份权限 0600;保存数据库、含 Cookie 加密密钥的运行目录、私密数据库配置和 Nginx 认证文件。原 SQLite 快照保留在部署目录的 `incoming/`。访问账号单独交付到用户电脑。
|