百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

在Windows环境下,本地部署和启动开源项目Ragflow的源代码

off999 2025-03-28 20:16 31 浏览 0 评论

在当前AI领域中,基于检索增强生成(RAG)的应用备受关注,而开源项目RAGFlow因其灵活性和功能性成为了一个热门选择。不过,由于其快速的版本迭代,可能会存在一些Bug,并且在实际项目落地时通常需要根据具体需求对源码进行定制化修改。遗憾的是,RAGFlow官方尚未提供针对Windows开发环境的详细文档。因此,在本地部署过程中,我整理了一份详细的记录,希望能够为有类似需求的开发者提供参考。

一、RAGFlow Python 环境配置

确保您的Python版本符合以下要求:

  • Python 版本:>=3.10,<3.13

二、Poetry 下载与安装

使用 Poetry 来管理 Python 依赖。首先,通过 pip 安装 Poetry:

pip install poetry

验证安装是否成功:

poetry --version

三、安装 Python 依赖

  1. 以管理员身份启动 Anaconda Prompt
  2. 为了确保权限足够,建议以管理员身份启动 Anaconda Prompt。

2、切换到ragflow运行环境

(base) C:\Windows\System32>D:
(base) D:>conda activate ragflow
(ragflow) D:>cd D:\WorkSpace\ForAi\pythod\ragflow

3、在ragflow根目录下运行poetry安装依赖命令

# 安装所有默认依赖
poetry install

# 安装 full 组中的依赖
poetry install -E full

4、已知问题与后续处理

在安装过程中,pyicu 版本 ==2.14 未能成功安装。目前这一问题对解析文档和聊天功能没有影响,因此暂时未进行处理。后续将更新文档以记录具体的解决方法。

四、前端启动

1、前端web服务器nginx

默认在目录下提供的配置文件是linux的,需要改成windows

nginx.conf

# user 指令在 Windows 上不支持,注释掉或删除
# user  root;

worker_processes  auto;

# 修改日志路径为 Windows 路径
error_log  D:/dockerData/ragflow/nginx-1.21.1/logs/error.log notice;
pid        D:/dockerData/ragflow/nginx-1.21.1/logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    # 修改 mime.types 文件路径为 Windows 路径
    include       D:/dockerData/ragflow/nginx-1.21.1/conf/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    # 修改访问日志路径为 Windows 路径
    access_log  D:/dockerData/ragflow/nginx-1.21.1/logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  65;

    #gzip  on;
    client_max_body_size 128M;

    # 包含自定义配置文件
    include D:/dockerData/ragflow/nginx-1.21.1/conf/ragflow.conf;
}

proxy.conf

这个配置文件不做修改

ragflow.conf

