>作者：悠悠做神仙
> 
>來源：[恆生LIGHT雲社群](https://developer.hs.net/thread/1185)

###### 需求背景：

> 我們一個小組，組長希望搭建一個知識庫框架，考慮資料安全，同時不能太過複雜，可快速搭建起來並投入使用（因為沒有豐富的機器資源給我們:daku:）。

可見，最後這個任務還是交給我了。:chi:

###### 技術選型：

目前，已知一些比較好的可以作為知識庫的框架，給組長反饋，但是都被打回來了。比如：

* 語雀：雖然使用體驗極佳，但是老大覺得資料不安全，畢竟是阿里的雲知識庫。
* 石墨文件：理由也是安全形度，畢竟石墨文件也是雲知識庫。
* Confluence：10人以下免費，超過就要花錢，而且相對而言建立和部署比較複雜。
* 騰訊文件等，理由就是從資料安全形度，以及資源維護來說，統統被pass掉。

正當苦惱的時候，一個小而美的只是框架映入眼簾，沒錯就是接下來要的——**Raneto**。

話不多說，“翠花，上乾貨！”

![](https://img0.baidu.com/it/u=1643368871,1584657112&fm=15&fmt=auto&gp=0.jpg)

### 1、初始Raneto

Raneto官網：[http://docs.raneto.com/](http://docs.raneto.com/)

Raneto Git地址：[https://github.com/gilbitron/Raneto/](https://github.com/gilbitron/Raneto/)

（看這簡潔大氣的佈局，i了i了）

![raneto官網.jpg](https://developer.hs.net/storage/attachments/2021/07/07/xppFA1vuvTYOGcPmqx9impWwDDIKeagzPrbe7B8q_thumb.jpg "2062")

官網介紹如下：

> Raneto 是[Node.js](http://nodejs.org/)的知識庫平臺，它使用靜態 [Markdown](http://daringfireball.net/projects/markdown)檔案來支援知識庫。

> Raneto 可以稱為“靜態站點生成器”，因為它不需要資料庫。您的所有內容都儲存在 `content`Markdown ( `.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/en/download/)

![node官網.jpg](https://developer.hs.net/storage/attachments/2021/07/07/fbo4f0CPHcKOySQYmzLA0XGnwbCpGgroe83YpO2U_thumb.jpg "2064")

但是，考慮到官網連結有時候不太穩定，而且，一般官網都是最新版本，我們本身可能用不到這麼新的版本，別急，這裡給大家準備了一個以往版本的下載資源：

[https://nodejs.org/zh-cn/download/releases/](https://nodejs.org/zh-cn/download/releases/)

![node.js以往版本.jpg](https://developer.hs.net/storage/attachments/2021/07/07/0igYRWQjRYPxvNgUxlZOPny4vyV6hT16dgRFOWDt_thumb.jpg "2063")

小仙這裡用的版本是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安裝配置](https://www.runoob.com/nodejs/nodejs-install-setup.html)

### 4、疑難解決--安裝Node.js失敗、npm下載緩慢等

有些同學，可能本身機器上已經安裝了比較老的Node.js，或者安裝的Node.js與機器上本來的npm版本不一致，那麼就會有各種各樣的報錯。

如果遇到和npm版本不相容，可以考慮先解除安裝Node.js，然後看一下Node.js和npm版本對照。

[Node.js和npm版本對照]([https://nodejs.org/zh-cn/download/releases/](https://nodejs.org/zh-cn/download/releases/))

![版本對照.jpg](https://developer.hs.net/storage/attachments/2021/07/07/hAICbwNRPwB3myeJkynHbQ9OKDNVa0Rk944odii3_thumb.jpg "2066")

版本不一致，或者以前有老的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](http://registry.npmjs.org/)

因為npm的遠端伺服器在國外，所以有時候難免出現訪問過慢，甚至無法訪問的情況。

檢視當前npm倉庫地址命令：`npm config get registry`

不要灰心，淘寶為我們搭建了一個國內的npm伺服器，它目前是每隔10分鐘將國外npm倉庫的所有內容“搬運”回國內的伺服器上，這樣我們直接訪問淘寶的國內伺服器就可以了。

它的地址是：[https://registry.npm.taobao.org](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](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/
```

安裝啟動完成，是不是滿滿的成就感！

![啟動.jpg](https://developer.hs.net/storage/attachments/2021/07/07/Q78qDYRUAHkDkgEw8P9pTU32pwXOnwISLenpx33b_thumb.jpg "2067")

**安裝方法二：**

此方法是直接將Raneto從Git庫，克隆下來，然後安裝npm模組並啟動。

前提就是，伺服器已安裝git。

```
git clone https://github.com/gilbitron/Raneto.git
cd Raneto
npm install
npm start
```

---

安裝完成，是不是感覺很簡單，成就感爆棚，先給自己點個贊！（別忘了給小仙來個一鍵三連啊，點贊+收藏+關注:xieyanxiao:）

![](https://img1.baidu.com/it/u=2749850757,2624841770&fm=26&fmt=auto&gp=0.jpg)

有的同學說了，“這都是英文，也不知道怎麼用……”

別急，除了官方文件裡面會有說明怎麼使用，小仙也整理了一篇教大家進行定製使用的文章，指個路：[手把手教你搭建Raneto知識庫框架（二）](https://developer.hs.net/thread/1139)。

手把手教你搭建Raneto知識庫框架（一）

相關文章