# DBlog
**Repository Path**: wen_xue_feng/DBlog
## Basic Information
- **Project Name**: DBlog
- **Description**: DBlog：djangoblog system，是基于python3.8 + django3.2.4 + mysql8 + redis + uwsgi + nginx 的一个便于入门学习的多主题个人博客系统
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: http://www.xwboy.top/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 29
- **Created**: 2021-12-20
- **Last Updated**: 2022-05-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
ps: 个人博客在一些逻辑和限制上面考虑还欠周全，存在bug，不影响正常使用，
后续开发已暂缓，欢迎 pull request，我将在审阅并测试后第一时间通知您
# Django博客系统
项目基本完成，处于试运行阶段，示例网站为当前分支最新代码，
如果您想查看旧版本，可以到标签中选择对应的版本进行下载
[](https://www.python.org/downloads)
[](https://docs.djangoproject.com/zh-hans/3.2)
[](https://github.com/newpanjing/simpleui)
🙈🙈🙈 使用Django快速搭建博客系统，采用Django框架最基础结构（仅一个app）
优点：减少逻辑性，便于入门学习...
缺点：内容沉余，不够灵活...
### 基本要求
* Python: 3.8
* Django: 3.2.4
* Mysql: 8
* Redis
### 示例博客：http://www.xwboy.top/
### 功能点
* 用户注册，登录，登出，注销，密码邮箱验证重置（非 django-auth 验证方式）
* markdown文章渲染，代码高亮，支持后台markdown编写文章等
* 文章分类，归档，快捷搜索，标签集
* 4 种皮肤（清新，清爽，简约，暗黑）切换
* 文章排行榜 / 最新评论 / 阅读量排行榜
* 博文评论系统（仅基本功能）
* 多目标源博文分享（支持https）
* echarts 博文发布，标签统计图（折线图，饼图，梯形图）
* 文章分类 雷达统计图（雷达图）
* 网站配置数据 redis 缓存
* windows: django-gzip压缩主站，linux: nginx-gzip压缩全站
* Rss / Atom 订阅
* 支持图床，后台上传图片可直链访问及调用
* simpleui后台管理
###### ps: 如果访问网站期间，你使用了某些墙代理网络，会失去一些网页功能 ！！！
## ⬇ 源码下载
```
wget https://gitee.com/wu_cl/DBlog.git/master.zip
or
git clone https://gitee.com/wu_cl/DBlog.git
```
敏感词文件内容 static/sensitive_words/sensitive_words_lines.txt,
请前往 https://github.com/wjhgg/sensitive_words 进行替换
### 安装
```
1：pip install -r requirements.txt # 安装所有依赖
2：创建数据库，修改setting.py mysql数据库配置 (创建数据库时记得选择 utf8mb4 编码)
3：python manage.py makemigrations
4：python manage.py migrate
5：python manage.py runserver
```
### 使用
```python
# 初始化用户名密码，按照提示输入用户名、邮箱、密码即可
python manage.py createsuperuser
# 登录后台 编辑类型、标签、发布文章等
http://127.0.0.1:8000/admin
# 常见报错：
django.db.utils.IntegrityError: (1048, "Column 'last_login' cannot be null")
执行 python manage.py migrate auth 后, 再创建用户即可
```
### END:
浏览器中打开 即可访问
---
## 🙏 搭建Linux服务端
```python
# 前提条件
你已经成功在windows部署并运行过DBlog项目
# 示例环境（全过程已示例环境为基础）
Ubuntu-20.04, nginx-1.18.0, uwsgi, mysql-8, python-3.8, redis-server
# linux文件夹中提供了配置的参考文件
nginx_conf: nginx 配置文件(https)
uwsgi.py: 开机自启动服务脚本
uwsgi.sh: 用于调用自启动服务脚本的shell脚本
```
### 环境准备
```python
已安装Ubuntu-20.04,进入linux系统,打开命令行窗口
1, cd /home, 将 windows 项目拷贝至 /home 目录下
# 不建议直接将项目下载到linux，对于初学者，这是不友好的，
# 可以下载和使用‘winscp’进行windows与linux之间的拖拽操作
2, pip3 install uwsgi
3, 安装 mysql8 和 redis
百度: Ubuntu-20.04 安装 mysql8 并创建数据库
百度: Ubuntu-20.04 安装 redis
4, 将参考文件 nginx_conf 文件中的内容替换到 /etc/nginx/sites-enabled/default 文件中,
# 注意是替换内容,不是直接替换文件,如果网站未使用https,请百度django nginx配置,再修改文件内容
5, 将参考文件 uwsgi.sh 拷贝到 /etc/init.d/ 目录下, 并进入 /etc/init.d/ 目录执行 chmod 755 uwsgi.sh 赋予该脚本权限
ps: 之所以让百度,是因为细节太多了...
```
### 安装
```
1: cd /home/DBlog, 执行 pip3 install -r requirements.txt # 安装所有依赖
2: 修改setting.py mysql数据库配置
3: python3 manage.py makemigrations
4: python3 manage.py migrate
5: python3 manage.py runserver
```
### 使用
```python
# 初始化用户名密码,按照提示输入用户名、邮箱、密码即可
python3 manage.py createsuperuser
# 登录后台 编辑类型、标签、发布文章等
http://服务器ip:8000/admin
```
### END:
浏览器中打开 即可访问
## ❓ 问题相关
欢迎提交问题到 [Issues](https://gitee.com/wu_cl/DBlog/issues) 或我的QQ邮箱 `2186656812@qq.com`, 我将在看到问题后第一时间回复