server {
    listen 80;
    server_name _;
    # 设置根目录为 Windows 路径
    root D:/WorkSpace/ForAi/pythod/ragflow/web/dist;

    gzip on;
    gzip_min_length 1k;
    gzip_comp_level 9;
    gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;
    gzip_vary on;
    gzip_disable "MSIE [1-6]\.";

    location ~ ^/(v1|api) {
        proxy_pass http://127.0.0.1:9380;
        include proxy.conf;
    }


    location / {
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # Cache-Control: max-age~@~AExpires
    location ~ ^/static/(css|js|media)/ {
        expires 10y;
        access_log off;
    }
}

2、前端项目build

我使用的nodejs版本是 20.15.0 如果你本地有多个nodejs版本可以使用nvm管理切换

# 进入web目录下
(ragflow) D:\WorkSpace\ForAi\pythod\ragflow>cd web
# 安装前端依赖
npm install
# build项目
npm run build

可以看到web目录下多了个dist,ragflow.conf配置文件里需要配置这个目录

3、启动nginx

D:\dockerData\ragflow\nginx-1.21.1>start nginx

五、下载模型

找到根目录下的download_deps.py直接运行

依赖安装会比较慢

运行完根目录下多了这些文件

六、后端项目启动

1、配置mysql、redis、minio、es、infinity

2、启动项目

需要启动两个文件

(1)api下的ragflow_server.py

(2)rag/svr下的task_executor.py

在启动时遇到了文件是utf-8格式,默认使用的是gbk,我处理方式是直接改了源码,把文件处理的格式改成了utf-8

import os
import json
current_file_path = os.path.dirname(os.path.abspath(__file__))
json_file_path = os.path.join(current_file_path, "res/good_sch.json")

with open(json_file_path, "r", encoding="utf-8") as file:
    GOOD_SCH = json.load(file)

import os
import json

current_file_path = os.path.dirname(os.path.abspath(__file__))

# 读取 corp.tks.freq.json 文件
with open(os.path.join(current_file_path, "res/corp.tks.freq.json"), "r", encoding="utf-8") as file:
    CORP_TKS = json.load(file)

# 读取 good_corp.json 文件
with open(os.path.join(current_file_path, "res/good_corp.json"), "r", encoding="utf-8") as file:
    GOOD_CORP = json.load(file)

# 读取 corp_tag.json 文件
with open(os.path.join(current_file_path, "res/corp_tag.json"), "r", encoding="utf-8") as file:
    CORP_TAG = json.load(file)

cnvs = json.load(open(os.path.join(dir, fnm), "r", encoding="utf-8"))

七、以上步骤做完即可通过http://127.0.0.1访问

相关推荐

Linux 网络协议栈_linux网络协议栈

前言;更多学习资料(包含视频、技术学习路线图谱、文档等)后台私信《资料》免费领取技术点包含了C/C++,Linux,Nginx,ZeroMQ,MySQL,Redis,fastdfs,MongoDB,Z...

揭秘 BPF map 前生今世_bpfdm

1.前言众所周知,map可用于内核BPF程序和用户应用程序之间实现双向的数据交换,为BPF技术中的重要基础数据结构。在BPF程序中可以通过声明structbpf_map_def...

教你简单 提取fmpeg 视频,音频,字幕 方法

ffmpeg提取视频,音频,字幕方法(HowtoExtractVideo,Audio,SubtitlefromOriginalVideo?)1.提取视频(ExtractVi...

Linux内核原理到代码详解《内核视频教程》

Linux内核原理-进程入门进程进程不仅仅是一段可执行程序的代码,通常进程还包括其他资源,比如打开的文件,挂起的信号,内核内部的数据结构,处理器状态,内存地址空间,或多个执行线程,存放全局变量的数据段...

Linux C Socket UDP编程详解及实例分享

1、UDP网络编程主要流程UDP协议的程序设计框架,客户端和服务器之间的差别在于服务器必须使用bind()函数来绑定侦听的本地UDP端口,而客户端则可以不进行绑定,直接发送到服务器地址的某个端口地址。...

libevent源码分析之bufferevent使用详解

libevent的bufferevent在event的基础上自己维护了一个buffer,这样的话,就不需要再自己管理一个buffer了。先看看structbufferevent这个结构体struct...

一次解决Linux内核内存泄漏实战全过程

什么是内存泄漏:程序向系统申请内存,使用完不需要之后,不释放内存还给系统回收,造成申请的内存被浪费.发现系统中内存使用量随着时间的流逝,消耗的越来越多,例如下图所示:接下来的排查思路是:1.监控系统中...

彻底搞清楚内存泄漏的原因,如何避免内存泄漏,如何定位内存泄漏

作为C/C++开发人员,内存泄漏是最容易遇到的问题之一,这是由C/C++语言的特性引起的。C/C++语言与其他语言不同,需要开发者去申请和释放内存,即需要开发者去管理内存,如果内存使用不当,就容易造成...

linux网络编程常见API详解_linux网络编程视频教程

Linux网络编程API函数初步剖析今天我们来分析一下前几篇博文中提到的网络编程中几个核心的API,探究一下当我们调用每个API时,内核中具体做了哪些准备和初始化工作。1、socket(family...

Linux下C++访问web—使用libcurl库调用http接口发送解析json数据

一、背景这两天由于一些原因研究了研究如何在客户端C++代码中调用web服务端接口,需要访问url,并传入json数据,拿到返回值,并解析。 现在的情形是远程服务端的接口参数和返回类型都是json的字符...

平衡感知调节:“系统如人” 视角下的架构设计与业务稳定之道

在今天这个到处都是数字化的时代,系统可不是一堆冷冰冰的代码。它就像一个活生生的“数字人”,没了它,业务根本转不起来。总说“技术要为业务服务”,但实际操作起来问题不少:系统怎么才能快速响应业务需求?...

谈谈分布式文件系统下的本地缓存_什么是分布式文件存储

在分布式文件系统中,为了提高系统的性能,常常会引入不同类型的缓存存储系统(算法优化所带来的的效果可能远远不如缓存带来的优化效果)。在软件中缓存存储系统一般可分为了两类:一、分布式缓存,例如:Memca...

进程间通信之信号量semaphore--linux内核剖析

什么是信号量信号量的使用主要是用来保护共享资源,使得资源在一个时刻只有一个进程(线程)所拥有。信号量的值为正的时候,说明它空闲。所测试的线程可以锁定而使用它。若为0,说明它被占用,测试的线程要进入睡眠...

Qt编写推流程序/支持webrtc265/从此不用再转码/打开新世界的大门

一、前言在推流领域,尤其是监控行业,现在主流设备基本上都是265格式的视频流,想要在网页上直接显示监控流,之前的方案是,要么转成hls,要么魔改支持265格式的flv,要么265转成264,如果要追求...

30 分钟搞定 SpringBoot 视频推拉流!实战避坑指南

30分钟搞定SpringBoot视频推拉流!实战避坑指南在音视频开发领域,SpringBoot凭借其快速开发特性,成为很多开发者实现视频推拉流功能的首选框架。但实际开发中,从环境搭建到流处理优...

取消回复欢迎 发表评论: