当前位置：首页 > news >正文

Flowise生产就绪指南：Health Check+自动重启+日志轮转配置

news 2026/4/16 10:13:55

Flowise生产就绪指南：Health Check+自动重启+日志轮转配置

1. 为什么需要生产环境配置？

当你用Flowise搭建好AI工作流后，接下来最重要的一步就是确保它能在生产环境中稳定运行。想象一下：你的客服机器人正在处理客户咨询，突然服务崩溃了，或者日志文件把磁盘塞满了导致系统卡死——这些都是生产环境中真实会发生的问题。

Flowise本身是个很棒的可视化AI工作流工具，让你不用写代码就能搭建智能应用。但官方文档主要关注功能使用，对于生产环境的稳定性保障说得不多。这就是今天要解决的问题：让你的Flowise应用像专业软件一样可靠。

我们将重点解决三个核心生产问题：

健康检查：实时监控服务是否正常活着
自动恢复：服务挂了能自己爬起来继续工作
日志管理：避免日志文件无限膨胀拖垮系统

2. 健康检查配置：时刻掌握服务状态

健康检查就像是给Flowise安装了一个"心跳监测器"，让你随时知道服务是否健康。

2.1 基础健康检查端点

Flowise内置了健康检查接口，只需要在浏览器或监控工具中访问：

# 检查API服务状态 curl http://localhost:3000/api/v1/health-check # 检查数据库连接状态（如果配置了数据库） curl http://localhost:3000/api/v1/health-check-db

正常情况会返回：

{ "status": "OK", "timestamp": "2024-01-15T10:30:00.000Z" }

2.2 使用Docker的健康检查

如果你用Docker部署，可以在docker-compose.yml中添加健康检查配置：

version: '3.8' services: flowise: image: flowiseai/flowise ports: - "3000:3000" environment: - DATABASE_TYPE=postgres - DATABASE_URL=postgresql://user:pass@db:5432/flowise healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3000/api/v1/health-check"] interval: 30s timeout: 10s retries: 3 start_period: 40s

这样Docker会自动监控服务状态，你还可以用docker ps查看健康状态。

2.3 集成监控系统

对于正式的生产环境，建议集成专业的监控系统：

# Prometheus监控配置示例 # 在Flowise启动命令中添加监控端点 pnpm start --metrics

然后在Prometheus的配置文件中添加：

scrape_configs: - job_name: 'flowise' static_configs: - targets: ['localhost:3000'] metrics_path: '/metrics'

3. 自动重启策略：服务挂了自动恢复

即使是最稳定的服务也可能意外崩溃，关键是要能自动恢复。

3.1 使用PM2进程管理

PM2是Node.js应用的最佳进程管理工具，安装配置都很简单：

# 全局安装PM2 npm install -g pm2 # 使用PM2启动Flowise pm2 start "pnpm start" --name flowise # 设置开机自启动 pm2 startup pm2 save

PM2的配置文件（ecosystem.config.js）可以更精细控制：

module.exports = { apps: [{ name: 'flowise', script: 'pnpm', args: 'start', instances: 'max', exec_mode: 'cluster', env: { NODE_ENV: 'production', PORT: 3000 }, max_memory_restart: '1G', watch: false, autorestart: true, restart_delay: 3000 }] }

3.2 Docker重启策略

如果使用Docker部署，可以在docker run命令中添加重启策略：

docker run -d \ --name flowise \ --restart unless-stopped \ -p 3000:3000 \ flowiseai/flowise

或者在docker-compose.yml中配置：

services: flowise: image: flowiseai/flowise restart: unless-stopped ports: - "3000:3000"

unless-stopped策略意味着除非你手动停止容器，否则Docker会在任何情况下自动重启它。

3.3 系统级监控脚本

对于更复杂的环境，可以编写监控脚本：

#!/bin/bash # flowise-monitor.sh SERVICE_URL="http://localhost:3000/api/v1/health-check" MAX_RETRIES=3 RETRY_DELAY=5 check_service() { response=$(curl -s -o /dev/null -w "%{http_code}" $SERVICE_URL) if [ "$response" -eq 200 ]; then echo "Flowise is running normally" return 0 else echo "Flowise is down, response code: $response" return 1 fi } restart_service() { echo "Restarting Flowise service..." pm2 restart flowise } # 主监控循环 while true; do if check_service; then sleep 60 # 检查通过，等待60秒再检查 else attempt=1 while [ $attempt -le $MAX_RETRIES ]; do echo "Attempt $attempt to restart service..." restart_service sleep $RETRY_DELAY if check_service; then echo "Service restored successfully" break fi attempt=$((attempt + 1)) done fi done

