Skip to content

refly-docker.md

Latest commit

 

History

History
271 lines (186 loc) · 9.74 KB

refly-docker.md

File metadata and controls

271 lines (186 loc) · 9.74 KB

refly Docker 容器化部署指南

refly Docker 容器化部署指南

分类: Docker,refly | 标签: refly,docker,部署教程 | 发布时间: 2025-12-10 08:14:46

REFLY-WEB是Refly.AI平台的前端Web界面组件，旨在为用户提供直观的可视化画布和交互界面，支持通过零代码方式构建、管理和分享AI自动化工作流。该组件具备拖拽式工作流构建、实时执行监控、多设备响应式设计等核心特性，需与reflyai/refly-api后端服务配合使用，共同构成完整的Refly.AI平台。

概述

REFLY-WEB是Refly.AI平台的前端Web界面组件，旨在为用户提供直观的可视化画布和交互界面，支持通过零代码方式构建、管理和分享AI自动化工作流。该组件具备拖拽式工作流构建、实时执行监控、多设备响应式设计等核心特性，需与reflyai/refly-api后端服务配合使用，共同构成完整的Refly.AI平台。

通过Docker容器化部署REFLY-WEB，可实现环境一致性、快速部署和版本隔离，适用于开发、测试及生产环境。本文将详细介绍REFLY-WEB的Docker部署流程，包括环境准备、镜像拉取、容器配置、功能验证及生产环境优化建议。

环境准备

Docker环境安装

REFLY-WEB基于Docker容器化部署，需先确保目标服务器已安装Docker环境。推荐使用以下一键安装脚本快速部署Docker及相关组件（适用于Linux系统）：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

执行完成后，可通过docker --version命令验证安装结果，确保Docker服务正常运行：

docker --version  # 示例输出：Docker version 24.0.7, build afdd53b
systemctl status docker  # 确认服务状态为active (running)

镜像准备

拉取REFLY-WEB镜像

使用以下命令通过轩辕镜像访问支持地址拉取最新版本的REFLY-WEB镜像：

docker pull xxx.xuanyuan.run/reflyai/refly-web:latest

拉取完成后，可通过docker images命令查看本地镜像列表，确认镜像已成功下载：

docker images | grep reflyai/refly-web
# 示例输出：
# xxx.xuanyuan.run/reflyai/refly-web   latest    abc12345   2 weeks ago   1.2GB

容器部署

基础部署命令

REFLY-WEB作为前端组件，需与reflyai/refly-api后端服务配合使用。以下是基础的单容器部署命令（独立部署时仅用于前端演示，生产环境需配合API服务）：

docker run -d \
  --name refly-web \
  -p 3000:3000 \
  -e API_URL=http://refly-api:8000 \  # 替换为实际API服务地址
  -e PUBLIC_URL=http://localhost:3000 \  # 替换为Web应用访问地址
  xxx.xuanyuan.run/reflyai/refly-web:latest

参数说明：

  • -d：后台运行容器
  • --name refly-web：指定容器名称为refly-web，便于后续管理
  • -p 3000:3000：端口映射（主机端口:容器端口），默认容器内端口为3000（实际端口请参考官方文档确认）
  • -e API_URL：设置后端API服务地址，必填项，用于前后端通信
  • -e PUBLIC_URL：设置Web应用的公共访问地址，影响资源加载路径

与API服务协同部署（推荐）

在生产环境中，建议使用Docker Compose编排REFLY-WEB与API服务。创建docker-compose.yml文件：

version: '3.8'

services:
  refly-api:
    image: xxx.xuanyuan.run/reflyai/refly-api:latest
    container_name: refly-api
    restart: always
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/refly  # 替换为实际数据库连接信息
      - SECRET_KEY=your_api_secret_key  # 替换为安全的密钥
    # 其他API服务配置（如端口、 volumes等）

  refly-web:
    image: xxx.xuanyuan.run/reflyai/refly-web:latest
    container_name: refly-web
    restart: always
    ports:
      - "3000:3000"  # 根据官方文档确认实际端口
    environment:
      - API_URL=http://refly-api:8000  # 与API服务容器名和端口对应
      - PUBLIC_URL=https://refly.yourdomain.com  # 替换为实际域名
      - ENABLE_ANALYTICS=false  # 可选，是否启用分析功能
    depends_on:
      - refly-api  # 确保API服务先启动

使用以下命令启动服务：

docker-compose up -d

功能测试

服务可用性验证

  1. 访问Web界面
    通过浏览器访问http://服务器IP:3000（或配置的PUBLIC_URL），若页面正常加载，显示REFLY-WEB的可视化画布界面，则前端服务部署成功。

  2. 容器状态检查
    使用docker ps命令查看容器运行状态，确保状态为Up：

    docker ps | grep refly-web
