eiblog/docs/install.md at 7775ea35a2f53a63f4d83d40ce17e6aff13d784e

mirrors2/eiblog

Fork 0

mirror of https://github.com/eiblog/eiblog.git synced 2026-02-04 13:52:26 +08:00

Files

deepzz0 7775ea35a2 update docs

2017-02-25 22:42:28 +08:00

12 KiB

Raw Blame History

安装

1、Eiblog提供多个平台的压缩包下载，可到Eiblog release选择相应版本和平台下载。也可通过：

$ curl -L https://github.com/eiblog/eiblog/releases/download/v1.0.0/eiblog-v1.0.0.`uname -s | tr '[A-Z]' '[a-z]'`-amd64.tar.gz > eiblog-v1.0.0.`uname -s | tr '[A-Z]' '[a-z]'`-amd64.tar.gz

2、如果有幸你也是Gopher，相信你会亲自动手，你可以通过：

$ go get https://github.com/eiblog/eiblog

进行源码编译二进制文件运行。

3、如果你对docker技术也有研究的话，你也可以通过docker来安装：

$ docker pull registry.cn-hangzhou.aliyuncs.com/deepzz/eiblog

镜像内部只提供了eiblog的二进制文件，因为其它内容定制化的需求过高。所以需要将conf、static、views目录映射出来，后面会具体说到。

本地测试

在我们下载好可执行程序之后，我们可以开始本地测试的工作了。

本地测试需要搭建两个服务mongodb和elasticsearch2.4.1（可选，搜索服务不可用）。

Eiblog默认会连接hostname为eidb和eisearch，因此你需要将信息填入/etc/hosts下。假如你搭建的mongodb地址为127.0.0.1:27017，elasticsearch地址为192.168.99.100:9200，如：

$ sudo vi /etc/hosts

# 在末尾加上两行
127.0.0.1       eidb
192.168.99.100  eisearch

MongoDB 搭建

1、MongoDB搭建，Mac 可通过brew install mongo进行安装，其它平台请查询资料。

Elasticsearch 搭建

2、Elasticsearch搭建，它的搭建要些许复杂。博主尚未接触如何直接安装，因此建议通过docker搭建。需要注意的是 es 自带的分析器对中文分词是不友好的，这里采用了elasticsearch-analysis-ik分词器。如果你想了解更多Github或则如何实现博客站内搜索。

pull 镜像docker pull elasticsearch:2.4.1，必需使用该版本。
添加环境变量ES_JAVA_OPTS: "-Xms512m -Xmx512m"，除非你想让你的服务器爆掉。

映射相关目录：

conf/es/config:/usr/share/elasticsearch/config
conf/es/plugins:/usr/share/elasticsearch/plugins
conf/es/data:/usr/share/elasticsearch/data
conf/es/logs:/usr/share/elasticsearch/logs

请将这四个目录映射至eiblog下的conf目录。如果你想查看更多，请查看docker-compose.yml文件。

总结一下，docker运行 es 的命令为：

$ docker run -d --name eisearch \
    -p 9200:9200 \
    -e ES_JAVA_OPTS: "-Xms512m -Xmx512m" \
    -v conf/es/config:/usr/share/elasticsearch/config \
    -v conf/es/plugins:/usr/share/elasticsearch/plugins \
    -v conf/es/data:/usr/share/elasticsearch/data \
    -v conf/es/logs:/usr/share/elasticsearch/logs \
    elasticsearch:2.4.1

之后执行./eiblog，咱们的eiblog就可以运行起来了。

通过127.0.0.1:9000可以进入博客首页，127.0.0.1:9000/admin/login进入后台登陆，账号密码为eiblog/conf/app.yml下的username和password。也就是初始账号密码deepz、deepzz。

注意，因为配置conf/app.yml均是博主自用配置。有些操作可能（如评论）会评论到我的博客，还请尽量避免，谢谢。

准备部署

