134 lines
3.4 KiB
Markdown
134 lines
3.4 KiB
Markdown
# 部署说明
|
||
|
||
本文档介绍如何将KaMiXiTong系统部署到生产环境并通过域名访问。
|
||
|
||
## 域名访问配置
|
||
|
||
### 问题描述
|
||
|
||
在本地开发环境中，系统默认通过 `http://localhost:5000` 访问。当部署到服务器并通过域名访问时，前端页面中的接口调用可能会仍然指向 `localhost:5000`，导致接口调用失败。
|
||
|
||
### 解决方案
|
||
|
||
系统已通过修改前端JavaScript中的 `apiRequest` 函数来自动检测当前访问的主机并构建正确的API调用地址。
|
||
|
||
前端JavaScript现在会使用 `window.location.origin` 来获取当前访问的完整域名，并自动构建完整的API URL。
|
||
|
||
### 配置Nginx反向代理
|
||
|
||
推荐使用Nginx作为反向代理服务器。以下是一个Nginx配置示例：
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
|
||
# 重定向到HTTPS（可选）
|
||
return 301 https://$server_name$request_uri;
|
||
}
|
||
|
||
server {
|
||
listen 443 ssl;
|
||
server_name your-domain.com;
|
||
|
||
# SSL证书配置
|
||
ssl_certificate /path/to/your/certificate.crt;
|
||
ssl_certificate_key /path/to/your/private.key;
|
||
|
||
# 代理到Flask应用
|
||
location / {
|
||
proxy_pass http://127.0.0.1:5000;
|
||
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;
|
||
}
|
||
|
||
# 静态文件直接由Nginx处理
|
||
location /static/ {
|
||
alias /path/to/your/app/static/;
|
||
expires 1y;
|
||
add_header Cache-Control "public, immutable";
|
||
}
|
||
}
|
||
```
|
||
|
||
### 环境变量配置
|
||
|
||
在生产环境中，建议通过环境变量来配置应用：
|
||
|
||
```bash
|
||
# 复制示例配置文件
|
||
cp .env.example .env
|
||
|
||
# 编辑配置文件
|
||
nano .env
|
||
```
|
||
|
||
重要的环境变量包括：
|
||
|
||
- `FLASK_ENV`: 设置为 `production`
|
||
- `SECRET_KEY`: 设置为强随机字符串
|
||
- `DATABASE_URL`: 数据库连接URL
|
||
- `HOST`: 监听地址，生产环境建议设置为 `0.0.0.0`
|
||
|
||
### 使用Gunicorn启动应用
|
||
|
||
在生产环境中，推荐使用Gunicorn作为WSGI服务器：
|
||
|
||
```bash
|
||
# 安装Gunicorn
|
||
pip install gunicorn
|
||
|
||
# 启动应用
|
||
gunicorn -w 4 -b 127.0.0.1:5000 run:app
|
||
```
|
||
|
||
### 使用Systemd管理服务（Linux）
|
||
|
||
创建Systemd服务文件：
|
||
|
||
```ini
|
||
# /etc/systemd/system/kamaxitong.service
|
||
[Unit]
|
||
Description=KaMiXiTong Service
|
||
After=network.target
|
||
|
||
[Service]
|
||
User=www-data
|
||
Group=www-data
|
||
WorkingDirectory=/path/to/your/app
|
||
Environment="FLASK_ENV=production"
|
||
ExecStart=/path/to/your/venv/bin/gunicorn -w 4 -b 127.0.0.1:5000 run:app
|
||
Restart=always
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
启用并启动服务：
|
||
|
||
```bash
|
||
sudo systemctl enable kamaxitong.service
|
||
sudo systemctl start kamaxitong.service
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### Q: 前端页面能正常访问，但API调用失败怎么办？
|
||
|
||
A: 检查以下几点：
|
||
1. 确认Nginx配置正确，特别是 `proxy_set_header` 指令
|
||
2. 确认Flask应用监听地址设置为 `0.0.0.0`
|
||
3. 检查浏览器开发者工具中的网络请求，确认API请求的URL是否正确
|
||
|
||
### Q: 如何确认域名配置是否正确？
|
||
|
||
A: 可以通过以下方式检查：
|
||
1. 在浏览器中打开应用，按F12打开开发者工具
|
||
2. 切换到Network标签页
|
||
3. 刷新页面，观察API请求的URL是否为域名地址而非localhost
|
||
|
||
### Q: 静态文件无法加载怎么办？
|
||
|
||
A: 确保Nginx配置中正确设置了静态文件的location块，或者让Flask应用处理静态文件。 |