flnxi-Wu/flnxi-agent

FLNXI Agent

FLNXI 素材系统安装助手,用于在 NAS(飞牛 fnOS、群晖等)上一键安装素材系统。

功能

  • 🚀 一键安装素材系统及所有依赖
  • 📊 实时安装进度显示
  • 🔄 系统更新和回滚
  • 📈 系统状态监控
  • 📝 日志查看

使用方法

Docker 安装(推荐)

docker run -d \
  --name flnxi-agent \
  -p 3080:3080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  flnxi/flnxi-agent:latest

然后访问 http://your-nas-ip:3080 开始安装。

本地开发

# 安装依赖
npm install
cd frontend && npm install && cd ..

# 开发模式
npm run dev

# 构建
npm run build

环境变量

变量 说明 默认值
PORT Agent 服务端口 3080
LICENSE_SERVER_URL 许可证服务器地址 http://45.249.208.118:3001

架构

flnxi-agent/
├── src/                  # 后端代码
│   ├── server.ts         # Express 服务
│   ├── installer.ts      # 安装逻辑
│   └── system-manager.ts # 系统管理
├── frontend/             # 前端代码 (React + Vite)
│   └── src/
│       ├── App.tsx
│       └── pages/
│           ├── Welcome.tsx
│           ├── Config.tsx
│           ├── Installing.tsx
│           ├── Complete.tsx
│           └── Dashboard.tsx
└── Dockerfile            # 多架构构建