Linux 下安裝和配置 MinDoc

Linux 下安裝和配置 MinDoc

步驟如下：

• 第一步 下載可執行文件
• 第二步 解壓壓縮包
• 第三步 創建數據庫
• 第四步 配置數據庫
• 第五步 啓動程序
• 第六步 配置代理

如果你的服務器上沒有安裝golang程序請手動設置一個環境變量如下：鍵名爲 ZONEINFO，值爲MinDoc根目錄下的/lib/time/zoneinfo.zip 絕對路徑。

如果下載的壓縮包中不存在該文件，請從 https://github.com/lifei6671/mindoc/blob/master/lib/time/zoneinfo.zip?raw=true 下載

不會修改Linux 環境變量的請移步： http://jingyan.baidu.com/article/ea24bc399a73bcda62b33104.html

在某些低版本的linux上可能需要將glibc庫升級到2.14版本。

第一步 下載可執行文件

請從 https://github.com/lifei6671/mindoc/releases 下載最新版的可執行文件，一般文件名爲 mindoc_linux_amd.tar.gz 或 mindoc_linux_amd64.zip 。

第二步 解壓壓縮包

請將剛纔下載的文件解壓，請執行如下命令解壓：

tar -xzvf mindoc_linux_amd64.tar.gz
或
unzip mindoc_linux_amd64.zip

第三步 創建數據庫

如果你使用的 mysql 數據庫，請創建一個編碼爲utf8mb4格式的數據庫，如果沒有GUI管理工具，推薦用下面的腳本創建：

CREATE DATABASE mindoc_db  DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;

---

如果你使用的是 sqlite 數據庫，請將 conf/app.conf 中的數據庫配置成如下,系統會自動創建 sqlite 數據庫文件：

db_adapter=sqlite3
db_database=mindoc_db

第四步 配置數據庫

請將剛纔解壓目錄下 conf/app.conf.example 重名爲 app.conf:

cp conf/app.conf.example conf/app.conf

同時配置如下節點：

#數據庫配置
db_adapter=mysql
#mysql數據庫的IP
db_host=127.0.0.1

#mysql數據庫的端口號一般爲3306
db_port=3306

#剛纔創建的數據庫的名稱
db_database=mindoc_db

#訪問數據庫的賬號和密碼
db_username=root
db_password=123456

在 MinDoc 根目錄下使用命令行執行如下命令，用於初始化數據庫：

./mindoc_linux_amd64 install

稍等一分鐘，程序會自動初始化數據庫，並創建一個超級管理員賬號：admin 密碼：123456

第五步 啓動程序

執行如下命令啓動程序：

#修改可執行權限
chmod +x mindoc_linux_amd64

#啓動程序
./mindoc_linux_amd64

此時訪問 http://localhost:8181 就能訪問 MinDoc 了。

第六步 配置代理

這一步可選，如果你不想用端口號訪問 MinDoc 就需要配置一個代理了。

Nginx 代理的配置文件如下：

server {
    listen       80;

    #此處應該配置你的域名：
    server_name  webhook.iminho.me;

    charset utf-8;

    #此處配置你的訪問日誌，請手動創建該目錄：
    access_log  /var/log/nginx/webhook.iminho.me/access.log;

    location / {
        try_files /_not_exists_ @backend;
    }

    # 這裏爲具體的服務代理配置
    location @backend {
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host            $http_host;
        proxy_set_header   X-Forwarded-Proto $scheme;

        #此處配置 MinDoc 程序的地址和端口號
        proxy_pass http://127.0.0.1:8181;
    }
}