chengongfei
179 lines
4.5 KiB
Markdown
179 lines
4.5 KiB
Markdown
# fragmemo 部署指南
|
||
|
||
> 部署到华为云服务器（宝塔面板 + Ubuntu 22.04）
|
||
|
||
---
|
||
|
||
## 一、前置信息
|
||
|
||
| 项目 | 值 |
|
||
|------|-----|
|
||
| 服务器 IP | `113.44.249.175` |
|
||
| 操作系统 | Ubuntu 22.04 |
|
||
| 宝塔面板 | `https://113.44.249.175:2026/527378` |
|
||
| MySQL | 已安装（宝塔管理） |
|
||
| Nginx | 已安装（宝塔管理） |
|
||
| Gitea | `http://113.44.249.175:4000` |
|
||
| 项目目录 | `/www/wwwroot/memo_server/`（后端） |
|
||
| 前端目录 | `/www/wwwroot/memo.fragford.cn/`（前端静态文件） |
|
||
| 对外端口 | **82**（与 echo.fragford.cn 共用） |
|
||
| 访问方式 | `http://113.44.249.175:82` |
|
||
| 备案通过后 | `https://memo.fragford.cn` |
|
||
|
||
---
|
||
|
||
## 二、服务器操作步骤
|
||
|
||
### 2.1 创建 MySQL 数据库（可选，目前使用 SQLite）
|
||
|
||
打开宝塔面板 → 数据库 → 添加数据库：
|
||
|
||
| 项目 | 值 |
|
||
|------|-----|
|
||
| 数据库名 | `fragmemo` |
|
||
| 用户名 | `fragmemo` |
|
||
| 密码 | 自己设一个（记住它后面要用） |
|
||
| 访问权限 | `127.0.0.1`（本地，不要对外开放） |
|
||
|
||
创建后修改 `/www/wwwroot/memo_server/.env` 中的 `DATABASE_URL`：
|
||
```
|
||
DATABASE_URL=mysql+asyncmy://fragmemo:密码@127.0.0.1:3306/fragmemo
|
||
```
|
||
然后重启后端：`systemctl restart memo-server`
|
||
|
||
### 2.2 部署前端
|
||
|
||
本地 Mac 上，一键构建并同步到服务器：
|
||
```bash
|
||
cd /Users/a58/Documents/fragfordspace/fragmemo/memo.fragford.cn
|
||
npm run deploy
|
||
```
|
||
|
||
### 2.3 部署后端
|
||
|
||
本地 Mac 上，一键同步并重启：
|
||
```bash
|
||
cd /Users/a58/Documents/fragfordspace/fragmemo/memo_server
|
||
bash deploy.sh
|
||
```
|
||
|
||
或者手动操作：
|
||
```bash
|
||
# SSH 到服务器
|
||
ssh root@113.44.249.175
|
||
|
||
# 拉取最新代码
|
||
cd /www/wwwroot/memo_server
|
||
git pull
|
||
|
||
# 激活虚拟环境 & 安装依赖
|
||
source venv/bin/activate
|
||
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||
|
||
# 重启
|
||
systemctl restart memo-server
|
||
```
|
||
|
||
### 2.4 查看日志
|
||
```bash
|
||
journalctl -u memo-server -f
|
||
```
|
||
|
||
### 2.5 验证部署
|
||
|
||
浏览器访问 `http://113.44.249.175:82`，你应该能看到 fragmemo 首页。
|
||
|
||
验证 API 是否正常：
|
||
|
||
```bash
|
||
curl http://113.44.249.175:82/api/v1/auth/health
|
||
```
|
||
|
||
---
|
||
|
||
## 三、本地开发日常流程
|
||
|
||
以后你改了代码，部署流程就是：
|
||
|
||
```bash
|
||
# 前端部署（一键）
|
||
cd /Users/a58/Documents/fragfordspace/fragmemo/memo.fragford.cn
|
||
bash deploy.sh
|
||
|
||
# 后端部署（一键）
|
||
cd /Users/a58/Documents/fragfordspace/fragmemo/memo_server
|
||
bash deploy.sh
|
||
```
|
||
|
||
两个脚本都是**独立的 shell 脚本**（不是 npm script），都有：
|
||
- ✅ 分支检查（只能在 main 部署）
|
||
- ✅ 工作区干净检查
|
||
- ✅ 版本信息展示（提交哈希、作者、时间）
|
||
- ✅ 构建/同步过程
|
||
- ✅ 服务器端发布日志记录（DEPLOY_LOG.md）
|
||
- ✅ 部署结果汇总
|
||
|
||
---
|
||
|
||
## 四、ICP 备案通过后（HTTPS + 域名）
|
||
|
||
备案通过后，把 Nginx 配置改为：
|
||
|
||
```nginx
|
||
server {
|
||
listen 443 ssl;
|
||
server_name memo.fragford.cn;
|
||
|
||
ssl_certificate /www/server/panel/vhost/cert/memo.fragford.cn/fullchain.pem;
|
||
ssl_certificate_key /www/server/panel/vhost/cert/memo.fragford.cn/privkey.pem;
|
||
|
||
root /www/wwwroot/memo.fragford.cn;
|
||
index index.html;
|
||
|
||
location /api/ {
|
||
proxy_pass http://127.0.0.1:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||
proxy_set_header X-Forwarded-Proto $scheme;
|
||
}
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.html;
|
||
}
|
||
}
|
||
|
||
server {
|
||
listen 80;
|
||
server_name memo.fragford.cn;
|
||
return 301 https://$host$request_uri;
|
||
}
|
||
```
|
||
|
||
在宝塔面板可以直接申请 Let's Encrypt 免费 SSL 证书。
|
||
|
||
---
|
||
|
||
## 五、常见问题
|
||
|
||
### Q：端口 8000 被占用了？
|
||
在宝塔 Python 项目管理器里改监听端口，或先 `pkill -f uvicorn` 杀掉旧进程。
|
||
|
||
### Q：前端页面空白、接口报错？
|
||
检查 Nginx 配置里 `/api/` 的 proxy_pass 是否正确指向了后端的地址和端口。
|
||
|
||
### Q：数据库连不上？
|
||
确认 `.env` 里的 DATABASE_URL 中的密码、用户名、数据库名都正确。可以先在服务器上用命令行测试：
|
||
```bash
|
||
mysql -u fragmemo -p -h 127.0.0.1
|
||
```
|
||
|
||
### Q：后端启动了但访问 502？
|
||
检查后端是否真的在运行：`curl http://127.0.0.1:8000/health`。如果没运行，去宝塔 Python 项目管理器启动它。
|
||
|
||
### Q：部署后端时 pip install 很慢？
|
||
可以临时换国内镜像：
|
||
```bash
|
||
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||
```
|