共计 4982 个字符，预计需要花费 13 分钟才能阅读完成。
作者：悠悠做神仙
起源：恒生 LIGHT 云社区
需要背景：
咱们一个小组，组长心愿搭建一个知识库框架，思考数据安全，同时不能太过简单，可疾速搭建起来并投入使用（因为没有丰盛的机器资源给咱们:daku:）。
可见，最初这个工作还是交给我了。
技术选型：
目前，已知一些比拟好的能够作为知识库的框架，给组长反馈，然而都被打回来了。比方：
- 语雀：尽管应用体验极佳，然而老大感觉数据不平安，毕竟是阿里的云知识库。
- 石墨文档：理由也是平安角度，毕竟石墨文档也是云知识库。
- Confluence：10 人以下收费，超过就要花钱，而且相对而言建设和部署比较复杂。
- 腾讯文档等，理由就是从数据安全角度，以及资源保护来说，通通被 pass 掉。
正当苦恼的时候，一个小而美的只是框架映入眼帘，没错就是接下来要的——Raneto。
话不多说，“翠花，上干货！”
1、初始 Raneto
Raneto 官网：http://docs.raneto.com/
Raneto Git 地址：https://github.com/gilbitron/Raneto/
（看这简洁大气的布局，i 了 i 了）
官网介绍如下：
Raneto 是 Node.js 的知识库平台，它应用动态 Markdown 文件来反对知识库。
Raneto 能够称为“动态站点生成器”，因为它不须要数据库。您的所有内容都存储在
contentMarkdown (.md) 文件中的文件夹中，整个知识库构造和内容由 Raneto 生成。这很好，因为它是：
- 简略： 您能够应用本人喜爱的文本编辑器创立和治理整个知识库
- Flat： Raneto 是一个“立体文件”CMS，意味着没有数据库问题，没有 MySQL 查问，什么都没有
- 疾速： Raneto 十分轻量级，并且不应用数据库，因而速度十分快
很想然，这个小东西十分合乎咱们的需要，反对 markdown，同时无需部署数据库，也不必部署一些服务，基于 Node.js，极其不便，上面咱们开始干活。
2、下载 Node.js
既然是基于 Node.js，咱们就须要先装置 Node.js。
首先，依据零碎，下载对应的 Node.js。
Node.js 官网：https://nodejs.org/en/download/
然而，思考到官网链接有时候不太稳固，而且，个别官网都是最新版本，咱们自身可能用不到这么新的版本，别急，这里给大家筹备了一个以往版本的下载资源：
https://nodejs.org/zh-cn/download/releases/
小仙这里用的版本是 Linux 的 V10.12.0 版本。
3、装置 Node.js
首先依照把须要的 Node.js 下载下来。能够抉择官网下载，也能够用上文提到的在历史版本里，依据零碎抉择下载。上面以 Linux 的 V10.12.0 装置为例：
[root@yyzsx /]# cd /usr/local/src/
[root@yyzsx src]# wget http://nodejs.org/dist/v10.12.0/node-v10.12.0.tar.gz
--2021-07-08 02:50:32-- http://nodejs.org/dist/v10.12.0/node-v10.12.0.tar.gz
正在解析主机 nodejs.org (nodejs.org)... 104.20.23.46, 104.20.22.46, 2606:4700:10::6814:172e, ...
正在连接 nodejs.org (nodejs.org)|104.20.23.46|:80... 已连贯。已收回 HTTP 申请，正在期待回应... 301 Moved Permanently
地位：https://nodejs.org/dist/v10.12.0/node-v10.12.0.tar.gz [追随至新的 URL]
--2021-07-08 02:51:36-- https://nodejs.org/dist/v10.12.0/node-v10.12.0.tar.gz
正在连接 nodejs.org (nodejs.org)|104.20.23.46|:443... 已连贯。已收回 HTTP 申请，正在期待回应... 200 OK
长度：36277157 (35M) [application/gzip]
正在保留至:“node-v10.12.0.tar.gz”100%[==============================================================================================================================>] 36,277,157 733KB/s 用时 50s
2021-07-08 02:52:26 (715 KB/s) - 已保留“node-v10.12.0.tar.gz”[36277157/36277157])
#解压 tar zxvf node-v0.10.24.tar.gz
[root@yyzsx src]# tar zxvf node-v10.12.0.tar.gz
#编译
[root@yyzsx src]# cd node-v10.12.0
[root@yyzsx node-v10.12.0]# ./configure --prefix=/usr/local/node/10.12.0
[root@yyzsx node-v10.12.0]# make
[root@yyzsx node-v10.12.0]# make install
#环境变量 vim /etc/profile
[root@yyzsx node-v10.12.0]# vim /etc/profile
#set for nodejs
export NODE_HOME=/usr/local/node/10.12.0
export PATH=$NODE_HOME/bin:$PATH
#:wq 保留并退出，编译 /etc/profile 使配置失效 source /etc/profile
[root@yyzsx node-v10.12.0]# source /etc/profile
#验证：node -v
[root@yyzsx node-v10.12.0]# node -v
v10.12.0
#npm 模块地址 /usr/local/node/0.10.24/lib/node_modules/
编译下载的时候，可能会下载迟缓或者下载失败，能够参考下一部分内容【4、疑难解决 – 装置 Node.js 失败、npm 下载迟缓等】。
其余零碎（windows、Mac OS 等）装置，能够参考：Node.js 装置配置
4、疑难解决 – 装置 Node.js 失败、npm 下载迟缓等
有些同学，可能自身机器上曾经装置了比拟老的 Node.js，或者装置的 Node.js 与机器上原本的 npm 版本不统一，那么就会有各种各样的报错。
如果遇到和 npm 版本不兼容，能够思考先卸载 Node.js，而后看一下 Node.js 和 npm 版本对照。
Node.js 和 npm 版本对照 )
版本不统一，或者以前有老的 Node.js，都须要先卸载再装置。
卸载 Node.js:
[root@yyzsx /]# yum remove nodejs npm –y
/usr/local/lib 删除所有 node 和 node_modules 文件夹
/usr/local/include 删除所有 node 和 node_modules 文件夹
/usr/local/bin 删除 node 的可执行文件
删除: /usr/local/bin/npm
删除: /usr/local/share/man/man1/node.1
删除: /usr/local/lib/dtrace/node.d
删除: rm -rf /home/[homedir]/.npm
删除: rm -rf /home/root/.npm
查看 ~ 文件夹外面的 "local" "lib" "include" 文件夹，而后删除外面的所有 "node" 和 "node_modules" 文件夹
能够应用以下命令查找:
find ~/ -name node
find ~/ -name node_modules对于 npm 下载太慢或失败解决：
npm 默认的仓库地址为：http://registry.npmjs.org
因为 npm 的近程服务器在国外，所以有时候不免呈现拜访过慢，甚至无法访问的状况。
查看以后 npm 仓库地址命令：npm config get registry
不要灰心，淘宝为咱们搭建了一个国内的 npm 服务器，它目前是每隔 10 分钟将国外 npm 仓库的所有内容“搬运”回国内的服务器上，这样咱们间接拜访淘宝的国内服务器就能够了。
它的地址是：https://registry.npm.taobao.org
所以针对下载迟缓或者失败的状况，有两种解决办法：
办法一：
间接装置淘宝提供的 cnpm，并更改服务器地址为淘宝的国内地址。
命令：npm install -g cnpm --registry=https://registry.npm.taobao.org 这样，当前用 npm 的时候，须要都换成 cnpm。
办法二（举荐）：
替换 npm 仓库地址为淘宝镜像地址
命令：npm config set registry https://registry.npm.taobao.org查看是否更改胜利：
[root@yyzsx /]# npm config get registry
https://registry.npm.taobao.org/
[root@yyzsx /]# 显示咱们设置的淘宝镜像地址，阐明批改胜利。这样，当前仍然用 npm 命令，然而理论是从淘宝国内服务器下载。
这里附上几个罕用的 Node 模块治理的命令：
显示版本：npm -v
装置模块：npm install xxx(模块名)
全局装置 xx 模块：npm install -g xxx(模块名)
显示模块的详情：npm show xxx(模块名)
列出曾经装置的模块：npm list
降级当前目录下的所有模块：npm update
降级当前目录下的指定模块：npm update xxx(模块名)
降级全局装置的模块：npm update -g xxx(模块名)
删除指定模块：npm uninstall xxx(模块名)
5、下载并装置 Raneto
通过 1 - 4 步，基本上环境曾经筹备好了，咱们当初下载咱们的配角：Raneto。
目前，Raneto 版本比拟多，然而思考到一些布局等，不倡议用比拟古老的版本，小仙下载了几个版本，最初综合布局以及和之前装置的 Node.js 版本对应下来，抉择了 V0.16.5 版本（也是后续的演示版本）。
装置形式依据下载方式的不同，有所差异，这里别离展现一下：
装置办法一（举荐）：
下载 Raneto 压缩包到本地，下载地址：https://codeload.github.com/gilbitron/Raneto/tar.gz/0.16.5
这个下载地址，输出后会主动下载，如果须要不同版本，只写批改最初的版本即可。
而后上传到你要部署的机器，指定一个地位。
# 解压
[root@yyzsx raneto]# tar zxvf Raneto-0.16.5.tar.gz
[root@yyzsx raneto]# cd /home/hundsun/raneto/Raneto-0.16.5
#装置模块 & 查看模块
[root@yyzsx Raneto-0.16.5]# npm install
[root@yyzsx Raneto-0.16.5]# ls node_modules/
#启动服务
[root@yyzsx Raneto-0.16.5]# npm start
#拜访, 默认端口号为 3000
http:// 服务器地址:3000/装置启动实现，是不是满满的成就感！
装置办法二：
此办法是间接将 Raneto 从 Git 库，克隆下来，而后装置 npm 模块并启动。
前提就是，服务器已装置 git。
git clone https://github.com/gilbitron/Raneto.git
cd Raneto
npm install
npm start装置实现，是不是感觉很简略，成就感爆棚，先给本人点个赞！（别忘了给小仙来个一键三连啊，点赞 + 珍藏 + 关注:xieyanxiao:）
有的同学说了，“这都是英文，也不晓得怎么用……”
别急，除了官网文档外面会有阐明怎么应用，小仙也整顿了一篇教大家进行定制应用的文章，指个路：手把手教你搭建 Raneto 知识库框架（二）。
