Fastgpt 无法启动或启动后无法正常使用的讨论（启动失败、用户未注册等问题这里）

洛阳泰山2024-03-27 14:28

FastGPT 是一个基于 LLM 大语言模型的知识库问答系统，提供开箱即用的数据处理、模型调用等能力。同时可以通过 Flow 可视化进行工作流编排，从而实现复杂的问答场景！

FastGPT是非常实用并且相当厉害的个人知识库AI项目，项目是非常厉害的，更新的方法也必须得厉害和复杂到配得上这个项目！

经历过多次升级失败重新部署项目再重新导入知识库后，龚老师也多了个心眼：创建快照！

------不行就回滚！

所以每次最期待却又担心的事就是FastGPT又更新啦！

这不？

github 的 Issues里，很多高手都卡在了升级4.6.8上，龚老师一开始当然也没能幸免。

不过好在，经过10几个小时的昼夜奋斗摸索，终于搞定了。

注意：以下教程适用于从4.6.7升级到4.6.8。如果你是从低版本升级上来的，记得去官方教程上看看相应的升级教程，写了要初始化的就一定要从低版本开始逐步初始化，千万不要自作聪明直接跳过。

注意：以下教程基于linux系统。

第一步：修改docker-compose.yml 代码

修改docker-compose.yml 里mongo部分的代码，补上command和mongodb.key

bash 复制代码 
mongo:
  image: mongo:5.0.18
  # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/mongo:5.0.18 # 阿里云
  container_name: mongo
  # 端口号 可以保持默认的'27017'，如果要修改，就修改前面的'27018'
  ports:
    - 27018:27017
  networks:
    - fastgpt
  command: mongod --keyFile /data/mongodb.key --replSet rs0
  environment:
    # 下面的用户名和密码如果你之前用的username/password，就仍然用之前的。
    - MONGO_INITDB_ROOT_USERNAME=myname
    - MONGO_INITDB_ROOT_PASSWORD=mypassword
  volumes:
    - ./mongo/data:/data/db
    - ./mongodb.key:/data/mongodb.key
COPY
windows下不能修改权限的问题，有网友说修改 docker-compose.yml 可解决，将内容替换为：

  mongo:
    image: mongo:5.0.18
    # image: registry.cn-hangzhou.aliyuncs.com/fastgpt/mongo:5.0.18 # 阿里云
    container_name: mongo
    ports:
      - 27017:27017
    networks:
      - fastgpt
    command: mongod --keyFile /data/mongodb.key --replSet rs0
    environment:
      # 默认的用户名和密码，只有首次允许有效
      - MONGO_INITDB_ROOT_USERNAME=myname
      - MONGO_INITDB_ROOT_PASSWORD=mypassword
    volumes:
      - ./mongo/data:/data/db
      - ./mongodb.key:/data/mongodb.key
    entrypoint:
      - bash
      - -c
      - |
          chmod 400 /data/mongodb.key
          chown 999:999 /data/mongodb.key
          exec docker-entrypoint.sh $$@

第二步：修改config.json代码：

直接复制以下代码替换掉原来的：

bash 复制代码 
{
  "systemEnv": {
    "openapiPrefix": "fastgpt",
    "vectorMaxProcess": 15,
    "qaMaxProcess": 15,
    "pgHNSWEfSearch": 100
  },
  "llmModels": [
    {
      "model": "gpt-3.5-turbo-1106",
      "name": "gpt-3.5-turbo",
      "maxContext": 16000,
      "maxResponse": 4000,
      "quoteMaxToken": 13000,
      "maxTemperature": 1.2,
      "inputPrice": 0,
      "outputPrice": 0,
      "censor": false,
      "vision": false,
      "datasetProcess": false,
      "toolChoice": true,
      "functionCall": false,
      "customCQPrompt": "",
      "customExtractPrompt": "",
      "defaultSystemChatPrompt": "",
      "defaultConfig": {}
    },
    {
      "model": "gpt-3.5-turbo-16k",
      "name": "gpt-3.5-turbo-16k",
      "maxContext": 16000,
      "maxResponse": 16000,
      "quoteMaxToken": 13000,
      "maxTemperature": 1.2,
      "inputPrice": 0,
      "outputPrice": 0,
      "censor": false,
      "vision": false,
      "datasetProcess": true,
      "toolChoice": true,
      "functionCall": false,
      "customCQPrompt": "",
      "customExtractPrompt": "",
      "defaultSystemChatPrompt": "",
      "defaultConfig": {}
    },
    {
      "model": "gpt-4-0125-preview",
      "name": "gpt-4-turbo",
      "maxContext": 125000,
      "maxResponse": 4000,
      "quoteMaxToken": 100000,
      "maxTemperature": 1.2,
      "inputPrice": 0,
      "outputPrice": 0,
      "censor": false,
      "vision": false,
      "datasetProcess": false,
      "toolChoice": true,
      "functionCall": false,
      "customCQPrompt": "",
      "customExtractPrompt": "",
      "defaultSystemChatPrompt": "",
      "defaultConfig": {}
    },
    {
      "model": "gpt-4-vision-preview",
      "name": "gpt-4-vision",
      "maxContext": 128000,
      "maxResponse": 4000,
      "quoteMaxToken": 100000,
      "maxTemperature": 1.2,
      "inputPrice": 0,
      "outputPrice": 0,
      "censor": false,
      "vision": false,
      "datasetProcess": false,
      "toolChoice": true,
      "functionCall": false,
      "customCQPrompt": "",
      "customExtractPrompt": "",
      "defaultSystemChatPrompt": "",
      "defaultConfig": {}
    }
  ],
  "vectorModels": [
    {
      "model": "text-embedding-ada-002",
      "name": "Embedding-2",
      "inputPrice": 0,
      "outputPrice": 0,
      "defaultToken": 700,
      "maxToken": 3000,
      "weight": 100,
      "defaultConfig": {}
    }
  ],
  "reRankModels": [],
  "audioSpeechModels": [
    {
      "model": "tts-1",
      "name": "OpenAI TTS1",
      "inputPrice": 0,
      "outputPrice": 0,
      "voices": [
        { "label": "Alloy", "value": "alloy", "bufferId": "openai-Alloy" },
        { "label": "Echo", "value": "echo", "bufferId": "openai-Echo" },
        { "label": "Fable", "value": "fable", "bufferId": "openai-Fable" },
        { "label": "Onyx", "value": "onyx", "bufferId": "openai-Onyx" },
        { "label": "Nova", "value": "nova", "bufferId": "openai-Nova" },
        { "label": "Shimmer", "value": "shimmer", "bufferId": "openai-Shimmer" }
      ]
    }
  ],
  "whisperModel": {
    "model": "whisper-1",
    "name": "Whisper1",
    "inputPrice": 0,
    "outputPrice": 0
  }
}

