工作室要在自己的环境里装 FastGPT 做资料问答,最容易出问题的一步不是选模型,而是还没划定哪些文档可以进知识库、谁能进哪个工作区、服务是否只听内网,就把共享盘批量导入。本文先把文档白名单、工作区访问和内网边界写下来,再进入安装和试运行,是否试用仍由系统负责人和资料负责人确认;未授权的合同或客户资料不得导入。

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

适用范围与准备材料

适合计划在工作室内部署 FastGPT 的系统负责人和资料负责人。需要先阅读 FastGPT 官方文档(https://doc.fastgpt.io/),并按当前准备安装的版本核对其工作区、知识库和用户权限的实际能力。

不适合尚未确定可导入目录就准备把共享盘整盘接入,或希望跳过访问控制和内网边界直接对公网开放的情况。也不适用于把未授权的合同、客户名单或他人资料导入知识库。

准备第一期允许导入的文档清单(建议用已授权的脱敏制度或公开说明摘要)、拟定的工作区成员名单,以及安装环境说明。指定确认人(系统负责人和资料负责人),并写清停止条件:未授权资料不得导入;服务默认仅内网或本机访问,未经批准不得映射到公网;菜单名称以当前版本文档为准。确认安装包来源可追溯,并核对本版本实际提供的工作区、知识库和权限选项。

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

详细实施步骤

步骤 1

先写第一期数据源白名单和排除项,再谈安装。白名单要具体到目录或文件清单,而不是“共享盘都可以”。同时写明这些文档进入哪个工作区、哪些人可以问。未授权的合同、客户名单和外部资料列入排除项,不得导入知识库。

输入示例:「第一期范围草案:白名单仅《工作室制度摘要(已授权脱敏)》2026-11-01,进入工作区 F1,仅成员 U1、U2 可提问。排除:合同、客户名单、未授权的外部资料、共享盘其他目录。未列入白名单的文件不得导入知识库。草案待负责人确认。」

预期输出:一份书面白名单、排除项和访问对象草案。

检查点:白名单具体到文件或目录;排除项含未授权资料;访问对象有名单。

若资料负责人无法确认授权范围,停止导入准备,先完成授权清单再继续。

步骤 2

对照官方文档做部署前检查:安装包来源、服务监听地址是否仅内网、管理员账户如何创建、工作区与用户权限在当前版本如何配置。不要执行来路不明的一键脚本。菜单名称以当前版本文档为准,找不到的选项标待核实。不要编造文档中不存在的路径。

输入示例:「请根据 FastGPT 官方文档(https://doc.fastgpt.io/)和当前准备安装的版本,列出部署前检查项:安装包来源与校验、服务监听是否可限制在本机或内网、工作区与知识库权限如何配置、用户如何添加。无法在当前版本文档中确认的项标为待核实。不要编造菜单路径,不要执行来路不明的脚本。」

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

检查点:监听范围被列入;无来路不明脚本;无编造路径。

若文档与拟用版本不一致,同时记录两处说明,不要自行折中,先待核实后再安装。

步骤 3

在试验环境仅导入白名单文档,创建最小权限测试用户,验证其能问到摘要中的条目并带来源,且不存在可导入或检索排除资料的入口。排除类文件不要真正上传,只检查界面上是否有越权入口。

输入示例:「测试:工作区 F1 仅有第一期制度摘要。测试用户 U1 应能问到摘要中的条目并带来源;不应具备导入其他目录的权限;也不应检索到未被导入的合同样例(合同样例不得真正上传,只检查是否存在可越权的入口或全局检索)。」

预期输出:一份测试记录,含问答出处和越权入口检查结果。

检查点:测试只导入了白名单;排除类文件未上传;越权入口检查有记录。

若测试用户能导入白名单以外的目录或检索到未导入内容,视为失败,先收紧权限再测,不得进入试运行。

步骤 4

约定日志与下架:问答日志保留提问者代号、时间和所用工作区,默认不把完整内部文件正文另存到日志。文件从白名单撤销后,要在知识库中移除并做一次检索复检,避免切片残留。文档未写到的日志或删除能力标待核实。

输入示例:「请草拟审计规则:日志保留提问者代号、时间、工作区名称;默认不把完整内部文件正文另存到日志。下架流程:自知识库移除文档后做一次原问题检索复检。规则须对照官方文档,文档未写到的能力标待核实。规则待负责人确认。」

预期输出:一份待确认的日志与下架规则。

检查点:下架后有复检;完整正文默认不长期另存。

若准备把知识库全文同步到可被工作室以外访问的位置,停止该做法,先改边界再继续。

步骤 5

系统负责人和资料负责人确认白名单、内网边界、测试和下架规则后,才允许在指定工作区小范围试运行。版本升级、成员变更和新增数据源都要列入变更检查,避免一次升级打开放权限或监听范围。未授权资料在任何阶段都不得导入。

输入示例:确认记录(脱敏样例):「确认人:系统负责人X、资料负责人Y;日期:2026-11-21。第一期制度摘要可在工作区 F1 由指定测试用户试用;名单和合同不得接入;服务仅内网;升级或新增数据源前重做权限测试。未授权资料不得导入知识库。」

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

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

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

结果验收

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

对照白名单和测试记录:两位负责人应能在10分钟内说明第一期可导入的文件、不可导入的资料、服务监听范围,以及测试用户不应具备的导入权限。

常见问题与边界

常见问题是为了“先跑起来”把共享盘整盘导入,再打算事后补权限。界限是:先划白名单和访问对象,未授权资料不得进入知识库。另一问题是安装时把服务端口映射到公网以便外出也能问,发现后应收回监听范围,是否对工作室以外开放要单独评估和批准,并以官方文档和当前版本的实际能力为准。

下一步

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

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