本文參考:https://doc.tryfastgpt.ai/docs/development/
一、背景與技術優勢
FastGPT是基于LLM的知識庫問答系統,支持自定義數據訓練與多模型接入。硅基流動(SiliconFlow)作為AI基礎設施平臺,提供高性能大模型推理引擎SiliconLLM和免費API服務。通過Docker部署FastGPT并結合硅基流動API,可實現低成本、高靈活性的AI應用開發。
技術優勢
-
本地數據隱私:敏感數據無需上傳云端,符合《數據安全法》要求。
-
成本優化:硅基流動提供Qwen2-7B、GLM-4-9B等模型永久免費API,降低Token成本。
-
性能加速:硅基流動自研推理引擎SiliconLLM生成速度較開源產品快10倍。
二、環境準備
1. 系統要求
-
操作系統:Linux(推薦Ubuntu 22.04)
-
硬件:至少8GB內存,推薦NVIDIA GPU(如RTX 3060)
-
軟件:Docker 24.0+、Docker Compose 2.20+
2. 安裝Docker與Docker Compose
Centos7一鍵安裝docker
yum install nano -y
nano install_docker.sh
#!/bin/bash ? # 設置阿里云的YUM倉庫 cat > /etc/yum.repos.d/docker-ce.repo <<EOF [docker-ce-stable] name=Docker CE Stable - \$basearch baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/7/\$basearch/stable enabled=1 gpgcheck=1 gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg EOF ? # 安裝所需的包 yum install -y yum-utils device-mapper-persistent-data lvm2 ? # 更新YUM緩存 yum makecache fast ? # 安裝nano yum -y install nano ? # 安裝Docker CE yum install -y docker-ce ? # 啟用Docker服務(開機自啟) systemctl enable docker ? # 啟動Docker服務 systemctl start docker ? echo "Docker has been installed and started!" ? # chmod +x install_docker.sh;sh install_docker.sh ?docker阿里云鏡像
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<EOF {"registry-mirrors": ["https://docker.1panel.live"] } EOF sudo systemctl daemon-reload sudo systemctl restart docker
三、FastGPT Docker部署
1. 創建項目目錄
進入你的安裝根目錄,例如/home
mkdir fastgpt && cd fastgpt
2. 下載配置文件
curl -O https://raw.githubusercontent.com/labring/FastGPT/main/projects/app/data/config.json
curl -o docker-compose.yml https://raw.githubusercontent.com/labring/FastGPT/main/deploy/docker/docker-compose-pgvector.yml
config.json 2025年4月21日
// 已使用 json5 進行解析,會自動去掉注釋,無需手動去除
{"feConfigs": {"lafEnv": "https://laf.dev", // laf環境。 https://laf.run (杭州阿里云) ,或者私有化的laf環境。如果使用 Laf openapi 功能,需要最新版的 laf 。"mcpServerProxyEndpoint": "" // mcp server 代理地址,例如: http://localhost:3005},"systemEnv": {"vectorMaxProcess": 10, // 向量處理線程數量"qaMaxProcess": 10, // 問答拆分線程數量"vlmMaxProcess": 10, // 圖片理解模型最大處理進程"tokenWorkers": 30, // Token 計算線程保持數,會持續占用內存,不能設置太大。"hnswEfSearch": 100, // 向量搜索參數,僅對 PG 和 OB 生效。越大,搜索越精確,但是速度越慢。設置為100,有99%+精度。"customPdfParse": {"url": "", // 自定義 PDF 解析服務地址"key": "", // 自定義 PDF 解析服務密鑰"doc2xKey": "", // doc2x 服務密鑰"price": 0 // PDF 解析服務價格}}
}
docker-compose. yml PgVector版本 2025年4月21日
# 數據庫的默認賬號和密碼僅首次運行時設置有效
# 如果修改了賬號密碼,記得改數據庫和項目連接參數,別只改一處~
# 該配置文件只是給快速啟動,測試使用。正式使用,記得務必修改賬號密碼,以及調整合適的知識庫參數,共享內存等。
# 如何無法訪問 dockerhub 和 git,可以用阿里云(阿里云沒有arm包)
?
version: '3.3'
services:# dbpg:image: pgvector/pgvector:0.8.0-pg15 # docker hub# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/pgvector:v0.8.0-pg15 # 阿里云container_name: pgrestart: always# ports: # 生產環境建議不要暴露# ? - 5432:5432networks:- fastgptenvironment:# 這里的配置只有首次運行生效。修改后,重啟鏡像是不會生效的。需要把持久化數據刪除再重啟,才有效果- POSTGRES_USER=username- POSTGRES_PASSWORD=password- POSTGRES_DB=postgresvolumes:- ./pg/data:/var/lib/postgresql/datamongo:image: mongo:5.0.18 # dockerhub# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/mongo:5.0.18 # 阿里云# image: mongo:4.4.29 # cpu不支持AVX時候使用container_name: mongorestart: always# ports:# ? - 27017:27017networks:- fastgptcommand: mongod --keyFile /data/mongodb.key --replSet rs0environment:- MONGO_INITDB_ROOT_USERNAME=myusername- MONGO_INITDB_ROOT_PASSWORD=mypasswordvolumes:- ./mongo/data:/data/dbentrypoint:- bash- -c- |openssl rand -base64 128 > /data/mongodb.keychmod 400 /data/mongodb.keychown 999:999 /data/mongodb.keyecho 'const isInited = rs.status().ok === 1if(!isInited){rs.initiate({_id: "rs0",members: [{ _id: 0, host: "mongo:27017" }]})}' > /data/initReplicaSet.js# 啟動MongoDB服務exec docker-entrypoint.sh "$$@" &
?# 等待MongoDB服務啟動until mongo -u myusername -p mypassword --authenticationDatabase admin --eval "print('waited for connection')"; doecho "Waiting for MongoDB to start..."sleep 2done
?# 執行初始化副本集的腳本mongo -u myusername -p mypassword --authenticationDatabase admin /data/initReplicaSet.js
?# 等待docker-entrypoint.sh腳本執行的MongoDB服務進程wait $$!
?redis:image: redis:7.2-alpinecontainer_name: redis# ports:# - 6379:6379networks:- fastgptrestart: alwayscommand: |redis-server --requirepass mypassword --loglevel warning --maxclients 10000 --appendonly yes --save 60 10 --maxmemory 4gb --maxmemory-policy noevictionvolumes:- ./redis/data:/data
?# fastgptsandbox:container_name: sandboximage: ghcr.io/labring/fastgpt-sandbox:v4.9.6 # git# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-sandbox:v4.9.6 # 阿里云networks:- fastgptrestart: alwaysfastgpt-mcp-server:container_name: fastgpt-mcp-serverimage: ghcr.io/labring/fastgpt-mcp_server:v4.9.6 # git# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server:v4.9.6 # 阿里云ports:- 3005:3000networks:- fastgptrestart: alwaysenvironment:- FASTGPT_ENDPOINT=http://fastgpt:3000fastgpt:container_name: fastgptimage: ghcr.io/labring/fastgpt:v4.9.6 # git# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.9.6 # 阿里云ports:- 3000:3000networks:- fastgptdepends_on:- mongo- pg- sandboxrestart: alwaysenvironment:# 前端外部可訪問的地址,用于自動補全文件資源路徑。例如 https:fastgpt.cn,不能填 localhost。這個值可以不填,不填則發給模型的圖片會是一個相對路徑,而不是全路徑,模型可能偽造Host。- FE_DOMAIN=# root 密碼,用戶名為: root。如果需要修改 root 密碼,直接修改這個環境變量,并重啟即可。- DEFAULT_ROOT_PSW=1234# AI Proxy 的地址,如果配了該地址,優先使用- AIPROXY_API_ENDPOINT=http://aiproxy:3000# AI Proxy 的 Admin Token,與 AI Proxy 中的環境變量 ADMIN_KEY- AIPROXY_API_TOKEN=aiproxy# 數據庫最大連接數- DB_MAX_LINK=30# 登錄憑證密鑰- TOKEN_KEY=any# root的密鑰,常用于升級時候的初始化請求- ROOT_KEY=root_key# 文件閱讀加密- FILE_TOKEN_KEY=filetoken# MongoDB 連接參數. 用戶名myusername,密碼mypassword。- MONGODB_URI=mongodb://myusername:mypassword@mongo:27017/fastgpt?authSource=admin# pg 連接參數- PG_URL=postgresql://username:password@pg:5432/postgres# Redis 連接參數- REDIS_URL=redis://default:mypassword@redis:6379# sandbox 地址- SANDBOX_URL=http://sandbox:3000# 日志等級: debug, info, warn, error- LOG_LEVEL=info- STORE_LOG_LEVEL=warn# 工作流最大運行次數- WORKFLOW_MAX_RUN_TIMES=1000# 批量執行節點,最大輸入長度- WORKFLOW_MAX_LOOP_TIMES=100# 自定義跨域,不配置時,默認都允許跨域(多個域名通過逗號分割)- ALLOWED_ORIGINS=# 是否開啟IP限制,默認不開啟- USE_IP_LIMIT=false# 對話文件過期天數- CHAT_FILE_EXPIRE_TIME=7volumes:- ./config.json:/app/data/config.json
?# AI Proxyaiproxy:image: ghcr.io/labring/aiproxy:v0.1.7# image: registry.cn-hangzhou.aliyuncs.com/labring/aiproxy:v0.1.7 # 阿里云container_name: aiproxyrestart: unless-stoppeddepends_on:aiproxy_pg:condition: service_healthynetworks:- fastgptenvironment:# 對應 fastgpt 里的AIPROXY_API_TOKEN- ADMIN_KEY=aiproxy# 錯誤日志詳情保存時間(小時)- LOG_DETAIL_STORAGE_HOURS=1# 數據庫連接地址- SQL_DSN=postgres://postgres:aiproxy@aiproxy_pg:5432/aiproxy# 最大重試次數- RETRY_TIMES=3# 不需要計費- BILLING_ENABLED=false# 不需要嚴格檢測模型- DISABLE_MODEL_CONFIG=truehealthcheck:test: ['CMD', 'curl', '-f', 'http://localhost:3000/api/status']interval: 5stimeout: 5sretries: 10aiproxy_pg:image: pgvector/pgvector:0.8.0-pg15 # docker hub# image: registry.cn-hangzhou.aliyuncs.com/fastgpt/pgvector:v0.8.0-pg15 # 阿里云restart: unless-stoppedcontainer_name: aiproxy_pgvolumes:- ./aiproxy_pg:/var/lib/postgresql/datanetworks:- fastgptenvironment:TZ: Asia/ShanghaiPOSTGRES_USER: postgresPOSTGRES_DB: aiproxyPOSTGRES_PASSWORD: aiproxyhealthcheck:test: ['CMD', 'pg_isready', '-U', 'postgres', '-d', 'aiproxy']interval: 5stimeout: 5sretries: 10
networks:fastgpt:
3. 修改配置文件
編輯docker-compose.yml
?:
services:fastgpt:environment:- OPENAI_BASE_URL=https://api.siliconflow.cn/v1 # 硅基流動API端點- CHAT_API_KEY=your_api_key_here # 替換為實際API密鑰
4. 啟動容器
docker-compose up -d
5. 驗證部署
訪問http://localhost:3000
?,若看到FastGPT界面,則部署成功。
訪問 FastGPT
目前可以通過
ip:3000
? 直接訪問(注意開放防火墻)。登錄用戶名為root
?,密碼為docker-compose.yml
?環境變量里設置的DEFAULT_ROOT_PSW
?。如果需要域名訪問,請自行安裝并配置 Nginx。
首次運行,會自動初始化 root 用戶,密碼為
1234
?(與環境變量中的DEFAULT_ROOT_PSW
?一致),日志可能會提示一次MongoServerError: Unable to read from a snapshot due to pending collection catalog changes;
?可忽略。
?
四、硅基流動免費API配置
1. 注冊與申請API密鑰
-
訪問硅基流動官網(cloud.siliconflow.cn),使用邀請碼
PnsFln9M
?注冊。 -
登錄后進入“API密鑰”頁面,創建新密鑰并復制。
?
2. 模型選擇與配置
硅基流動支持的模型包括:
-
Qwen2-7B(免費)
-
DeepSeek-R1(需付費或試用)
在FastGPT中配置模型
?
示例為Qwen2.5-7B-Instruct
?
?
自定義請求地址:
https://api.siliconflow.cn/v1/chat/completions
自定義請求 Key:
輸入你的秘鑰
?
五、集成與測試
1. 創建知識庫
-
在FastGPT控制臺上傳文檔(PDF/TXT等)。
-
選擇“知識庫管理”→“新建知識庫”,配置向量化模型(如M3E)。
?
然后進入數據庫添加知識文件
?
?
?
六、常見問題與解決方案
問題描述 | 解決方案 |
---|---|
MongoDB版本不兼容 | 修改docker-compose.yml ?中的Mongo鏡像版本為4.4.24。 |
API密鑰無效 | 檢查密鑰格式是否正確,確保未包含空格或特殊字符。 |
模型響應速度慢 | 調整模型參數(如降低溫度),或升級GPU資源。 |
端口沖突 | 修改docker-compose.yml ?中的端口映射(如8080:3000 ?)。 |