Refly AI 安装配置指南：从部署到创作的完整路径

一、核心价值：让AI创作像搭积木一样简单

Refly AI 是一款开源的AI原生创作引擎，通过直观的画布界面，让你轻松将想法转化为交互式内容。它就像一个智能工作室，既可以同时处理多个创作任务（多线程对话），又能记住你的创作思路（上下文记忆），还能直接生成网页、图表等可交互作品（代码工件生成）。

图1：Refly AI 工作界面，显示工作流创建入口和示例任务

二、环境准备：为你的AI创作引擎铺路

2.1 系统配置要求

配置项	最低配置	推荐配置	差异说明
CPU	2核	4核及以上	推荐配置可提升多任务处理速度30%+
内存	4GB	8GB及以上	复杂工作流需16GB内存支持
硬盘	20GB可用空间	50GB SSD	SSD可减少Docker镜像加载时间
网络	基础网络连接	稳定宽带	首次部署需下载约3GB镜像

2.2 必备工具安装

你需要先安装以下工具：

🔧 Docker与Docker Compose

# Ubuntu/Debian系统
sudo apt update && sudo apt install -y docker.io docker-compose
# 启动Docker服务
sudo systemctl enable --now docker
# 将当前用户加入docker组（避免每次使用sudo）
sudo usermod -aG docker $USER

常见问题：Docker命令权限不足

如果执行docker命令时提示权限错误，可尝试注销并重新登录，或执行 newgrp docker 使权限生效。

🔧 Git版本控制工具

# Ubuntu/Debian系统
sudo apt install -y git
# 验证安装
git --version

三、极速部署：两种路径任你选

3.1 基础版（3步完成部署）

这种方式适合快速体验，所有配置使用默认值：

🔧 第1步：获取项目代码

git clone https://gitcode.com/GitHub_Trending/re/refly
cd refly

🔧 第2步：配置环境变量

# 复制环境变量模板
cp apps/api/.env.example apps/api/.env
# 无需修改，使用默认配置即可快速启动

🔧 第3步：启动服务

cd deploy/docker
docker compose up -d

常见问题：启动后无法访问

1. 检查容器状态：docker compose ps确保所有服务都处于"Up"状态
2. 查看日志排查问题：docker compose logs -f
3. 默认访问地址：http://localhost:3000

3.2 进阶版（自定义配置）

如果你需要调整配置（如API密钥、端口映射等），可以按以下步骤操作：

🔧 1. 配置核心参数

# 编辑环境变量文件
nano apps/api/.env

关键配置项说明：

• PORT: API服务端口（默认3000）
• DATABASE_URL: 数据库连接地址
• LLM_PROVIDER: 默认LLM提供商

🔧 2. 自定义服务组合

# 查看所有可用服务
cat docker-compose.yml
# 按需启动服务（例如仅启动核心服务）
docker compose up -d api web

🔧 3. 验证部署状态

# 检查服务健康状态
curl http://localhost:3000/api/health
# 预期返回：{"status":"ok"}

⚠️ 重要提示：首次启动时，系统会自动初始化数据库并下载必要模型，这个过程可能需要5-10分钟，请耐心等待。

四、功能探索：5分钟体验路线图

4.1 快速上手（5分钟路线）

timeline
    title Refly AI 5分钟体验路线
    0分钟 : 访问 http://localhost:3000 注册账号
    1分钟 : 点击"New Workflow"创建第一个工作流
    2分钟 : 在输入框尝试输入"帮我生成一个产品介绍文案"
    3分钟 : 查看右侧面板的AI生成结果
    4分钟 : 点击"Save"保存你的第一个创作
    5分钟 : 在"Run History"中查看历史记录

4.2 核心功能体验

1. 多线程对话系统 就像同时打开多个聊天窗口，你可以在一个画布中创建多个独立对话线程，让AI同时处理不同任务。点击界面左侧"New Workflow"即可创建新线程。

2. 上下文记忆功能 Refly AI会记住你之前的对话内容，就像聊天时对方记得你们之前的讨论。尝试在对话中提及"之前说的那个营销方案"，AI会自动关联历史上下文。

3. 代码工件生成 输入"生成一个简单的SVG流程图"，AI会直接创建可编辑的矢量图形。你可以点击"Export"按钮将结果保存为文件。

图2：Refly AI 设置界面，可配置个人偏好和集成服务

五、社区生态：扩展你的AI工具箱

Refly AI拥有活跃的社区生态，你可以：

• 探索社区模板：访问"Marketplace"获取其他用户分享的工作流模板
• 开发自定义工具：通过packages/agent-tools/目录开发自己的AI工具
• 参与贡献：查看CONTRIBUTING.md了解如何为项目贡献代码
• 加入讨论：通过项目的Discord社区与其他用户交流使用技巧

现在，你已经准备好使用Refly AI将创意转化为现实。开始探索这个强大的AI创作引擎吧！