flux-web/DEPLOY.md

flux-web 部署指南

本项目无需编译，可直接部署源码。

📝 部署前准备

1. 修改 API 地址

编辑 src/js/config/api.config.js：

BASE_URL: 'https://your-api-domain.com',  // 改成你的API地址

2. 关闭调试模式

编辑 src/js/config/app.config.js：

ENABLED: false,  // 改成 false

3. 配置极光域名白名单（如果使用一键登录功能）

如果使用极光一键登录功能，需要在极光控制台配置域名白名单：

1. 登录极光控制台：https://www.jiguang.cn/
2. 进入应用管理 → 选择应用 → 一键登录配置
3. 在"Web端配置"中添加允许的域名（如：abc.1216.top）
4. 保存配置并等待生效（通常几分钟内）

注意：如果不配置域名白名单，会出现跨域错误，一键登录功能将无法使用。

详细说明请参考：docs/cors-issue-fix.md

---

🚀 三种部署方式

方式一：Nginx 部署（推荐）

第1步：上传文件

# 上传到服务器
/var/www/flux-web/

第2步：创建配置文件

# 复制示例配置
cp nginx.conf.example /etc/nginx/sites-available/flux-web

# 修改配置中的域名和路径
vim /etc/nginx/sites-available/flux-web

第3步：启用站点

# 创建软链接
ln -s /etc/nginx/sites-available/flux-web /etc/nginx/sites-enabled/

# 测试配置
nginx -t

# 重载
systemctl reload nginx

第4步：配置 HTTPS（可选）

# 安装 certbot
apt install certbot python3-certbot-nginx

# 获取证书
certbot --nginx -d your-domain.com

---

方式二：Node.js 服务器

# 安装 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）

---

🔄 更新项目

# 备份
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