## 部署与上线指南

本文记录 shudao-chat 项目前后端在生产环境的标准交付流程，包括 Vue 前端打包、产物合入 Go 服务、Linux 下编译后端以及上传、运行服务的步骤。

---

### 1. 前端（Vue 3 + Vite）打包

**环境准备**
- Node.js ≥ 20.19（建议与 `package.json` 中的 engines 保持一致）
- npm（或 pnpm / yarn，以下以 npm 为例）
- 在国内网络可替换源：`npm config set registry https://registry.npmmirror.com`

**打包流程**
```bash
cd /path/to/shudao-chat（前端根目录）
npm install
npm run build
```

执行完成后会在根目录生成 `dist/`，结构类似：
```
dist/
  index.html
  assets/
    *.js
    *.css
    ...
```

### 2. 将前端产物放入 `shudao-chat-go`

1. 备份旧版本（可选）：
   ```bash
   cd shudao-chat-go
   mv views/index.html views/index_$(date +%Y%m%d%H%M%S).html
   mv assets assets_$(date +%Y%m%d%H%M%S)
   ```
2. 拷贝新的 `dist` 产物：
   ```bash
   # 回到前端根目录
   cp dist/index.html shudao-chat-go/views/
   rsync -av --delete dist/assets/ shudao-chat-go/assets/
   ```
   - `views/index.html` 会被 `controllers/frontend.go` 用作模版。
   - `assets/` 目录被 `main.go` 中的 `beego.SetStaticPath("/assets", "assets")` 映射，前端静态资源必须放在这里。
3. 若有 `dist` 中的其他静态目录（如 `public` 下复制出的 favicon 等），放入 `shudao-chat-go/static/`，Beego 已映射 `/static` 路径。

### 3. 在本地编译 Linux 版后端

**环境要求**
- Go 1.24+（与 `go.mod` 中声明一致）
- 已配置好 GOPROXY（如国内：`https://goproxy.cn,direct`）

**编译命令**
```bash
cd shudao-chat-go
go mod download
GOOS=linux GOARCH=amd64 go build -o bin/shudao-chat-go ./main.go

或者安装bee框架：(go env -w GOPROXY=https://goproxy.cn)//如果下面命令安装不成功先执行这条命令
go install github.com/beego/bee/v2@latest
然后运行：bee pack -be GOOS=linux
```

输出文件：压缩包：shudao-chat-go.tar.gz

### 4. 打包并上传到服务器

**上传方式（示例）**
```bash
压缩包拖入/tmp/tmp
```

### 5. 服务器部署与运行
- cd /tmp
- cd tmp
- tar xvf shudao-chat-go.tar.gz
- chmod +x shudao-chat-go
- 找到进程：ps -ef | grep shudao-chat-go
- 杀死进程：kill -9 1029395   # 将 12345 替换为你找到的实际PID
- nohup ./shudao-chat-go & tail -f nohup.out #查看实时状态


---