教研室如果还没写清哪些讲义、教案可以进知识库,工作区谁能进、服务是不是只听内网,就在自有环境里装 RAGFlow 并把共享盘一次性导入,未授权的学员作业和考试原卷很容易一起进去。本文先确定文档白名单、工作区访问权限和内网边界,再进入安装和试运行,是否试用仍由系统负责人和教研负责人确认;未授权的学员作业或考试原卷不得导入。

AI路引RAGFlow文档范围与访问边界封面
教研室部署RAGFlow前划定文档范围与访问边界的示意图

适用范围与准备材料

适合计划在教研室自有环境部署 RAGFlow 的系统负责人和教研负责人。需要先阅读 RAGFlow 官方文档(https://ragflow.io/docs),并以当前版本的实际安装与权限能力为准,不以转述或经验代替文档。

不适合尚未确定可导入资料、计划把未授权的学员作业、考试原卷或含学员完整身份信息的材料直接导入知识库,或希望先对公网开放再补权限的情况。也不适用于在未划定工作区访问对象之前整盘导入共享文件夹。

准备第一期文档白名单草案(例如已定稿且允许内部使用的讲义、教案,均带版本或日期)、工作区访问对象(教研人员代号)和一份明确排除清单(学员作业、考试原卷、未授权录音等)。指定确认人(系统负责人和教研负责人),并写清停止条件:未授权学员作业或考试原卷不得导入;服务监听范围未批准前不得对公网开放;安装命令和菜单以当前版本文档为准,不得按记忆编造。正式试用前先确认本机或内网环境是否满足文档中的要求。

产品功能可能随版本、地区、套餐和账号权限变化,以实际界面与官方说明为准。

详细实施步骤

步骤 1

先划可导入范围和工作区访问边界:第一期哪些讲义、教案可以进入知识库,哪些目录明确排除,谁可以进入哪个工作区。先写书面白名单,再谈安装。不要在这一步把共享盘整盘复制到待导入目录。

输入示例:「白名单草案:第一期可导入《课程讲义摘要》2026-11-01、《教案目录(已定稿)》2026-11-01,仅限教研工作区 J1,访问对象为指定教研人员。排除:未授权学员作业、考试原卷、含完整学号与姓名的成绩表、未公开的命题过程稿。问答仅供教研内部检索,不作考试成绩依据。草案待系统负责人和教研负责人确认。」

预期输出:一份书面白名单和排除清单,工作区访问对象已列出。

检查点:可导入文件带日期;作业和考试原卷在排除清单中;访问对象不是全体可写共享盘。

若有人主张“先把共享盘导进去再删作业和原卷”,停止导入,先完成白名单。

步骤 2

再谈部署与内网边界:服务安装在教研室指定环境,监听范围约定为本机或已批准内网。安装步骤、端口和工作区配置以 RAGFlow 官方文档和当前版本为准,不能确认的项标为待核实,不要照搬来路不明的公开暴露脚本。

输入示例:「请按 RAGFlow 官方文档(https://ragflow.io/docs)列出部署前检查项:当前版本对运行环境的要求、工作区或知识库权限在文档中如何描述、如何把服务监听限制在本机或内网。无法在当前文档或版本中确认的项标待核实,不要编造命令、端口或菜单。未批准前不要映射到公网。」

预期输出:一份部署检查表,已确认项带来源,未确认项为待核实。

检查点:监听范围被要求限制在本机或内网;没有编造安装路径。

若文档与现有环境不一致,记录差异并待系统负责人核实,不要强行安装后对公网开放。

步骤 3

用白名单内的脱敏或已定稿样例做一次最小导入和提问抽检,同时用排除类文件做反向检查:确认作业和原卷未被导入,且测试账号不能通过提问得到排除类内容。若当前版本无法完成权限测试,停止扩大导入并核对文档。

输入示例:「试运行材料:仅导入白名单中的《课程讲义摘要》2026-11-01。抽检问题:“讲义摘要中关于实验预习的表述出处是哪一节?”要求回答带来源。反向检查:确认排除目录中的《模拟考试原卷(不得导入)》和学员作业未被上传;用最小权限测试账号不应具备导入或看到排除类文件的能力。不要实际上传原卷或作业。」

预期输出:一份试运行与反向检查记录,排除类文件未实际上传。

检查点:抽检能对到讲义出处;排除类文件未进入知识库;测试账号权限被检查。

若误把原卷或作业导入,立即从知识库和工作区移除并做检索复检,确认无法再调取后再继续。

步骤 4

处理冲突、过期讲义和权限过宽:新旧讲义并存时并列版本和日期,不要自行指定哪一版为唯一答案;工作区若对全体开放导入,先收紧再试用。无法确认来源的文档先移出知识库。

输入示例:「请整理待确认项:1)同名讲义或教案存在多个日期的,列出文件名和日期,不要折中成一版;2)工作区成员中超出草案的账号;3)知识库里来源不明的文件。处理原则:来源不明先下架;过宽权限先收紧。不要为了补全答案去导入考试原卷。」

预期输出:一份版本冲突与权限待确认清单。

检查点:多版本被并列;来源不明文件未被继续检索;权限过宽被标出。

若系统无法列出已导入文件来源,暂停对外试用,待管理员按文档完成核对后再开放。

步骤 5

系统负责人和教研负责人确认白名单、部署检查、试运行和权限结果后,才可以内部试用。升级版本、新增数据源或对教研室以外开放前必须重做权限和监听范围测试。未授权作业和原卷始终不得导入。

输入示例:确认记录(脱敏样例):「确认人:系统负责人X、教研负责人Y;日期:2026-11-22。第一期讲义摘要和已定稿教案可在工作区 J1 由指定人员试用;学员作业和考试原卷不得导入;服务仅本机或已批准内网;升级或新增数据源前重做权限测试。」

预期输出:一份双人确认记录,试用前提写清。

检查点:确认以测试通过为前提;排除项和内网边界仍在。

若确认后有人把共享盘其他目录导入知识库,立即移除并做检索复检,再重审白名单。

结果验收

  • 第一期可导入文档有书面白名单,未授权学员作业和考试原卷被明确排除且未被导入。
  • 部署检查以当前版本文档为准,服务监听范围已约定在本机或已批准内网,未确认项标为待核实。
  • 最小权限和反向检查通过,或失败后已移除误导入文件并重测;排除类文件未用于实际上传。
  • 双人确认记录完整,并包含下架复检和变更前重测的要求。

对照白名单和测试记录:两位负责人应能在10分钟内说明第一期可导入的讲义或教案、不可导入的作业和原卷、服务监听范围,以及测试账号不应具备的导入权限。

常见问题与边界

常见问题是为了“先让老师们搜得到”,把共享盘整盘导入,连学员作业和考试原卷也进去,再打算事后补权限。界限是:先划白名单、工作区访问和内网边界,未授权作业和原卷不得进入知识库。另一问题是安装时把服务端口映射到公网以便在家也能问;发现后应收回监听范围,是否对教研室以外开放要单独评估和批准,并以官方文档和当前版本的实际能力为准。

下一步

主要入口:查看模型与部署栏目的同类实施方法。
相关文章:要在工作室部署FastGPT?先做文档范围与访问边界。

官方资料:RAGFlow 官方文档。本文为实施方法,不代表具体账号已开放全部功能;配图为AI生成主题封面。