FUXA项目部署全攻略：从Docker到Electron的4种方案

【免费下载链接】FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA

FUXA是一款强大的Web-based Process Visualization（SCADA/HMI/Dashboard）软件，能够帮助用户创建现代化的过程可视化界面，实现机器状态监控和实时数据展示。本文将详细介绍4种实用的FUXA部署方案，无论你是新手还是有经验的开发者，都能找到适合自己的部署方式。

🚀 方案一：Docker容器化部署（推荐新手）

Docker部署是最简单快捷的方式，无需复杂配置即可快速启动FUXA服务。

基础部署命令

docker pull frangoteam/fuxa:latest
docker run -d -p 1881:1881 frangoteam/fuxa:latest

持久化存储配置

为确保项目数据、历史记录和日志不会丢失，建议使用持久化存储：

docker run -d -p 1881:1881 \
  -v fuxa_appdata:/usr/src/app/FUXA/server/_appdata \
  -v fuxa_db:/usr/src/app/FUXA/server/_db \
  -v fuxa_logs:/usr/src/app/FUXA/server/_logs \
  -v fuxa_images:/usr/src/app/FUXA/server/_images \
  frangoteam/fuxa:latest

Docker Compose部署

项目提供了便捷的compose.yml配置文件，只需：

git clone https://gitcode.com/gh_mirrors/fu/FUXA
cd FUXA
docker compose up -d

docker-compose会自动创建本地目录映射，将数据存储在当前目录的appdata、db、logs和images文件夹中。

启动后，打开浏览器访问 http://localhost:1881 即可使用FUXA。首次登录可使用默认账号密码（admin/admin）。

FUXA首页界面展示，直观的项目管理和快速访问功能

🛠️ 方案二：源码编译部署（适合开发者）

如果你需要自定义功能或参与开发，源码部署是最佳选择。

环境准备

• Node.js 18 LTS（推荐版本，14及以下不支持）
• Git

编译步骤

git clone https://gitcode.com/gh_mirrors/fu/FUXA
cd FUXA/server
npm install
npm start

注意事项

在Linux系统（特别是树莓派）上，可能需要额外的构建工具。如果不需要特定功能，可以移除相关依赖：

• 不需要西门子S7通信：删除package.json中的"node-snap7"
• 不需要外部数据库连接：删除package.json中的"odbc"

启动成功后，同样通过 http://localhost:1881 访问系统。

FUXA可视化编辑器界面，支持拖拽式设计和实时预览

📦 方案三：NPM快速安装（适合快速测试）

通过NPM可以直接全局安装FUXA，适合快速体验或作为依赖集成到其他项目中。

标准安装

npm install -g --unsafe-perm @frangoteam/fuxa
fuxa

轻量版安装

如果不需要西门子PLC通信功能，可以安装轻量版：

npm install -g --unsafe-perm @frangoteam/fuxa-min
fuxa

⚠️ 注意：在Node.js 18的Linux环境中，安装可能会遇到一些挑战，建议优先考虑Docker方案或源码部署。

💻 方案四：Electron桌面应用（适合本地使用）

FUXA提供了Electron打包版本，可以作为桌面应用运行，无需单独安装浏览器。

预构建版本

从项目的GitHub Actions页面下载对应系统的预构建包：

• 支持Windows、macOS和Linux系统
• 包含x64和arm64架构版本

手动构建

如果需要自定义Electron版本，可以手动构建：

git clone https://gitcode.com/gh_mirrors/fu/FUXA
cd FUXA/app/electron
npm install
npm run dist

构建后的文件将保存在dist目录下，根据目标系统选择相应的安装包。

FUXA设备配置界面，支持多种工业协议和设备类型

📝 部署后访问与验证

无论采用哪种部署方式，成功启动后都可以通过以下方式验证：

1. 打开浏览器访问 http://localhost:1881
2. 使用默认账号admin/admin登录
3. 创建测试项目并添加设备标签
4. 设计简单的可视化界面并测试数据连接

⚙️ 常见问题解决

端口冲突

如果1881端口被占用，可以通过环境变量修改默认端口：

# Docker方式
docker run -d -p 8080:1881 frangoteam/fuxa:latest

# 源码方式
PORT=8080 npm start

权限问题

Linux系统中可能需要管理员权限运行，或调整相关目录权限：

sudo chmod -R 777 server/_appdata server/_db server/_logs server/_images

性能优化

对于大规模项目，建议：

• 使用专用数据库存储历史数据
• 优化标签更新频率
• 启用缓存机制

通过本文介绍的四种部署方案，你可以根据实际需求选择最适合的方式来部署FUXA。无论是快速体验、开发定制还是生产环境部署，FUXA都提供了灵活的解决方案。开始你的工业可视化之旅吧！

【免费下载链接】FUXA Web-based Process Visualization (SCADA/HMI/Dashboard) software 项目地址: https://gitcode.com/gh_mirrors/fu/FUXA