docs: 部署手册新增全新重部署流程与 dist 包说明

This commit is contained in:
2026-09-29 11:10:53 +08:00
parent 4c07253809
commit 5727aaa5be
+90 -3
View File
@@ -21,9 +21,95 @@ website/ ← 整个目录上传到服务器 /opt/website
--- ---
## 第一步:准备本地文件 ## 全新重部署(清空 /opt/website)
1. 打包本地 `website/` 目录为 `website.zip`(只打包目录本身,不含外层) > 适用于:网站目录全部推倒重来,服务器上其它服务(Gitea / Research Digest / Engineer Craft 等)不受影响。
> ⚠️ 清空前**必须备份运行时数据**,否则申请记录、已生成的授权文件、资源包全部丢失。
### 0. 备份数据(强制)
```bash
tar czf /root/website-backup-$(date +%F).tar.gz /opt/website/data
# 建议再拉回本地一份:
# scp root@124.220.63.9:/root/website-backup-*.tar.gz ./
```
### 1. 停止服务
1Panel → 进程守护 → `reslib` → 停止
### 2. 清空旧目录
```bash
rm -rf /opt/website
```
### 3. 上传并解压新包
本地使用 `dist/sincos.cc-deploy-YYYYMMDD.zip`(含 `website/` 与 `DEPLOY.md`):
- 1Panel → 文件 → `/opt` → 上传 → 解压;或
- scp 后执行 `cd /opt && unzip -o sincos.cc-deploy-YYYYMMDD.zip -d /opt/`
得到全新的 `/opt/website/`。
### 4. 恢复运行时数据
```bash
tar xzf /root/website-backup-$(date +%F).tar.gz -C /
mkdir -p /opt/website/data/{requests,licenses,packages}
```
确认三个目录都在:`/opt/website/data/requests`、`licenses`、`packages`。
### 5. 安装依赖
```bash
pip3 install -r /opt/website/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```
### 6. 确认管理密码
- 新包内 `website/.env` 已带 `RESLIB_ADMIN_PASSWORD=ds3317210`;
- 若 1Panel 进程守护里配置了同名环境变量,**环境变量优先**,需在 1Panel 里同步改成新密码。
### 7. 启动服务
1Panel → 进程守护 → `reslib` → 启动(如已删除则重新创建):
- 运行目录:`/opt/website`
- 启动命令:`uvicorn main:app --host 0.0.0.0 --port 8003`
- 环境变量:`RESLIB_ADMIN_PASSWORD=ds3317210`(可选,与 .env 二选一)
- 开机自启:开
### 8. 验收
```bash
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8003/
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8003/license/
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8003/tools/
```
浏览器验证:
| 地址 | 预期 |
|---|---|
| `https://sincos.cc/` | 新科技首页 |
| `https://sincos.cc/tools/` | 工具矩阵 + 界面实录 |
| `https://sincos.cc/research/neural/` | NeuralMix v2.0(含图表) |
| `https://sincos.cc/license/` | License 中心 |
| `https://sincos.cc/admin` | 用新密码 `ds3317210` 登录 |
### 9. 资源包
原 `data/packages/` 里的资源包已随备份恢复;若备份中没有,需重新上传真实资源包文件。
---
## 第一步:准备本地文件(常规更新)
1. 优先直接使用 `dist/sincos.cc-deploy-YYYYMMDD.zip`(干净包:含 website/、.env、DEPLOY.md,不含 data/)
2. 或手动把 `website/` 打成 zip(只打包目录本身,不含外层、不含 data/ 与 __pycache__/)
--- ---
@@ -34,7 +120,8 @@ website/ ← 整个目录上传到服务器 /opt/website
**方式 B:scp 命令行** **方式 B:scp 命令行**
```bash ```bash
scp -r D:\黑奴编程\网站\website root@124.220.63.9:/opt/website scp dist\sincos.cc-deploy-YYYYMMDD.zip root@124.220.63.9:/opt/
# 服务器上:cd /opt && unzip -o sincos.cc-deploy-YYYYMMDD.zip -d /opt/
``` ```
--- ---