### 飞牛OS系统上部署 FastGPT 并接入 M3E 的详细安装步骤 #### 一、环境准备 在飞牛OS系统上部署 FastGPT 和 M3E，需先确认系统的依赖项已满足。以下是具体的操作流程： 1. **更新操作系统包** 更新飞牛OS的软件包以确保兼容性和稳定性。 ```bash sudo apt update && sudo apt upgrade -y ``` 2. **安装必要的工具和库** 安装 Docker 及其相关组件以便后续运行容器化的服务。 ```bash sudo apt install docker.io docker-compose -y ``` 此处使用 `docker` 是为了简化复杂的服务管理和配置过程[^4]。 --- #### 二、下载并初始化 FastGPT 文件结构 创建工作目录并将官方提供的必要文件拉取到本地环境中。 1. 创建项目根目录： ```bash mkdir fastgpt && cd fastgpt ``` 2. 下载所需的 `docker-compose.yml` 和初始配置文件 `config.json`： ```bash curl -O https://raw.githubusercontent.com/labring/FastGPT/main/files/deploy/fastgpt/docker-compose.yml curl -O https://raw.githubusercontent.com/labring/FastGPT/main/projects/app/data/config.json ``` 这些文件定义了 FastGPT 的基础架构和服务启动逻辑[^4]。 --- #### 三、修改配置文件支持 M3E 向量模型 编辑 `config.json` 来指定向量数据库所使用的嵌入模型为 M3E。 打开 `config.json` 文件并通过文本编辑器调整相关内容： ```json { "vectorModel": { "name": "m3e", "apiKey": "sk-aaabbbcccdddeeefffggghhhiiijjjkkk" } } ``` 此部分设置明确了 FastGPT 将通过 API 调用 M3E 提供的语义表示能力来增强检索效果[^2]。 注意：如果计划自托管而非远程调用，则还需额外完成 M3E 的独立部署操作。 --- #### 四、启动 FastGPT 服务 执行以下命令即可依据当前设定自动构建镜像以及激活关联进程： ```bash sudo docker-compose up -d ``` 这一步骤会读取之前定制好的 YAML 描述文档从而实现一键式快速上线目标应用实例[^4]。 验证服务状态是否正常运作可借助如下指令查看日志输出情况： ```bash sudo docker ps sudo docker logs <container_name> ``` --- #### 五、测试集成后的功能表现 最后可通过访问 Web UI 或者发送 RESTful 请求形式检验整个链路连通状况良好与否。例如尝试上传一批文档资料至新建的知识空间里再发起查询请求看能否返回预期答案片段[^1]。 --- ### 注意事项 - 如果遇到权限不足错误，请记得赋予适当授权给对应路径下的所有子对象； - 对于网络连接不稳定区域建议提前缓存好所需资源减少等待时间损耗风险；