如果你在感受了该博客的魅力了之后，仍然坚持想要搭建它。那么，恭喜你，获得的一款不想再更换的博客系统。下面，我们跟随步骤对部署流程进一步说明。

这里只提供Docker的相关部署说明。你如果需要其它方式部署，请参考该方式。

前提准备

这里需要准备一些必要的东西，如果你已准备好。请跳过。

一台服务器。
一个域名，国内服务器需备案。
有效的证书。一般使用免费的就可以。如：Let‘s Encrypt，另外qcloud、七牛也提供了免费证书的申请，均是全球可信。
七牛CDN。博客只设计接入了七牛cdn，相信该CDN服务商不会让你失望。
Disqus。作为博客评论系统，你得有翻墙的能力注册到该账号，具体配置我想又可以写一片博客了。简单说需要shorname和public key。
Google Analystic。数据统计分析工具。
Superfeedr。加速 RSS 订阅。
Twitter。希望你能够有一个twitter账号。

是不是这么多要求，很费解。其实当初该博客系统只是为个人而设计的，是自己心中想要的那一款。博主些这篇文章不是想要多少人来用该博客，而是希望对那些追求至极的朋友说：你需要这款博客系统。

文件准备

尽管大多数文件已经准备好。但有些默认的文件需要特别指出来，需要你在 CDN 上写特殊的路径。

假如你的 CDN 域名为st.example.com，那么：

favicon.ico，其 URL 应该是st.example.com/static/img/favicon.ico。故你在 CDN 中的文件名为static/img/favicon.ico，以下如是。
左侧背景图片，500*1200左右，CDN 中文件名：static/img/bg04.jpg。如需更改，请在eiblog/view/st_blog.css中替换该名称。
头像，160*160~256*256之间，CDN 文件名：static/img/avatar.jpg。另外你需要将该图片 Base64 编码后替换掉eiblog/views/st_blog.css中合适位置的图片。
blank.gif，CDN 文件名：static/img/blank.gif。该图片请从这里下载并上传至你的 CDN。
default_avatar.png，CDN 文件名：static/img/default_avatar.png，请从这里下载并上传至你的 CDN。
disqus.js，该文件名是会变的，每次更新如果没有提及就没有改变，更新说明在这里。CDN 文件名格式是：static/js/name.js。在我写这篇文章是使用的是：static/js/disqus_a9d3fd.js，请从这里下载并上传至你的 CDN。

注意：本人 CDN 做了防盗链处理，故请将这些资源上传至您的 CDN ，以免静态资源不能访问，请悉知。

配置说明

走到这里，我相信只走到60%的路程。放弃还来得及。

这里会对eiblog/conf下的所有文件做说明，希望你做好准备。

├── app.yml                         # 博客配置文件
├── blackip.yml                     # 博客ip黑名单
├── es                              # elasticsearch配置
│   ├── config                      # 配置文件
│   │   ├── analysis                # 同义词
│   │   ├── elasticsearch.yml       # 具体配置
│   │   ├── logging.yml             # 日志配置
│   │   └── scripts                 # 脚本文件夹
│   └── plugins                     # 插件文件夹
│       └── ik1.10.1                # ik分词器
├── nginx                           # nginx配置
│   ├── domain                      # 域名配置，nginx会读区改文件夹下的.conf文件
│   │   └── deepzz.conf
│   ├── ip.blacklist                # nginx ip黑名单
│   └── nginx.conf                  # nginx配置，请替换原有配置
├── scts                            # ct文件
│   ├── aviator.sct
│   └── digicert.sct
├── ssl                             # 证书文件，具体请看deepzz.conf
│   ├── dhparams.pem
│   ├── domain.key
│   ├── domain.pem
│   ├── full_chained.pem
│   └── session_ticket.key
└── tpl                             # 模版文件
    ├── feedTpl.xml
    ├── opensearchTpl.xml
    └── sitemapTpl.xml

