这里只介绍通过 docker 进行安装部署的方式,二进制安装也可参考。
博主提供了下面将要用到的镜像,可到这里查看:https://hub.docker.com/u/deepzz0。由于所有配置均在 app/conf.yml
下,所以在通过 docker 部署时建议将配置映射出来方便调试。
存储后端
首先启动我们的存储后端,用来存储我们的博客数据。eiblog 目前支持多种存储后端:
# driver # source
mongodb mongodb://localhost:27017
postgres host=localhost port=5432 user=user dbname=eiblog sslmode=disable password=password
mysql user:password@tcp(127.0.0.1:3306)/eiblog?charset=utf8mb4&parseTime=True&loc=Local
sqlite /path/eiblog.db
sqlserver sqlserver://user:password@localhost:9930?database=eiblog
clickhouse tcp://localhost:9000?database=eiblog&username=user&password=password&read_timeout=10&write_timeout=20
选择自己最熟悉的方式作为存储后端,然后修改 conf/app.yml
下的数据库地址:
database:
driver: postgres
source: host=localhost port=5432 user=postgres dbname=eiblog sslmode=disable password=MTI3LjAuMC4x
搜索引擎
博客强依赖 ElasticSearch 搜索引擎,如果仅调试可以跳过不部署。但对外提供服务强烈建议部署上 ES,这样可以提高体验感。博主提供了一个已经配置好的 docker 镜像:deepzz0/elasticsearch
:
# 运行
$ docker run --name es \
-p 9200:9200 \
deepzz0/elasticsearch:2.4.1
修改 conf/app.yml
下的 eshost
配置:
# 如果不提供搜索,请置空
eshost: http://localhost:9200
准备工作
整个博客部署的复杂点就在这里了,如果你真的想要一款不想再更换的博客,那么继续。
提前准备
请提前准备好以下内容,方便后续工作:
一台服务器
,对外提供访问能力。一个域名
,如果服务器在国内域名需要备案(免费域名不建议)。SSL证书
,博客要求全站 HTTPS 访问 + 七牛 CDN。Disqus评论
,作为博客评论系统,如果申请请自行 Google。简单说需要提供shortname
和public key
。Google Analystic
,数据统计分析工具。Superfeedr
,加速 RSS 订阅。Twitter账号
,希望你能有一个 twitter 账号。
要求很多吧。其实当初该博客系统只是为个人而设计的,是自己心中想要的那一款。博主些这篇文章不是想要多少人来用该博客,而是希望对那些追求至极的朋友说:你需要这款博客系统。
文件准备
博主是一个有强迫症的人,一些文件的路径我使用了固定的路径,请大家见谅。假如你的 cdn 域名为 st.example.com
,你需要确定这些文件已经在你的 cdn 中,它们路径分别是:
文件 | 地址 | 描述 |
---|---|---|
favicon.ico | st.example.com/static/img/favicon.ico | cdn 名为 static/img/favicon.ico 。你也可以在代理服务器自行配置,只要通过 example.com/favicon.ico 也是能够访问到。 |
bg04.jpg | st.example.com/static/img/bg04.jpg | cdn 名为 static/img/bg04.jpg ,首页左侧的大背景图,需要更名请到 website/st_blog.css 修改。 |
avatar.png | st.example.com/static/img/avatar.png | cdn 名为 static/img/avatar.png ,个人博客头像 |
blank.gif | st.example.com/static/img/blank.gif | cdn 名为 static/img/blank.gif ,空白图片,复制链接下载 https://st.deepzz.com/static/img/blank.gif。 |
default_avatar.png | st.example.com/static/img/default_avatar.png | cdn 名为 static/img/default_avatar.png ,disqus 默认头像图片,复制链接下载 https://st.deepzz.com/static/img/default_avatar.png |
注意:
- cdn 提到的文件下载,请复制链接进行下载,因为博主使用了防盗链功能。
- 每次修改 app.yml 文件(如:更换 cdn 域名或更新头像),如果你不知道是否应该提高 staticversion 一个版本,那么最好提高一个 +1。
- 每次手动修改 website 内的以
st_
开头的文件,请将app.yml
中的 staticversion 提高一个版本。
配置说明
走到这里,我相信只走到 80%
的路程。放弃还来得及。这里会对 eiblog/conf
下的所有文件做说明,希望你做好准备。
具体的配置内容已经在 app.yml
中进行说明了。
如果用 nginx 作为代理服务器,博主提供了一份示例配置 eiblog/eiblog.conf
,该配置涉及到 ssl
相关配置建议存放于 /etc/nginx/ssl
下。其中关于 ssl_dhparam
、站点认证均提供了相关配置。
开始部署
下面是博主通过 docker-compose
一键部署的文件内容,仅供参考:
version: '3'
services:
mongodb:
image: mongo:3.2
volumes:
- ${PWD}/mgodb:/data/db
restart: always
elasticsearch:
image: deepzz0/elasticsearch:2.4.1
volumes:
- ${PWD}/esdata:/usr/share/elasticsearch/data
restart: always
eiblog:
iamge: deepzz0/eiblog:latest
volumes:
- ${PWD}/conf:/app/conf
extra_hosts:
- "disqus.com:151.101.192.134"
links:
- elasticsearch
- mongodb
ports:
- 9000:9000
restart: always
backup:
image: deepzz0/backup:latest
volumes:
- ${PWD}/conf:/app/conf
links:
- mongodb
restart: always
当启动成功之后,后续的代理配置请参考 eiblog/eiblog.conf
。