### 安装 1、`Eiblog`提供多个平台的压缩包下载，可到[Eiblog release](https://github.com/eiblog/eiblog/releases)选择相应版本和平台下载。也可通过： ``` sh $ 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`，相信你会亲自动手，你可以通过： ``` sh $ go get https://github.com/eiblog/eiblog ``` 进行源码编译二进制文件运行。 3、如果你对`docker`技术也有研究的话，你也可以通过`docker`来安装： ``` sh $ docker pull registry.cn-hangzhou.aliyuncs.com/deepzz/eiblog:v1.2.0 ``` 镜像内部只提供了`eiblog`的二进制文件，因为其它内容定制化的需求过高。所以需要将`conf`、`static`、`views`目录映射出来，后面会具体说到。 ### 本地测试 在我们下载好可执行程序之后，我们可以开始本地测试的工作了。 本地测试需要搭建两个服务`mongodb`和`elasticsearch2.4.1`（可选，搜索服务不可用）。 `Eiblog`默认会连接`hostname`为`mongodb`和`elasticsearch`，因此你需要将信息填入`/etc/hosts`下。假如你搭建的`mongodb`地址为`127.0.0.1:27017`，`elasticsearch`地址为`192.168.99.100:9200`，如： ``` sh $ sudo vi /etc/hosts # 在末尾加上两行 172.42.0.1 mongodb 192.168.99.100 elasticsearch ``` #### MongoDB 搭建 1、`MongoDB`搭建，Mac 可通过`brew install mongo`进行安装，其它平台请查询资料。 #### Elasticsearch 搭建 2、`Elasticsearch`搭建，它的搭建要些许复杂。博主尚未接触如何直接安装，因此建议通过`docker`搭建。需要注意的是 es 自带的分析器对中文分词是不友好的，这里采用了`elasticsearch-analysis-ik`分词器。如果你想了解更多[Github](https://github.com/medcl/elasticsearch-analysis-ik)或则如何实现[博客站内搜索](https://imququ.com/post/elasticsearch.html)。 * 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 的命令为： ``` sh $ 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`，那么请确保你的 CDN 中已经上传以下文件： * `favicon.ico`，默认为`st.example.com/static/img/favicon.ico`。故你在 CDN 中的文件名为`static/img/favicon.ico`，以下如是。 * `bg04.jpg`，左侧背景图片，`500*1200`左右，CDN 中文件名：`static/img/bg04.jpg`。如需更改，请在`eiblog/view/st_blog.css`中替换该名称。 * `avatar.jpg`，左侧头像，`160*160~256*256`之间，CDN 文件名：`static/img/avatar.jpg`。另外你需要将该图片 `Base64` 编码后替换掉`eiblog/views/st_blog.css`中合适位置的图片。 * `blank.gif`，CDN 文件名：`static/img/blank.gif`。该图片请从[这里](https://st.deepzz.com/static/img/blank.gif)下载并上传至你的 CDN。 * `default_avatar.png`，Disqus 默认头像，CDN 文件名：`static/img/default_avatar.png`，请从[这里](https://st.deepzz.com/static/img/default_avatar.png)下载并上传至你的 CDN。 * `disqus.js`，通过 https://short_name.disqus.com/embed.js 下载，替换掉 short_name。CDN 文件名格式是：`static/js/disqus_xxx.js`。在我写这篇文章是使用的是：`static/js/disqus_a9d3fd.js`。另外修改`eiblog/views/st_blog.js`中的`disqus_a9d3fd.js`为你新文件的名称。 > 注意：每次修改 views 内的以 `st_` 开头的文件，请将 `app.yml` 中的 staticversion 提高一个版本。 #### 配置说明 走到这里，我相信只走到`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 # 模版文件 ├── crossdomainTpl.xml ├── feedTpl.xml ├── opensearchTpl.xml ├── robotsTpl.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 配置之完整篇](https://imququ.com/post/my-nginx-conf.html)查看，了解详情。 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`下。 ``` sh $ tree /data/eiblog -L 1 ├── conf ├── static ├── views ``` 然后，将镜像 PULL 到服务器本地。 ``` sh # PULL下Eiblog镜像 $ docker pull registry.cn-hangzhou.aliyuncs.com/deepzz/eiblog ``` 最后，执行`docker run`命令，希望你能成功。 ``` sh $ docker run -d --name eiblog --restart=always \ --add-host disqus.com:23.235.33.134 \ --add-host mongodb:172.42.0.1 \ --add-host elasticsearch:192.168.99.100 \ -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 配置完整篇](https://imququ.com/post/my-nginx-conf.html)。 首先，请将本地测试好的`conf`，`static`，`views`，`docker-compose.yml`文件夹和文件上传至服务器。前三个文件夹建议存储到服务器`/data/eiblog`下，`docker-compose.yml`存放在你使用方便的地方。 > 注意检查`conf/es/config/scripts`空文件夹是否存在 ``` sh $ tree /data/eiblog -L 1 ├── conf ├── static ├── views $ ls ~/ docker-compose.yml ``` 然后，执行： ``` sh $ cd ~ $ docker-compose up -d ``` 等待些许时间，成功运行。