# 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`