# DeerU

**Repository Path**: gojuukaze/DeerU

## Basic Information

- **Project Name**: DeerU
- **Description**: DeerU is a content management system, used for blogs. ( DeerU 是一个开源博客系统 )
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 49
- **Forks**: 10
- **Created**: 2018-06-05
- **Last Updated**: 2025-06-15

## Categories & Tags

**Categories**: blog

**Tags**: None

## README

<h1 align="center">
 <a href="https://github.com/gojuukaze/DeerU" title="DeerU">DeerU</a>
</h1>
<p align="center">
  <a href="https://github.com/gojuukaze/DeerU" title="DeerU">
  <img alt="DeerU Logo" src="./logo_black.png" width="180">
  </a>
</p>
<p align="center">
  <a title="快速开始" href="https://doc.ikaze.cn/deeru/user_guide/index.html"><strong>快速开始</strong></a>
  &#x2022;
  <a title="文档" href="https://doc.ikaze.cn/deeru/"><strong>文档</strong></a>
  &#x2022;
  <a title="贡献代码" href="https://doc.ikaze.cn/deeru/developer_guide/index.html#id5"><strong>贡献代码</strong></a>
</p>

<p align="center">
  <a href="" title="version">
    <img src="https://img.shields.io/badge/version-v2.0.0-blue" alt="version - v2.0.0">
  </a>

  <a href="https://github.com/gojuukaze/DeerU/blob/master/LICENSE" title="LICENSE">
    <img src="https://img.shields.io/badge/license-GPL%20V3-blue" alt="license - GPL V3">
  </a>
</p>


[DeerU](https://github.com/gojuukaze/DeerU) is a content management system, used for blogs.

DeerU 是一个开源博客系统，它基于Django开发。  

~~它提供了丰富的json数据接口（需安装[api插件](https://github.com/gojuukaze/deeru_plugin_theme)），前端开发人员可以不依赖Django模板，方便的开发主题，实现前后端分离。~~
（不再继续维护）
___

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><strong>V2.0.0</strong> 发布</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>
<p>DeerU 2.0 开始定位为可供二次开发的博客系统</p>
<p>基于此定位，此项目将为有django、前端经验开发者提供可自行扩展博客系统。</p>
此项目今后将只提供博客基础功能更新、安全性更新、可扩展性更新，除此之外的功能（比如主题、cdn等）需要开发者自行开发。
</td>
</tr>
<tr class="even">
<td>更多内容 >> <a href="https://doc.ikaze.cn/deeru/change_log.html">2.0更新说明</a> | 
<a href="https://doc.ikaze.cn/deeru/upgrade.html#id2">1.x升级2.0指南</a>
</td>
</tr>
</tbody>
</table>

依赖
---
* Python 3.6+
* pip 10+
* git
* libjpeg，zlib -- pillow包的依赖 
    - ubuntu: ``apt-get install libjpeg8-dev zlib1g-dev libfreetype6-dev`` 
    - centos: ``yum -y install python-devel zlib-devel libjpeg-turbo-devel`` 


目录
---

* 项目文档 ：[https://doc.ikaze.cn/deeru/](https://doc.ikaze.cn/deeru/)
* GITHUB ：[https://github.com/gojuukaze/DeerU](https://github.com/gojuukaze/DeerU)
* DEMO ：[https://www.ikaze.cn](https://www.ikaze.cn)
* [安装](#安装)
* [初始化](#初始化)
* [运行](#运行)

安装
---

安装之前建议配置虚拟环境

``` bash

    pip install virtualenv
    virtualenv --no-site-packages deeru_env
    source deeru_env/bin/activate
```

* pip安装

```bash
    pip install DeerU
    deeru-admin install deeru

```

* 手动安装（不推荐）

```bash

    git clone https://github.com/gojuukaze/DeerU.git
    cd DeerU
    pip install -r requirements.txt
    
    # 创建 deeru/settings_local.py , deeru/urls_local.py ，具体参考文档
```

初始化
---

* 运行下面命令初始化项目，注意：如果你更改了数据库的配置，或者修改了主题的静态文件 则需要再次运行初始化

```bash

    cd DeerU # 如果你没进入工程目录先进入
    python manage.py init_deeru
```

运行
---
* 以debug模式运行
```bash
    python manage.py runserver 0.0.0.0:8000

```
* 生产环境运行参考 [部署DeerU](https://doc.ikaze.cn/deeru/user_guide/deployment/index.html)

license
-------
DeerU使用 [GNU General Public License v3.0 协议](https://github.com/gojuukaze/DeerU/blob/master/LICENSE)
，你可以在遵循此协议的情况下免费使用DeerU

**重要！！**

> 需要注意的是，DeerU本身是免费的，但后台管理使用了富文本编辑器froala，其扩展插件并不免费，你可以在以下链接中查看收费信息：  
>
> https://github.com/froala/django-froala-editor#license  
>
> https://froala.com/wysiwyg-editor/pricing  
>
> 你可以自己更换其他编辑器（参照文档 [富文本编辑器](https://doc.ikaze.cn/deeru/user_guide/rich_text_editor.html) ）


截图
---
首页

<img alt="DeerU Logo" src="./docs/source/_static/home.png?raw=true" width="80%">
文章详情

<img alt="DeerU Logo" src="./docs/source/_static/detail.png?raw=true" width="80%">
admin
<img alt="DeerU Logo" src="./docs/source/_static/admin.png?raw=true" width="80%">
admin2
<img alt="DeerU Logo" src="./docs/source/_static/admin3.png?raw=true" width="80%">
手机1
<img alt="DeerU Logo" src="./docs/source/_static/p1.png?raw=true" width="50%">
手机2
<img alt="DeerU Logo" src="./docs/source/_static/p2.png?raw=true" width="50%">

捐赠 / Sponsor
==============

开源不易，如果你觉得对你有帮助，求打赏个一块两块的

![](https://gitee.com/gojuukaze/liteAuth/raw/master/shang.jpg)