4. 日志轮转配置：避免磁盘被撑爆

Flowise运行久了会产生大量日志，如果不加管理很快就会占满磁盘空间。

4.1 PM2日志管理

如果你用PM2管理Flowise，它自带了日志轮转功能：

# 安装PM2日志轮转模块 pm2 install pm2-logrotate # 配置日志轮转 pm2 set pm2-logrotate:max_size 10M # 单个日志文件最大10MB pm2 set pm2-logrotate:retain 30 # 保留30个备份文件 pm2 set pm2-logrotate:compress true # 压缩旧日志 pm2 set pm2-logrotate:rotateInterval '0 0 * * *' # 每天轮转一次

4.2 使用Linux的logrotate

对于系统级日志管理，可以使用Linux自带的logrotate：

创建配置文件/etc/logrotate.d/flowise：

/var/log/flowise/*.log { daily missingok rotate 30 compress delaycompress notifempty copytruncate size 10M create 644 root root }

4.3 Docker日志配置

如果使用Docker，可以配置日志驱动和轮转：

docker run -d \ --name flowise \ --log-driver json-file \ --log-opt max-size=10m \ --log-opt max-file=3 \ -p 3000:3000 \ flowiseai/flowise

或者在docker-compose.yml中配置：

services: flowise: image: flowiseai/flowise ports: - "3000:3000" logging: driver: "json-file" options: max-size: "10m" max-file: "3"

5. 完整生产环境部署示例

把所有的配置整合起来，这里是一个完整的生产环境部署方案：

5.1 目录结构

/opt/flowise/ ├── app/ # Flowise应用目录 ├── logs/ # 日志目录 ├── scripts/ # 维护脚本 │ └── monitor.sh └── docker-compose.yml # Docker配置

5.2 Docker Compose完整配置

version: '3.8' services: flowise: image: flowiseai/flowise:latest container_name: flowise restart: unless-stopped ports: - "3000:3000" environment: - PORT=3000 - FLOWISE_USERNAME=admin - FLOWISE_PASSWORD=your_secure_password - DATABASE_TYPE=postgres - DATABASE_URL=postgresql://flowise:password@db:5432/flowise - LOG_LEVEL=info - LOG_PATH=/app/logs volumes: - ./app:/app - ./logs:/app/logs - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro logging: driver: "json-file" options: max-size: "10m" max-file: "3" healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3000/api/v1/health-check"] interval: 30s timeout: 10s retries: 3 start_period: 60s depends_on: db: condition: service_healthy db: image: postgres:13 container_name: flowise-db restart: unless-stopped environment: - POSTGRES_USER=flowise - POSTGRES_PASSWORD=your_secure_db_password - POSTGRES_DB=flowise volumes: - postgres_data:/var/lib/postgresql/data - ./logs/db:/var/log/postgresql healthcheck: test: ["CMD-SHELL", "pg_isready -U flowise"] interval: 30s timeout: 10s retries: 5 start_period: 40s logging: driver: "json-file" options: max-size: "10m" max-file: "3" volumes: postgres_data:

5.3 部署和启动脚本

创建部署脚本deploy.sh：

#!/bin/bash # Flowise生产环境部署脚本 echo "开始部署Flowise生产环境..." # 创建目录结构 mkdir -p /opt/flowise/{app,logs,scripts,backups} # 复制配置文件 cp docker-compose.yml /opt/flowise/ cp monitor.sh /opt/flowise/scripts/ # 设置权限 chmod +x /opt/flowise/scripts/*.sh chown -R www-data:www-data /opt/flowise # 启动服务 cd /opt/flowise docker-compose up -d echo "部署完成！" echo "服务地址: http://your-server-ip:3000" echo "检查服务状态: docker-compose logs -f flowise"

6. 监控和维护建议

6.1 日常监控命令

# 查看服务状态 docker-compose ps # 查看实时日志 docker-compose logs -f flowise # 查看资源使用情况 docker stats flowise # 检查健康状态 curl http://localhost:3000/api/v1/health-check