Files
flux-web/DEPLOY.md
2026-01-22 18:31:30 +08:00

2.2 KiB
Raw Blame History

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

🚀 三种部署方式

方式一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


📞 需要帮助?

  • 查看详细配置:nginx.conf.example
  • 项目说明:README.md
  • 模块化文档:src/js/README.md