likeadmin 是一个快速开发通用管理后台, 有java和php版本使用前后端分离方式进行开发 近期上线了python版本, 赶紧体验了一下,发现启动的坑还是不少,
总结一下吧
0 环境准备
Python >=3.6
Mysql >=5.7
Redis >=6.0
Node.js >=14.18.1
1. 克隆项目
从官方Gitee仓库克隆工程文件
https://gitee.com/likeadmin/likeadmin_python.git
我这边使用了pycharm
-
server 为python包 是后端服务程序
-
admin 为前端工程目录
-
sql目录 内的install.sql文件为数据库仓库备份, 需要新建mysql数据库(名称随意,字符集
utf8mb4
)
2. 创建并还原数据库
新建一个mysql数据库,并将sql目录内的install.sql还原
3. 安装python依赖
安装之前建议新建python虚拟环境进行操作
进入终端 使用 pip 进行安装
pip install -i https://pypi.python.org/simple/ -r .\server\requirements.txt
这边建议使用官方源 使用国内镜像尝试了多个都出现了ERROR: No matching distribution found for aiofiles==22.1.0的报错问题
如果使用的是Windows 系统多半会出现
ERROR: No matching distribution found for uvloop==0.17.0
的问题 因为uvloop这个库暂时不支持Windows 将requirements.txt 文件中的uvloop==0.17.0
删除后即可重新安装
4. 修改示例配置文件 [重要]
1 将server包下的.example.env复制一份重命名为.env
2 修改复制后的.env文件
1) 修改mysql连接串 DATABASE_URL改为自己的用户名密码和数据库名称 如: DATABASE_URL='mysql+pymysql://root:root@127.0.0.1:3306/likeadmin?charset=utf8mb4'
2) 修改Redis连接串REDIS_URL改为自己的Redis信息如: REDIS_URL='redis://:@127.0.0.1:6379/0' (空密码空用户名)
3) 修改 DOMAIN 为http://127.0.0.1:8000 用于使用接口加载图片 DOMAIN='http://127.0.0.1:8000'
如果需要修改上传文件的目录 请修改UPLOAD_DIRECTORY
5. 启动后端服务
运行server/asgi.py
如果出现以下内容表示启动成功
进入 http://127.0.0.1:8000/redoc 出现相关接口文档
6. 安装前端依赖
终端进入admin目录
使用 npm 或者 yarn直接install
npm install
7. 修改前端接口请求路径
1 打开 admin/src/config/index.ts
修改14
行baseUrl
为''
因为 baseUrl() 函数的用途是将当前域名内容提取出来在加上.com 就就很奇怪 而且不能够使用因为我们使用的是本地开发环境
2 添加前端请求代理
编辑admin/vite.config.ts
在第16行后添加新内容 意义是启用一个前端代理将路径中带有api的所有接口代理到我们的后台服务
proxy: {
'/api': {
target: 'http://127.0.0.1:8000'
}
}
8. 启动前端
在admin目录中 使用 npm run dev
启动
进入http://localhost:5173/
如果出现 LikeAdmin开源后台 的标题则表示可以成功请求到接口 该
登录admin/123456
成功登录则表示mysql 以及 redis都可以成功连接上 项目启动成功! 开锁体验吧