如何安裝使用MinDoc搭建個人在線wiki文檔

MinDoc是什么?

MinDoc是一個在線的文檔管理系統，該系統適用於團隊、個人等使用。開發者最初的目的是為了便於公司內部使用，仿照看雲開發。有laravel版本以及golang版本。不過laravel版本部署起來相當麻煩，因為到搭建PHP開發環境還需要自己配置，加上精力有限，暫停了laravel的研發。本文中用golang版本介紹如何安裝，安裝教程其實在GitHub是有的，但是在安裝中，發現作者有幾個地方寫的不夠完善，特此記錄此文。

如何獲取MinDoc

官網,github,wiki,代碼下載,演示版本

搭建環境以及准備工作

• 搭建環境沒有什么特殊的要求，只要能正常運行的的系統即可，本文演示的是centos7.0，1核2G。
• redis搭建，看過作者的文章，沒發現必須要搭建redis，但是在實際的搭建中必須要求redis服務。搭建redis的步驟在如何搭建中介紹.
• mysql的版本，我是選擇的5.7,由於該演示版本屬於golang開發，對golang沒了解過，也不知道對mysql有啥版本要求，建議最低5.6.

如何搭建

搭建redis

• 下載redis,http://download.redis.io/releases/redis-4.0.11.tar.gz
• 解壓 tar -zxvf redis-4.0.11
• 創建軟連接便於后期版本更新 ln -s redis-4.0.11 redis
• 更新系統tcl,因為4.0對tcl最低要求在8.5，直接使用yum update tcl即可.安裝完成檢測一下是否安裝了gcc，yum install gcc即可安裝.
• 開始編譯安裝 cd redis && make && make test && make install.這幾步可以分開一步一步執行也便於發現哪一步出錯了.
• 設置redis以后台進程的方式運行服務.找到redis 目錄下面的redis.conf文件.將文件復制到/opt目錄下面(這個目錄自行定義)，這樣便於管理多個redis服務.修改/opt下面的rdis.conf,將配置文件中daemonize no修改為daemonize yes.
• 啟動服務 redis-service /opt/redis.conf

配置golang系統環境變量並安裝

• 根據如何獲取中介紹的演示版本下載之后，進行解壓並將所有的應用程序移動到/opt目錄下面(這個目錄可自行定義，在解壓之前最好創建一個目錄並把壓縮包移動到這個目錄中去).
• 配置系統環境變量,我這里配置的是全局的系統環境變量,vim /etc/profile 將如下代碼添加到最底部export ZONEINFO=$PATH:/opt/lib/time/zoneinfo.zip，注意的是opt這里的目錄是你自行定義的.因為上一步提及到了我移動到/opt目錄了.
• 修改數據庫配置文件，配置文件在conf/app.conf文件中,填寫自己的數據庫配置信息即可.建議創建個新的賬號，授予部分權限http://www.qqdeveloper.com/a/76.html，可以看考該文章創建數據庫賬號。
• 授予權限和安裝 chmod +x mindoc_linux_amd64 && ./mindoc_linux_amd64 service install 這樣就能注冊到系統服務中了,也就是說是以后台運行的方式運行服務.

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

  1. server {
  2. listen 80;
  3. #此處應該配置你的域名：
  4. server_name webhook.iminho.me;
  5. charset utf-8;
  6. #此處配置你的訪問日志，請手動創建該目錄：
  7. access_log /var/log/nginx/webhook.iminho.me/access.log;
  8. location / {
  9. try_files /_not_exists_ @backend;
  10. }
  11. # 這里為具體的服務代理配置
  12. location @backend {
  13. proxy_set_header X-Forwarded-For $remote_addr;
  14. proxy_set_header Host $http_host;
  15. proxy_set_header X-Forwarded-Proto $scheme;
  16. #此處配置 MinDoc 程序的地址和端口號
  17. proxy_pass http://127.0.0.1:8181;
  18. }
  19. }

  本文需要注意的地方

• 本文和作者的文章內容差不多，開頭也說了只是為了分享作者沒寫全的地方.

• 第1點，就是redis的安裝
• 第2點，就是安裝環節中的./mindoc_linux_amd64 service install，以注冊服務的方式安裝.雖然作者的文章后面也提及到這點，不過發現不好使.