怎么搭建自己的在線wiki文檔系統(tǒng)

MinDoc是什么?

MinDoc是一個(gè)在線的文檔管理系統(tǒng)，該系統(tǒng)適用于團(tuán)隊(duì)、個(gè)人等使用。開發(fā)者最初的目的是為了便于公司內(nèi)部使用，仿照看云開發(fā)。有l(wèi)aravel版本以及golang版本。不過laravel版本部署起來相當(dāng)麻煩，因?yàn)榈酱罱≒HP開發(fā)環(huán)境還需要自己配置，加上精力有限，暫停了laravel的研發(fā)。本文中用golang版本介紹如何安裝，安裝教程其實(shí)在GitHub是有的，但是在安裝中，發(fā)現(xiàn)作者有幾個(gè)地方寫的不夠完善，特此記錄此文。

如何獲取MinDoc

官網(wǎng),github,wiki,代碼下載,演示版本

搭建環(huán)境以及準(zhǔn)備工作

• 搭建環(huán)境沒有什么特殊的要求，只要能正常運(yùn)行的的系統(tǒng)即可，本文演示的是centos7.0，1核2G。

• redis搭建，看過作者的文章，沒發(fā)現(xiàn)必須要搭建redis，但是在實(shí)際的搭建中必須要求redis服務(wù)。搭建redis的步驟在如何搭建中介紹.

• mysql的版本，我是選擇的5.7,由于該演示版本屬于golang開發(fā)，對(duì)golang沒了解過，也不知道對(duì)mysql有啥版本要求，建議最低5.6.

如何搭建

該系統(tǒng)可以根據(jù)用戶自定義緩存驅(qū)動(dòng)，系統(tǒng)支持的有file緩存，memcached,redis等緩存方式。只需要修改配置文件中的如下配置，將file修改為你的緩存驅(qū)動(dòng)即可。我這里使用的redis作為緩存驅(qū)動(dòng)，下面介紹一下我安裝redis的過程與使用。

cache_provider="${MINDOC_CACHE_PROVIDER||file}"

• 下載redis,http://download.redis.io/releases/redis-4.0.11.tar.gz

• 解壓 tar -zxvf redis-4.0.11

• 創(chuàng)建軟連接便于后期版本更新 ln -s redis-4.0.11 redis

• 更新系統(tǒng)tcl,因?yàn)?.0對(duì)tcl最低要求在8.5，直接使用yum update tcl即可.安裝完成檢測(cè)一下是否安裝了gcc，yum install gcc即可安裝.

• 開始編譯安裝 cd redis && make && make test && make install.這幾步可以分開一步一步執(zhí)行也便于發(fā)現(xiàn)哪一步出錯(cuò)了.

• 設(shè)置redis以后臺(tái)進(jìn)程的方式運(yùn)行服務(wù).找到redis 目錄下面的redis.conf文件.將文件復(fù)制到/opt目錄下面(這個(gè)目錄自行定義)，這樣便于管理多個(gè)redis服務(wù).修改/opt下面的rdis.conf,將配置文件中daemonize no修改為daemonize yes.

• 啟動(dòng)服務(wù) redis-service /opt/redis.conf

配置golang系統(tǒng)環(huán)境變量并安裝

• 根據(jù)如何獲取中介紹的演示版本下載之后，進(jìn)行解壓并將所有的應(yīng)用程序移動(dòng)到/opt目錄下面(這個(gè)目錄可自行定義，在解壓之前最好創(chuàng)建一個(gè)目錄并把壓縮包移動(dòng)到這個(gè)目錄中去).

• 配置系統(tǒng)環(huán)境變量,我這里配置的是全局的系統(tǒng)環(huán)境變量,vim /etc/profile 將如下代碼添加到最底部export ZONEINFO=$PATH:/opt/lib/time/zoneinfo.zip，注意的是opt這里的目錄是你自行定義的.因?yàn)樯弦徊教峒暗搅宋乙苿?dòng)到/opt目錄了.

• 修改數(shù)據(jù)庫配置文件，配置文件在conf/app.conf文件中,填寫自己的數(shù)據(jù)庫配置信息即可.建議創(chuàng)建個(gè)新的賬號(hào)，授予部分權(quán)限http://www.qqdeveloper.com/a/76.html，可以看考該文章創(chuàng)建數(shù)據(jù)庫賬號(hào)。

• 授予權(quán)限和安裝 chmod +x mindoc_linux_amd64 && ./mindoc_linux_amd64 service install 這樣就能注冊(cè)到系統(tǒng)服務(wù)中了,也就是說是以后臺(tái)運(yùn)行的方式運(yùn)行服務(wù).

• 啟動(dòng)/停止/重啟服務(wù) service mindocd start/stop/restart這樣就安裝完畢了.直接使用http://ip:8181即可訪問.作者也貼出來如何使用域名管理的剛發(fā).代碼如下.

server {
    listen       80;
    #此處應(yīng)該配置你的域名：
    server_name  webhook.iminho.me;
    charset utf-8;
    #此處配置你的訪問日志，請(qǐng)手動(dòng)創(chuàng)建該目錄：
    access_log  /var/log/nginx/webhook.iminho.me/access.log;
    location / {
        try_files /_not_exists_ @backend;
    }
    # 這里為具體的服務(wù)代理配置
    location @backend {
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host            $http_host;
        proxy_set_header   X-Forwarded-Proto $scheme;
        #此處配置 MinDoc 程序的地址和端口號(hào)
        proxy_pass http://127.0.0.1:8181;
    }
}