This commit is contained in:
2026-01-22 18:31:30 +08:00
commit d703ac3574
46 changed files with 7751 additions and 0 deletions

139
DEPLOY.md Normal file
View File

@@ -0,0 +1,139 @@
# 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
```
---
## 🚀 三种部署方式
### 方式一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`
---
## 📞 需要帮助?
- 查看详细配置:`nginx.conf.example`
- 项目说明:`README.md`
- 模块化文档:`src/js/README.md`