FastGPT用户管理系统的完整部署指南：5分钟快速上手

【免费下载链接】fastgpt-admin fastgpt项目的简略后台 项目地址: https://gitcode.com/gh_mirrors/fa/fastgpt-admin

FastGPT-Admin是一个专为FastGPT平台设计的现代化用户后台管理系统，提供用户管理、知识库管理、AI助手管理和支付记录管理等核心功能。基于React和Express构建，通过MongoDB数据库实现数据持久化存储。

环境准备与依赖安装

首先确保您的系统已经安装Node.js（推荐版本16+）和pnpm包管理器。然后通过以下命令克隆项目并安装依赖：

git clone https://gitcode.com/gh_mirrors/fa/fastgpt-admin
cd fastgpt-admin
pnpm install

数据库配置与连接

打开项目根目录下的server.js文件，找到第10行的数据库连接配置：

const mongoURI = ''; // 在这里填入MongoDB的连接地址

将您的MongoDB连接字符串填入此处，格式通常为：

mongodb://username:password@host:port/database

启动应用服务

配置完成后，使用以下命令同时启动前端和后端服务：

pnpm dev

该命令会启动两个服务：

• 前端开发服务器：http://localhost:5173/
• 后端API服务器：http://localhost:3001/

登录系统与初始配置

系统启动后，使用默认账号密码登录：

• 用户名：tushan
• 密码：tushan

登录成功后，您将看到完整的管理控制台，包含以下功能模块：

功能模块	描述	对应API端点
用户管理	创建、编辑、删除用户账户	/users
支付记录	查看用户充值记录	/pays
知识库管理	管理用户知识库	/kbs
AI助手管理	配置AI模型参数	/models
系统设置	配置OpenAI密钥等	/settings

关键环境变量说明

虽然本项目主要通过代码配置，但您可以通过环境变量扩展功能：

• PORT: 后端服务端口（默认3001）
• MongoDB连接参数在server.js中直接配置

功能使用指南

用户管理操作

在用户管理界面，您可以：

• 创建新用户并设置初始余额
• 修改用户密码（自动加密存储）
• 调整用户推广费率
• 查看用户创建时间

系统配置管理

通过系统设置模块，您可以配置：

• OpenAI API密钥设置
• 向量处理最大进程数
• 问答处理最大进程数
• 模型训练相关配置

常见问题排查

连接数据库失败 检查MongoDB连接字符串格式是否正确，确保数据库服务正常运行。

端口冲突问题 如果3001端口被占用，可通过环境变量PORT修改后端服务端口。

依赖安装失败 尝试清除pnpm缓存：pnpm store prune，然后重新安装依赖。

扩展开发建议

如需扩展功能，可参考以下源码位置：

• 前端组件：src/components/
• API路由处理：server.js中的各个端点
• 数据库模型定义：server.js中的Schema定义

通过本指南，您已经成功部署并配置了FastGPT用户管理系统。系统提供了完整的管理功能，支持快速用户操作和系统配置，为FastGPT平台提供了可靠的后台管理解决方案。

【免费下载链接】fastgpt-admin fastgpt项目的简略后台 项目地址: https://gitcode.com/gh_mirrors/fa/fastgpt-admin