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

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

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

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

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

DOClever有哪些功能

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

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

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

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

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

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

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

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

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

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

如何部署

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

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

源碼部署

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

npm部署

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