# pear-admin-flask-cms **Repository Path**: lmc2020/pear-admin-flask-cms ## Basic Information - **Project Name**: pear-admin-flask-cms - **Description**: pear-admin-flask基础上做了一些cms的功能,例如文章发布、富文本编辑器嵌入、附件上传之类的。 逐步更新。。。 - **Primary Language**: Python - **License**: MIT - **Default Branch**: alpha - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-12-19 - **Last Updated**: 2025-01-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 项目简介 基于 Pear Admin Flask 二开的一个CMS系统,实现了文章发布、富文本编辑器嵌入、前端API调用等功能。 # 内置功能 - [x] 用户管理:用户是系统操作者,该功能主要完成系统用户配置。 - [x] 权限管理:配置系统菜单,操作权限,按钮权限标识等。 - [x] 角色管理:角色菜单权限分配。 - [x] 操作日志:系统正常操作日志记录和查询;系统异常信息日志记录和查询。 - [x] 登录日志:系统登录日志记录查询包含登录异常。 - [x] 服务监控:监视当前系统CPU、内存、磁盘、python版本,运行时长等相关信息。 - [x] 文件上传: 图片上传示例 - [x] 文章发布:文章的发布、上传、富文本编辑器的使用、富文本编辑器的图片上传等等。 - [x] 文章分类:分类的管理 - [x] 前端API:可以调用文章、分类、tage、搜索结果、文章内容的接口,增加了API密钥的限制等。 # 项目安装 ## 从仓库获取 ```bash # 克隆仓库 / 手动下载 git clone https://gitee.com/lmc2020/pear-admin-flask-cms cd pear-admin-flask-cms # 进入到项目目录 ``` ## 修改配置 > **💡提示** 配置文件位于 `applications/config.py` ,打开配置文件看到的是位于 `BaseConfig` 类下的默认配置文件,您可以编写自己的配置类并继承 `BaseConfig` 类。 > **💡提示** 配置文件位于 `applications/security/security.py ,可修改关于前端API的一些配置。 > **⚠️注意** 配置文件中对于数据库的配置有所更改,请查看代码中的注释修改配置。 ## 虚拟环境安装项目(推荐) > **💡提示** 为了保证项目所依赖的库不影响其他部署在同一主机上的项目,我们推荐使用虚拟环境安装。 ```bash python -m venv venv # 进入虚拟环境下 venv\Scripts\activate.bat # Windows 提示命令符 venv\Scripts\Activate.ps1 # Windows Powershell . venv/bin/activate # Linux # 使用 pip 安装 pip install -r requirements.txt ``` ## 直接安装项目 ```bash # 使用 pip 安装 pip install -r requirements.txt # 同时你可以选择以模块的方式调用 pip python -m pip install -r requirements.txt ``` # 运行项目 + 一般情况运行项目 ```bash # 初始化数据库 flask db init flask db migrate flask db upgrade flask admin init # 运行项目 flask --app app.py run -h 0.0.0.0 -p 8000 --debug 或者 flask run 如果要单独开启debug 则: flask run --debug # 或者直接调用 app.py python app.py ``` + 使用 docker-compose 运行项目 ```bash git clone https://gitee.com/pear-admin/pear-admin-flask # 安装 docker-compose curl -L https://github.com/docker/compose/releases/download/1.26.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose # 运行如下命令,有输出版本,表示 docker-compose 可以用了 docker-compose --version # 在当前目录执行如下命令即可以运行 app docker-compose -f dockercompose.yaml up # 看到如下表示运行成功,由于 pip 下载慢,需要一些时间,请耐心等待;如果安装失败,重新执行上面的命令即可。 # 运行后在浏览器访问 127.0.0.1:5000 #如果要停止容器运行,在当前文件夹执行如下命令: docker-compose -f dockercompose.yaml down ``` # 预览项目 | | | | ---------------------- | ---------------------- | | ![](docs/assets/1.jpg) | ![](docs/assets/2.jpg) | | ![](docs/assets/3.jpg) | ![](docs/assets/4.jpg) | | ![](docs/assets/5.jpg) | ![](docs/assets/6.jpg) | # 其他说明 ## 项目初始用户以及其密码 默认用户为 `admin` ,密码默认为 `123456` 。 # 更多介绍,大家可以去pear-admin官网查看。