使用轻量应用服务器部署 Docsify 在线文档平台
编者按：本文来自轻量应用服务器征文活动用户投稿，已获得作者（昵称 CS 社）授权发布。
无论是出于兴趣爱好需要搭建个人博客，还是工作需要建设信息发布站点，都需要一个信息管理平台或者叫 CMS。如果你的经费有限、重在呈现文字内容而不在乎界面，那么本文或许会对你有所帮助——使用阿里云的轻量应用服务器来部署 Docsify 在线文档平台实现快速建站。
Docsify 是完全的静态网站，无需费力配置和维护数据库和管理后台。与 WordPress、织梦这样的类博客系统相比，Docsify 真的很简单，它基于 MarkDown 文档，可以直接像写文章或说明文档一样写网页，可以说比写 WORD 都要轻松。用 MD 文档的形式来管理内容，方便内容的更新、迁移和备份；同时借助阿里云轻量应用服务器的快速部署特性，只需要不到半小时就可以完成快速建站。
Docsify 官网地址：https://docsify.js.org/#/，网站本身就是用 Docsify 搭建的。作为一个开源项目，Docsify 提供了丰富的 API，并且具备全文搜索功能。
当然为了方便后期维护站点需要，我们可以先在阿里云轻量服务器上部署宝塔面板作为基础。通过宝塔面板来维护 Docsify，非常便捷，解决了文件管理和必要的 Web 服务配置问题。
接下来看一下详细的部署过程吧~
01 购买服务器并完成初始化
1、创建服务器
选择阿里云的轻量应用服务器。由于我们只是一个信息发布系统，选最低配置就可以满足需求。
2、选择宝塔镜像
建议直接使用预装了宝塔面板镜像，这样可以节省我们搭建应用服务的时间。而且宝塔面板非常人性化，免去了配置 Linux 服务的繁琐步骤。
02 配置服务器基础信息
购买完服务器并完成初始化后，就可以设置绑定站点域名并做好 ICP 备案工作。
可直接在阿里云上申请并设置域名解析。主机名就是域名前缀，默认的主机名一般是 www(万维网），而 @就是无域名前缀。添加 A 记录指向你租用的阿里云轻量服务器的公网地址，IP 填在记录值里。当然你也可以添加其他字母数字组合作为主机名，实现分站点。
03 宝塔面板配置
1、安全设置
在点击应用部署首页进入宝塔面板后，可以非常方便的管理 Linux 服务器。由于可以通过 Web 直接从公网访问到，因此建议进行安全设置，指定端口号。这样可以降低服务器被黑客的自动扫描脚本检测到和被入侵的风险。同时设置安全入口相当于在用户密码前加了一道锁，进一步提高安全性。
需要注意由于面板的访问端口发生改变，需要同时修改阿里云轻量防火墙的策略，否则页面无法访问。设置的端口号需与宝塔面板的端口号一致。
2、WEB 服务配置
启动网站服务前，需要先安装 WEB 服务，建议选择宝塔面板中软件商店里的 Nginx 服务,相比 Tomcat 占用内存很少，性能更好，更适合轻量应用服务器。安装之后别忘了点击启动服务。
之后就可以选择网站选项，添加网站站点，输入注册好的域名主机名。需要注意的是网站的根目录位置，稍后我们需要将内容网页上传到这个目录下
我之前已经设置好了 DNS 域名解析，就可以直接在浏览器中输入配置好的域名网址进行访问。看到下图说明宝塔面板上的 web 网站配置已生效。
3、通过宝塔面板上传项目
虽然 FTP 是常用的网站上传工具，但宝塔的文件功能非常适合作为网站管理工具。直接选择宝塔面板主菜单上的文件选项，点击上传，选择本地网站文件或目录上传即可。
04 通过 Node.js 在本地生成 Docsify 项目
完成服务器的配置后，我们需要先在本地生成 Docsify 项目。由于 Docsify 这个 JavaScript 前端开源项目本身托管在 Node.js 的 NPM 包管理器上，所以生成 Docsify 前需要先安装 Node.js。
1、安装 Node.js
首先确定你的电脑上安装了 Node.js，建议安装 LTS（长期支持稳定版）的 16.13 版。
2、NPM 镜像源切换
由于 Node.js 的 NPM 包管理器在境外下载速度偏慢，建议先安装好 Node.js 后，先切换 NPM 源到国内的镜像。比如淘宝的 CNPM 服务器。在命令行中完成切换：
安装之后若看到下方截图说明安装 CNPM 成功：
3、用 CNPM 工具安装 docsify-cli
在命令行中输入下方指令：
安装之后若看到下方截图说明安装 Docsify 成功：
4、切换到你需要的目录下，生成 Docsify 项目
在命令行中输入下方指令：
如果初始化成功会弹出下面的提示：
在你指定的目录下生成 Docsify 的初始页面文件。
5、查看项目页面效果
在命令行中输入下方指令：
这时如果返回下面的提示，说明服务已启动可以查看效果了。
打开浏览器就可以看到一个空白的初始 Docsify 文档站已经建成了。
05 编辑和配置 Docsify 项目
我们的站点不能只有一行主题词，需要为站点添加内容。最简单的方法是直接编辑项目 docs 目录下的 README 文档，保存文档并刷新浏览器之后，你编辑的内容会直接呈现在网页中。MarkDown 的段落和语法非常好理解，建议直接看官方文档：
https://www.markdownguide.org/basic-syntax/
当然 Docsify 的高级功能比如侧边栏、导航栏和搜索框等功能都需要在 docs 目录下的 index.html 中进行配置才会生效。
1、 配置侧边栏和导航栏
通过在 index.html 中的 script 的 window.$docsify 中插入以下代码可以开启相关功能。
开启之后会出现如下图所示的侧边栏，可以显示多级标题：
2、 配置全文搜索栏目
需要先在 index.html 中添加引用 Docsify 搜索插件的代码：
然后再通过在 index.html 中 script 的 window.$docsify 中加入以下代码可以实现：
开启之后会出现如下图所示的搜索栏，实现全文搜索：
3、 拓展资源推荐
由于 Docsify 是一个开源项目，所以在 Github 上可以搜索到大量的相关丰富的插件和样例。以下两个网址供读者自己去探索拓展（点击即可跳转）：
总结：
很多大公司都在用 Docsify 去做一些企业级的应用，对于个人用户而言，它也是是一个“万金油”的宝藏，可以用来做个人博客、说明文档、程序或代码管理等很多事情。希望上面的教程能够抛砖引玉，期待大家解锁轻量应用服务器更多实用、好玩的功能。
点击参与体验，查看轻量应用服务器更多的产品及活动信息。
版权声明: 本文为 InfoQ 作者【阿里云弹性计算】的原创文章。
原文链接:【http://xie.infoq.cn/article/32742e657ff5609016d3825e7】。文章转载请联系作者。
澎湃算力，无处不在。 2018.08.24 加入
阿里云弹性计算团队，关注虚拟化、通用计算、异构计算以及云上HPC和云上运维CloudOps。
评论