Dash-FastAPI-Admin 项目安装和配置指南
1. 项目基础介绍和主要编程语言
Dash-FastAPI-Admin 是一个基于 Dash 和 FastAPI 的通用中后台管理系统,完全使用 Python 开发。该项目旨在提供一个快速开发平台,适用于个人和企业免费使用。Dash-FastAPI-Admin 的前端使用 Dash 框架,后端则使用 FastAPI 框架,结合了 SQLAlchemy、MySQL、Redis 等技术,支持 OAuth2 和 JWT 进行权限认证。
2. 项目使用的关键技术和框架
前端技术
- Dash: 一个用于构建数据可视化应用的 Python 框架。
- feffery-antd-components: 基于 Ant Design 的 Dash 组件库。
- feffery-utils-components: 提供一些实用功能的 Dash 组件库。
后端技术
- FastAPI: 一个现代、快速(高性能)的 Web 框架,用于构建 API。
- SQLAlchemy: 一个 Python SQL 工具包和对象关系映射 (ORM) 系统。
- MySQL: 一个开源的关系型数据库管理系统。
- Redis: 一个开源的内存数据结构存储,用作数据库、缓存和消息代理。
- OAuth2 & JWT: 用于身份验证和授权的标准协议。
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
- 安装 Python: 确保你的系统上已经安装了 Python 3.7 或更高版本。
- 安装 Git: 用于克隆项目代码。
- 安装 MySQL 和 Redis: 确保你的系统上已经安装并运行了 MySQL 和 Redis。
详细安装步骤
1. 克隆项目
首先,使用 Git 克隆项目代码到本地:
git clone https://github.com/insistence/Dash-FastAPI-Admin.git
2. 进入项目根目录
进入克隆下来的项目根目录:
cd Dash-FastAPI-Admin
3. 安装项目依赖环境
使用 pip 安装项目所需的所有依赖:
pip3 install -r requirements.txt
4. 配置前端
进入前端目录:
cd dash-fastapi-frontend
在 env.dev
文件中配置应用开发模式的相关信息,然后运行前端:
python3 app.py --env=dev
5. 配置后端
进入后端目录:
cd ../dash-fastapi-backend
在 env.dev
文件中配置开发模式的数据库和 Redis 环境。然后运行 SQL 文件:
# 新建数据库 dash-fastapi(默认,可修改)
# 使用命令或数据库连接工具运行 sql 文件夹下的 dash-fastapi.sql
最后,运行后端:
python3 app.py --env=dev
6. 访问项目
默认账号和密码为:
- 账号:admin
- 密码:admin123
在浏览器中访问:
http://127.0.0.1:8088
通过以上步骤,你就可以成功安装并运行 Dash-FastAPI-Admin 项目。如果在安装过程中遇到任何问题,可以参考项目的 README 文件或联系项目维护者获取帮助。