|
|
@@ -1,3 +1,112 @@
|
|
|
# HBlog
|
|
|
## 介绍
|
|
|
-`HBlog`是基于Python和Flask的博客系统
|
|
|
+`HBlog`是基于Python和Flask的博客系统。
|
|
|
+
|
|
|
+* 具有博文、博文评论、博文归档的功能。
|
|
|
+* 具有博客留言的功能。
|
|
|
+* 访客注册、角色管理的功能。
|
|
|
+* 文件存储的功能。
|
|
|
+* 具有管理员管理后台。
|
|
|
+
|
|
|
+## 部署
|
|
|
+### 下载
|
|
|
+```shell
|
|
|
+$ useradd hblog -m
|
|
|
+$ git clone https://github.com/SuperH-0630/HBlog.git /home/hblog/.HBlog
|
|
|
+```
|
|
|
+
|
|
|
+### 下载依赖
|
|
|
+```shell
|
|
|
+$ sudo -u hblog python3.10 -m pip install -r /home/hblog/.HBlog/requirements.txt --user
|
|
|
+$ sudo -u hblog python3.10 -m pip install gunicorn gevent --user
|
|
|
+```
|
|
|
+
|
|
|
+### 配置
|
|
|
+创建配置文件`etc/hblog/conf.json`，配置文件内容如下：
|
|
|
+```json
|
|
|
+{
|
|
|
+ "DEBUG_PROFILE": false,
|
|
|
+ "SECRET_KEY": "随机密钥",
|
|
|
+
|
|
|
+ "BLOG_NAME": "",
|
|
|
+ "BLOG_DESCRIBE": "",
|
|
|
+ "INTRODUCE": {
|
|
|
+ "介绍的名称": "可任意创建更多介绍"
|
|
|
+ },
|
|
|
+ "INTRODUCE_LINK": {
|
|
|
+ "连接名称": "可任意创建更多连接"
|
|
|
+ },
|
|
|
+ "ABOUT_ME_PAGE": "about_me.html静态页面的地址",
|
|
|
+ "FOOT": "页脚信息",
|
|
|
+
|
|
|
+ "MYSQL_URL": "",
|
|
|
+ "MYSQL_PORT": 3306,
|
|
|
+ "MYSQL_NAME": "",
|
|
|
+ "MYSQL_PASSWD": "",
|
|
|
+ "MYSQL_DATABASE": "",
|
|
|
+
|
|
|
+ "REDIS_HOST": "",
|
|
|
+ "REDIS_PORT": 6379,
|
|
|
+ "REDIS_NAME": "",
|
|
|
+ "REDIS_PASSWD": "",
|
|
|
+ "REDIS_DATABASE": 0,
|
|
|
+
|
|
|
+ "CACHE_REDIS_HOST": "",
|
|
|
+ "CACHE_REDIS_PORT": 6379,
|
|
|
+ "CACHE_REDIS_NAME": "",
|
|
|
+ "CACHE_REDIS_PASSWD": "",
|
|
|
+ "CACHE_REDIS_DATABASE": 0,
|
|
|
+
|
|
|
+ "MAIL_SERVER": "SMTP服务地址",
|
|
|
+ "MAIL_PORT": 465,
|
|
|
+ "MAIL_USE_TLS": false,
|
|
|
+ "MAIL_USE_SSL": true,
|
|
|
+ "MAIL_USERNAME": "",
|
|
|
+ "MAIL_PASSWORD": "@0630",
|
|
|
+ "MAIL_SENDER": "名字 <发件人地址>",
|
|
|
+
|
|
|
+ "USE_ALIYUN": true,
|
|
|
+ "ALIYUN_KEY": "阿里云OOS的账号Key",
|
|
|
+ "ALIYUN_SECRET": "",
|
|
|
+ "ALIYUN_BUCKET_ENDPOINT": "",
|
|
|
+ "ALIYUN_BUCKET_IS_CNAME": false,
|
|
|
+ "ALIYUN_BUCKET_NAME": "",
|
|
|
+ "ALIYUN_BUCKET_USE_SIGN_URL": false,
|
|
|
+
|
|
|
+ "LOG_LEVEL": "debug",
|
|
|
+ "LOG_HOME": "log",
|
|
|
+ "LOG_SENDER": true,
|
|
|
+
|
|
|
+ "LOGO": "Logo的文件名，存储在static目录的相对路径",
|
|
|
+ "ICP": {
|
|
|
+ "备案的域名": "ICP备案"
|
|
|
+ },
|
|
|
+ "GONG_AN": {
|
|
|
+ "备案的域名": "公安备案"
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+### 静态`AboutMe.html`页面
|
|
|
+一个普通的HTML页面，必须包含`<div class="about-me"> </div>`，这部分内容会被显示在博客上。
|
|
|
+
|
|
|
+### 创建`systemd`服务文件
|
|
|
+```serivce
|
|
|
+[Unit]
|
|
|
+Description=HBlog server on 8080
|
|
|
+After=network.target auditd.service
|
|
|
+
|
|
|
+[Service]
|
|
|
+User=hblog
|
|
|
+Group=hblog
|
|
|
+WorkingDirectory=/home/hblog/.HBlog/
|
|
|
+ExecStart=python3.10的路径 -m gunicorn -c /home/hblog/.HBlog/gunicorn.conf.py main:app --preload -b 0.0.0.0:8080
|
|
|
+Type=simple
|
|
|
+Environment="HBLOG_CONF=/etc/hblog/conf.json"
|
|
|
+
|
|
|
+[Install]
|
|
|
+WantedBy=multi-user.targe
|
|
|
+```
|
|
|
+
|
|
|
+## 样例博客
|
|
|
+我的博客就是用HBlog搭建的，访问：[是桓的小窝](https://www.song-zh.com)。
|
