156 lines
2.9 KiB
Markdown
156 lines
2.9 KiB
Markdown
# flux-web 部署指南
|
||
|
||
本项目**无需编译**，可直接部署源码。
|
||
|
||
## 📝 部署前准备
|
||
|
||
### 1. 修改 API 地址
|
||
|
||
编辑 `src/js/config/api.config.js`：
|
||
|
||
```javascript
|
||
BASE_URL: 'https://your-api-domain.com', // 改成你的API地址
|
||
```
|
||
|
||
### 2. 关闭调试模式
|
||
|
||
编辑 `src/js/config/app.config.js`：
|
||
|
||
```javascript
|
||
ENABLED: false, // 改成 false
|
||
```
|
||
|
||
### 3. 配置极光域名白名单（如果使用一键登录功能）
|
||
|
||
如果使用极光一键登录功能，需要在极光控制台配置域名白名单：
|
||
|
||
1. 登录极光控制台：https://www.jiguang.cn/
|
||
2. 进入应用管理 → 选择应用 → 一键登录配置
|
||
3. 在"Web端配置"中添加允许的域名（如：`abc.1216.top`）
|
||
4. 保存配置并等待生效（通常几分钟内）
|
||
|
||
**注意**：如果不配置域名白名单，会出现跨域错误，一键登录功能将无法使用。
|
||
|
||
详细说明请参考：`docs/cors-issue-fix.md`
|
||
|
||
---
|
||
|
||
## 🚀 三种部署方式
|
||
|
||
### 方式一：Nginx 部署（推荐）
|
||
|
||
**第1步：上传文件**
|
||
|
||
```bash
|
||
# 上传到服务器
|
||
/var/www/flux-web/
|
||
```
|
||
|
||
**第2步：创建配置文件**
|
||
|
||
```bash
|
||
# 复制示例配置
|
||
cp nginx.conf.example /etc/nginx/sites-available/flux-web
|
||
|
||
# 修改配置中的域名和路径
|
||
vim /etc/nginx/sites-available/flux-web
|
||
```
|
||
|
||
**第3步：启用站点**
|
||
|
||
```bash
|
||
# 创建软链接
|
||
ln -s /etc/nginx/sites-available/flux-web /etc/nginx/sites-enabled/
|
||
|
||
# 测试配置
|
||
nginx -t
|
||
|
||
# 重载
|
||
systemctl reload nginx
|
||
```
|
||
|
||
**第4步：配置 HTTPS（可选）**
|
||
|
||
```bash
|
||
# 安装 certbot
|
||
apt install certbot python3-certbot-nginx
|
||
|
||
# 获取证书
|
||
certbot --nginx -d your-domain.com
|
||
```
|
||
|
||
---
|
||
|
||
### 方式二：Node.js 服务器
|
||
|
||
```bash
|
||
# 安装 PM2
|
||
npm install -g pm2
|
||
|
||
# 启动服务
|
||
pm2 start server.js --name flux-web
|
||
|
||
# 设置开机自启
|
||
pm2 startup
|
||
pm2 save
|
||
```
|
||
|
||
---
|
||
|
||
### 方式三：对象存储 + CDN
|
||
|
||
适合阿里云 OSS、腾讯云 COS 等：
|
||
|
||
1. 在控制台上传整个 `flux-web` 目录
|
||
2. 配置 CDN 加速
|
||
3. 绑定自定义域名
|
||
|
||
---
|
||
|
||
## ✅ 部署后检查
|
||
|
||
访问你的域名，确认：
|
||
|
||
- ✓ 页面正常显示
|
||
- ✓ 样式加载正常
|
||
- ✓ 浏览器控制台无报错
|
||
- ✓ API 请求成功（F12 查看 Network）
|
||
|
||
---
|
||
|
||
## 🔄 更新项目
|
||
|
||
```bash
|
||
# 备份
|
||
cp -r /var/www/flux-web /var/www/flux-web.backup
|
||
|
||
# 上传新文件覆盖即可
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
**Q: 页面空白？**
|
||
A: 检查浏览器控制台（F12）查看报错信息
|
||
|
||
**Q: API 请求失败？**
|
||
A: 检查 `src/js/config/api.config.js` 中的 API 地址是否正确
|
||
|
||
**Q: 静态资源 404？**
|
||
A: 确认 `static/` 和 `src/` 目录都已上传
|
||
|
||
**Q: 如何清除缓存？**
|
||
A: 修改 `index.html` 中 CSS/JS 引用，加版本号：`style.css?v=2`
|
||
|
||
**Q: 极光一键登录出现跨域错误？**
|
||
A: 需要在极光控制台配置域名白名单，详细说明请参考 `docs/cors-issue-fix.md`
|
||
|
||
---
|
||
|
||
## 📞 需要帮助？
|
||
|
||
- 查看详细配置：`nginx.conf.example`
|
||
- 项目说明：`README.md`
|
||
- 模块化文档：`src/js/README.md`
|