第三步：创建 mongo 密钥，赋予密钥文件权限:

打开终端， CD 进项目的目录，如果安装了宝塔，直接在项目的目录界面点击终端。

在终端输入代码：

bash 复制代码 
openssl rand -base64 756 > ./mongodb.key
chmod 600 ./mongodb.key
chown 999:root ./mongodb.key

(！！！这一步很关键，如果不输入这一步，就无法启动Mongo容器，后面就会出现一系列令人抓狂的错误)

第四步：重启所有容器。

依次在终端输入以下代码：

bash 复制代码 
# 重启 Mongo
docker-compose down
docker-compose up -d

此时，可以去Docker界面看看mongo是否正常启动，如果没有启动，就手动启动一下。

第五步：进入容器初始化部分集合

FastGPT 4.6.8 后使用了 MongoDB 的事务，需要运行在副本集上。副本集没法自动化初始化，需手动操作。

bash 复制代码 
# 查看 mongo 容器是否正常运行
docker ps
# 进入容器
docker exec -it mongo bash

# 连接数据库（这里要填Mongo的用户名和密码）
mongo -u myusername -p mypassword --authenticationDatabase admin

# 初始化副本集。如果需要外网访问，mongo:27017 可以改成 ip:27017。但是需要同时修改 FastGPT 连接的参数（MONGODB_URI=mongodb://myname:mypassword@mongo:27017/fastgpt?authSource=admin => MONGODB_URI=mongodb://myname:mypassword@ip:27017/fastgpt?authSource=admin）
rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "mongo:27017" }
  ]
})
# 检查状态。如果提示 rs0 状态，则代表运行成功
rs.status()

第六步：更新容器

在终端输入以下代码：

bash 复制代码 
docker-compose down && docker-compose pull && docker-compose up -d

此时刷新一下自己的FastGPT网站,应该就能显示4.6.8了。

可能会出现的问题：

  • 导入知识库时提示null value in column "tmb_id" of relation "modeldata" violates not-null constraint

    这可能是因为没有初始化4.6.7，或初始化4.6.7出现了某首错误，比如rootkey不正确；

  • 已经显示4.6.8，但对话或导入模型时提示没有模型。

    需要重新拉取最新的容器：

bash 复制代码 
docker-compose down && docker-compose pull && docker-compose up -d
  • 初始化mongo副本集提示This node was not started with the replSet option
    这是因为mongodb.key的权限不够，需要再在终端输入：
bash 复制代码 
chown 999:root ./mongodb.key
相关推荐
张彦峰ZYF9 分钟前
从对话记忆到状态控制平面：长程 Agent 的状态治理工程
人工智能·llm·agent·loopengineering·langgroup
johnny23335 分钟前
LocalAI、LocalAGI、LocalRecall
llm
漂流瓶jz8 小时前
【AI】大模型本地部署与量化：Ollama、transformers、llama.cpp实践
人工智能·llm·ai编程
张彦峰ZYF12 小时前
MCP 从“能连工具”到“像 Web 一样部署”——无状态核心、扩展框架与企业级 Agent 基础设施的真正分水岭
人工智能·llm·agent·mcp
Darling噜啦啦15 小时前
LLM 记忆管理三剑客：截断、总结、检索，彻底搞懂 Agent 的 Memory 系统
langchain·llm·agent
今日无bug15 小时前
大模型的回答是怎么一个字一个字蹦出来的？前端流式输出解析
前端·llm·agent
桃西西呀19 小时前
《牛来》票房涨 1000 倍是真的吗？——2026暑期档 124 亿里的数学
人工智能·数据分析·llm
tachibana220 小时前
如何设计多 Agent 的协作与动态切换机制？
网络·人工智能·ai·大模型·llm·agent
程序员三明治1 天前
【体验毛坯房】Deep Harness 入门教程
java·人工智能·后端·大模型·llm·deepseek·dsh
桃西西呀1 天前
AI 为什么一本正经地胡说八道？3 个底层原因 + 2 个防坑法
人工智能·llm·ai编程
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点03蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接042026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？05ZCode 周末送额度活动开启：3 亿 Token 免费领取06历年考研数学一、数学二、数学三真题试卷及答案PDF07微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新08AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路09Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费10VSCode+CodeX扩展，无法启动