.
This commit is contained in:
139
DEPLOY.md
Normal file
139
DEPLOY.md
Normal 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`
|
||||
Reference in New Issue
Block a user