Add mkdocs documentations
This commit is contained in:
95
docs/content/deployment.md
Normal file
95
docs/content/deployment.md
Normal file
@@ -0,0 +1,95 @@
|
||||
# 部署指南
|
||||
|
||||
## 方式一:Docker 部署(推荐)
|
||||
|
||||
### 1. 构建镜像
|
||||
|
||||
```bash
|
||||
docker build -t ai-video-assistant-web ./web
|
||||
```
|
||||
|
||||
### 2. 运行容器
|
||||
|
||||
```bash
|
||||
docker run -d \
|
||||
--name ai-assistant-web \
|
||||
-p 3000:80 \
|
||||
ai-video-assistant-web
|
||||
```
|
||||
|
||||
### 3. 使用 Docker Compose
|
||||
|
||||
```yaml
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
web:
|
||||
build: ./web
|
||||
ports:
|
||||
- "3000:80"
|
||||
environment:
|
||||
- VITE_API_URL=http://api:8080
|
||||
```
|
||||
|
||||
运行:
|
||||
```bash
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
## 方式二:Nginx 部署
|
||||
|
||||
### 1. 构建前端
|
||||
|
||||
```bash
|
||||
cd web
|
||||
npm run build
|
||||
```
|
||||
|
||||
### 2. 配置 Nginx
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
root /var/www/ai-assistant/dist;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /api {
|
||||
proxy_pass http://localhost:8080;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 启动 Nginx
|
||||
|
||||
```bash
|
||||
sudo nginx -t
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
## 环境变量配置
|
||||
|
||||
| 变量 | 说明 | 默认值 |
|
||||
|------|------|--------|
|
||||
| VITE_API_URL | 后端 API 地址 | http://localhost:8080 |
|
||||
| VITE_GEMINI_API_KEY | Gemini API Key | - |
|
||||
|
||||
## 验证部署
|
||||
|
||||
1. 访问 http://your-domain.com
|
||||
2. 检查页面是否正常加载
|
||||
3. 验证各功能模块是否可用
|
||||
|
||||
## 故障排查
|
||||
|
||||
| 问题 | 解决方案 |
|
||||
|------|---------|
|
||||
| 页面空白 | 检查浏览器控制台错误 |
|
||||
| API 请求失败 | 确认 VITE_API_URL 配置正确 |
|
||||
| 静态资源 404 | 检查 nginx try_files 配置 |
|
||||
Reference in New Issue
Block a user