1、app.yml，整个程序的配置文件，里面已经列出了所有配置项的说明，这里不再阐述。
2、blackip.yml，如果没有使用Nginx，博客内置ip过滤系统。
3、es全名elasticsearch，非常强大的分布式搜索引擎，github用的就是它。里面的配置基本不用修改，但es/analysis/synonym.txt是同义词，你可以照着已有的随意增加。

├── es
│   ├── config
│   │   ├── analysis
│   │   │   └── synonym.txt                 #同义词配置
│   │   ├── elasticsearch.yml               #分词器配置
│   │   ├── logging.yml                     #日志配置
│   │   └── scripts                         #脚本
│   └── plugins                             #中文分词插件
│       └── ik1.10.0
│

注意，scripts文件夹虽然是空的，但必需存在，不然elasticsearch报错。

4、nginx，系统采用nginx作为代理(相信博客系统也不会独占一台服务器～)。请使用nginx.conf替换原nginx的配置。博客系统的配置文件是domain/deepzz.conf，或则重命名(只要是满足*.conf)。deepzz.conf文件里面学问是最多的。或许你想一一弄懂，或许…。

注意本配置需要更新nginx到最新版，openssl更新到1.0.2j，具体请到 Jerry Qu 的本博客 Nginx 配置之完整篇查看，了解详情。

5、scts，存放 ct 文件。

6、ssl，这里存放了所有证书相关的内容。

├── dhparams.pem                #参见eiblog/conf/nginx/domain/deepzz.conf
├── domain.key                  #证书私钥，一般颁发者处下载
├── domain.pem                  #证书链，一般从证书颁发者那可以直接下载到
├── full_chained.pem            #参见eiblog/conf/nginx/domain/deepzz.conf
└── session_ticket.key          #参见eiblog/conf/nginx/domain/deepzz.conf

7、tpl模版相关，不用修改。

开始部署

docker

请确定你已经完成了上面所说的所有步骤，在本地已经测试成功。服务器上MognoDB和Elasticsearch已经安装并已经运行成功。

首先，请将本地测试好的conf，static，views文件夹上传至服务器，建议存储到服务器/data/eiblog下。

$ tree /data/eiblog -L 1

├── conf
├── static
├── views

然后，将镜像 PULL 到服务器本地。

# PULL下Eiblog镜像
$ docker pull registry.cn-hangzhou.aliyuncs.com/deepzz/eiblog

最后，执行docker run命令，希望你能成功。

$ docker run -d --name eiblog --restart=always \
    --add-host disqus.com:23.235.33.134 \
    --link eidb --link eisearch \
    -p 9000:9000 \
    -e GODEBUG=netdns=cgo \
    -v /data/eiblog/logdata:/eiblog/logdata \
    -v /data/eiblog/conf:/eiblog/conf \
    -v /data/eiblog/static:/eiblog/static \
    -v /data/eiblog/views:/eiblog/views \
    registry.cn-hangzhou.aliyuncs.com/deepzz/eiblog

这里默认MongDB和Elasticsearch均为docker部署，且名称为eidb，eisearch。

nginx + docker

通过Nginx+docker部署，是博主推荐的方式。这里采用Docker Compose管理我们整个博客系统。

请确认你已经成功安装好Nginx、docker、docker-compose。Nginx 请一定参照 Jerry Qu 的Nginx 配置完整篇。

首先，请将本地测试好的conf，static，views，docker-compose.yml文件夹和文件上传至服务器。前三个文件夹建议存储到服务器/data/eiblog下，docker-compose.yml存放在你使用方便的地方。

注意conf/es/config/scripts空文件夹是否存在

$ tree /data/eiblog -L 1

├── conf
├── static
├── views

$ ls ~/

docker-compose.yml

然后，执行：

$ cd ~
$ docker-compose up -d

等待些许时间，成功运行。

12 KiB Raw Blame History Unescape Escape

安装