guzhi/README.md

vue-fastapi-admin

基于FastAPI + Vue3 + Naive UI的现代化前后端分离开发平台，融合了RBAC权限管理、动态路由和JWT鉴权，助力中小型应用快速搭建。

登录页

工作台

用户管理

角色管理

菜单管理

API管理

快速开始

方法一：dockerhub拉取镜像

docker pull mizhexiaoxiao/vue-fastapi-admin:latest 
docker run -d --restart=always --name=vue-fastapi-admin -p 9999:80 mizhexiaoxiao/vue-fastapi-admin

方法二：dockerfile构建镜像

docker安装(版本17.05+)

yum install -y docker-ce
systemctl start docker

构建镜像

git clone https://github.com/mizhexiaoxiao/vue-fastapi-admin.git
cd vue-fastapi-admin
docker build --no-cache . -t vue-fastapi-admin

启动容器

docker run -d --restart=always --name=vue-fastapi-admin -p 9999:80 vue-fastapi-admin

访问

http://localhost:9999

username：admin

password：123456

本地启动

后端

启动项目需要以下环境：

• Python 3.11
• Poetry

1. 创建虚拟环境

poetry shell

2. 安装依赖

poetry install

3. 启动服务

make run

服务现在应该正在运行，访问 http://localhost:9999/docs 查看API文档

前端

启动项目需要以下环境：

• node v18.8.0+

1. 进入前端目录

cd web

安装依赖(建议使用pnpm: https://pnpm.io/zh/installation)

npm i -g pnpm # 已安装可忽略
pnpm i # 或者 npm i

启动

pnpm dev