# 示例输出：
# abc123456789   xxx.xuanyuan.run/reflyai/refly-web:latest   "npm start"   5 minutes ago   Up 5 minutes   0.0.0.0:3000->3000/tcp   refly-web

  3. 日志查看
    通过容器日志确认服务启动过程无错误：

    docker logs refly-web
# 正常启动示例日志：
# > refly-web@1.0.0 start
# > next start
# ready - started server on 0.0.0.0:3000, url: http://localhost:3000

核心功能测试

  1. 画布操作测试
    在Web界面中尝试拖拽节点、连接工作流，验证可视化编辑功能是否正常。

  2. API连接测试
    若已部署API服务，可在Web界面中创建简单工作流并执行，检查是否能正常调用API服务（通过API服务日志辅助确认）。

生产环境建议

安全加固

  1. 环境变量管理
    敏感配置（如API密钥）避免直接写在命令或Compose文件中，建议使用环境变量文件或Docker Secrets：

    # 创建.env文件
echo "API_URL=https://api.refly.yourdomain.com" > .env
echo "SECRET_KEY=$(openssl rand -hex 32)" >> .env

# 在docker run中引用
docker run -d --name refly-web --env-file .env ...

  2. 端口与网络隔离

    • 生产环境建议使用反向代理（如Nginx）转发请求，而非直接暴露容器端口到公网
    • 通过Docker网络隔离服务，仅允许必要端口通信：
    # docker-compose.yml中定义网络
networks:
  refly-network:
    driver: bridge

services:
  refly-web:
    networks:
      - refly-network
  refly-api:
    networks:
      - refly-network

持久化与备份

  1. 配置文件持久化
    若需自定义前端配置（如主题、语言包），可将配置目录挂载到主机：

    docker run -d ... -v /path/on/host:/app/config xxx.xuanyuan.run/reflyai/refly-web:latest

  2. 定期备份
    对重要配置和用户数据（通常存储在后端数据库中）进行定期备份，配合API服务的数据库备份策略执行。

性能优化

  1. 资源限制
    根据服务器配置限制容器资源使用，避免资源耗尽：

    docker run -d ... --memory=2g --cpus=1 xxx.xuanyuan.run/reflyai/refly-web:latest

  2. 静态资源加速
    将前端静态资源（JS、CSS、图片）部署到CDN，通过PUBLIC_URL指向CDN地址，提升访问访问表现。

故障排查

常见问题解决

  1. 容器启动后无法访问

    • 检查端口映射是否正确：docker port refly-web
    • 检查主机防火墙规则：ufw status（或对应系统防火墙命令）
    • 查看容器日志定位错误：docker logs refly-web

  2. API连接失败

    • 确认API_URL配置正确，且API服务已正常启动：curl http://refly-api:8000/health
    • 检查网络连通性：在Web容器内执行ping refly-api（需安装ping工具：docker exec -it refly-web apt-get install iputils-ping）

  3. 页面加载异常

    • 检查PUBLIC_URL是否与访问地址一致，避免跨域或资源路径错误
    • 清除浏览器缓存或使用无痕模式测试

日志与监控

  1. 查看实时日志

    docker logs -f refly-web  # -f参数实时跟踪日志输出

  2. 容器状态监控
    使用docker stats命令监控容器资源使用情况：

    docker stats refly-web

  3. 集成监控工具
    生产环境可集成Prometheus+Grafana或ELK栈，通过容器日志和指标进行全面监控。

参考资源

总结

本文详细介绍了REFLY-WEB的Docker容器化部署方案，包括环境准备、镜像拉取、容器配置、功能测试及生产环境优化建议。通过Docker部署，可快速搭建REFLY-WEB前端服务，并与后端API协同工作，实现零代码AI工作流构建平台的完整功能。

关键要点：

  • 使用一键脚本bash <(wget -qO- https://xuanyuan.cloud/docker.sh)快速部署Docker环境
  • 通过轩辕镜像访问支持地址xxx.xuanyuan.run/reflyai/refly-web:latest拉取镜像，提升下载效率
  • 必须配置API_URL环境变量以连接后端服务，确保前后端通信正常
  • 生产环境建议使用Docker Compose编排服务，配合网络隔离和资源限制增强安全性

后续建议：

  • 参考REFLY-WEB镜像文档（轩辕）获取更多配置参数和高级特性
  • 深入学习Refly.AI平台的工作流设计功能，结合业务需求创建自动化场景
  • 定期关注镜像标签列表，及时更新镜像版本以获取新功能和安全修复
  • 针对大规模部署场景，考虑使用Kubernetes进行容器编排和管理，提升服务可用性和扩展性
⚡