DOClever是一個(gè)商業(yè)化開源產(chǎn)品，完全免費(fèi)。無論你是前端工程師，還是后端工程師，接口永遠(yuǎn)都是兩者交互的橋梁，所以DOClever專為中小型團(tuán)隊(duì)量身打造，旨在解決接口的管理，測試與數(shù)據(jù)生成，實(shí)現(xiàn)真正的一體化解決方案。

本次開源的是DOClever的內(nèi)網(wǎng)版本，可以直接部署到內(nèi)網(wǎng)中，和線上版本在功能上是完全一樣的，區(qū)別在于：

1、線上的系統(tǒng)用了前端和后端兩套工程，并且用nginx做了負(fù)載均衡，redis做緩存，而內(nèi)網(wǎng)版本合并為一個(gè)工程，直接用node做靜態(tài)服務(wù)器，取消了緩存，這樣對于很多中小型團(tuán)隊(duì)來說很輕便而且也夠用了。

2、線上系統(tǒng)在安全性方面做了不少加固處理，而內(nèi)網(wǎng)版本默認(rèn)內(nèi)網(wǎng)是安全的，也為了提高node作為服務(wù)器的效率，取消了很多加固處理，如果用戶有需要可以自行添加。

3、開源版本去掉了線上的宣傳和介紹頁面，只留下最精簡的功能頁面。

DOClever有哪些功能

1、可以對接口信息進(jìn)行編輯管理，支持get,post,put,delete,patch五種方法，支持http和https協(xié)議，并且支持query，body，json，raw，rest，formdata的參數(shù)可視化編輯。同時(shí)對json可以進(jìn)行無限層次可視化編輯。并且，狀態(tài)碼，代碼注入，markdown文檔等附加功能應(yīng)有盡有。

2、接口調(diào)試運(yùn)行，一個(gè)都不能少，可以對參數(shù)進(jìn)行加密，從md5到aes一應(yīng)俱全，返回參數(shù)與模型實(shí)時(shí)分析對比，給出不一致的地方，找出接口可能出現(xiàn)的問題。如果你不想手寫文檔，那么試試接口的數(shù)據(jù)生成功能，可以對接口運(yùn)行的數(shù)據(jù)一鍵生成文檔信息。

3、mock的無縫整合，DOClever自己就是一個(gè)mock服務(wù)器，當(dāng)你把接口的開發(fā)狀態(tài)設(shè)置成已完成，本地mock便會(huì)自動(dòng)請求真實(shí)接口數(shù)據(jù)，否則返回事先定義好的mock數(shù)據(jù)。

4、支持postman，rap，swagger的導(dǎo)入，方便你做無縫遷移，同時(shí)也支持html文件的導(dǎo)出，方便你離線瀏覽!

5、項(xiàng)目版本和接口快照功能并行，你可以為一個(gè)項(xiàng)目定義1.0，1.1，1.2版本，并且可以自由的在不同版本間切換回滾，再也不怕接口信息的遺失，同時(shí)接口也有快照功能，當(dāng)你接口開發(fā)到一半或者接口需求變更的時(shí)候，可以隨時(shí)查看之前編輯的接口信息。

6、自動(dòng)化測試功能，目前市面上類似平臺(tái)的接口自動(dòng)化測試大部分都是偽自動(dòng)化，對于一個(gè)復(fù)雜的場景，比如獲取驗(yàn)證碼，登陸，獲取訂單列表，獲取某個(gè)特定訂單詳情這樣一個(gè)上下文關(guān)聯(lián)的一系列操作無能為力。而DOClever獨(dú)創(chuàng)的自動(dòng)化測試功能，只需要你編寫極少量的javascript代碼便可以在網(wǎng)頁里完成這樣一系列操作，同時(shí)，DOClever還提供了后臺(tái)定時(shí)批量執(zhí)行測試用例并把結(jié)果發(fā)送到團(tuán)隊(duì)成員郵箱的功能，你可以及時(shí)獲取接口的運(yùn)行狀態(tài)。

7、團(tuán)隊(duì)協(xié)作功能，很多類似的平臺(tái)這樣的功能是收費(fèi)的，但是DOClever覺得好東西需要共享出來，你可以新建一個(gè)團(tuán)隊(duì)，并且把團(tuán)隊(duì)內(nèi)的成員都拉進(jìn)來，給他們分組，給他們分配相關(guān)的項(xiàng)目以及權(quán)限，發(fā)布團(tuán)隊(duì)公告等等。

8、DOClever開源免費(fèi)，支持內(nèi)網(wǎng)部署，很多公司考慮到數(shù)據(jù)的安全性，不愿意把接口放到公網(wǎng)上，沒有關(guān)系，DOClever給出一個(gè)方便快捷的解決方案，你可以把平臺(tái)放到自己的內(nèi)網(wǎng)上，完全不需要連接外網(wǎng)，同時(shí)功能一樣也不少，即便是對于產(chǎn)品的升級(jí)，DOClever也提供了很便捷的升級(jí)方案!

源碼結(jié)構(gòu)

Server為服務(wù)端，Client為網(wǎng)頁端，Desktop為桌面端(編譯桌面端需要安裝electron相關(guān)npm包)

如何部署

1.首先本地要安裝node環(huán)境，推薦8.11.1版本

2.安裝mongodb，可使用robomongo來作為mongodb的客戶端工具，啟動(dòng)mongodb后，用robomongo來連接，新建一個(gè)database作為DOClever的數(shù)據(jù)庫(名稱隨意)

源碼部署

將DOClever的源碼down到本地，在命令行下運(yùn)行node DOClever的根目錄/Server/bin/www(如果是windows環(huán)境下，請修改目錄分隔符)，第一次啟動(dòng)，會(huì)出現(xiàn)命令行提示符，按照提示符輸入即可完成相關(guān)的配置，等到DOClever啟動(dòng)成功后， 在瀏覽器里輸入localhost:DOClever啟動(dòng)的端口號(hào),出現(xiàn)首頁表示部署成功。

npm部署

在命令行下運(yùn)行npm install doclever -g，等doclever包安裝成功后，運(yùn)行doclever進(jìn)行第一次配置(如果有問題，就運(yùn)行doclever --installwithsetup)