推薦一款接口文檔在線管理系統-MinDoc

項目簡介

MinDoc 是一款針對IT團隊開發的簡單好用的文檔管理系統。

MinDoc 的前身是 SmartWiki 文檔系統。SmartWiki 是基於 PHP 框架 laravel 開發的一款文檔管理系統。因 PHP 的部署對普通用戶來講太複雜，因此改用 Golang 開發。能夠方便用戶部署和實用，同時增長Markdown和HTML兩種編輯器。

開發緣起是公司IT部門須要一款簡單實用的項目接口文檔管理和分享的系統。其功能和界面源於 kancloud 。

能夠用來儲存平常接口文檔，數據庫字典，手冊說明等文檔。內置項目管理，用戶管理，權限管理等功能，可以知足大部分中小團隊的文檔管理需求。

主要功能

• 項目管理，能夠對項目進行編輯更改，成員添加等。
• 文檔管理，添加和刪除文檔，文檔歷史恢復等。
• 用戶管理，添加和禁用用戶，我的資料更改等。
• 用戶權限管理 ， 實現用戶角色的變動。
• 項目加密，能夠設置項目公開狀態，私有項目須要經過Token訪問。
• 站點配置，二次開發時能夠添加自定義配置項。
• 附件管理，可管理全部項目中上傳的文件。
• 項目導出，目前支持導出 PDF 格式項目。

主要技術

beego 1.8.0、editor.md、bootstrap 3.二、jquery 1.八、layer 彈出層框架、webuploader 文件上傳框架、Nprogress 庫、jstree、font awesome 字體庫、cropper 圖片剪裁庫

演示

示例：http://doc.52itstyle.com/

安裝環境

centos6.八、MySql5.六、Nginx1.10.三、go1.7.三、GLIBC_2.14

安裝數據庫

已安裝過的請自行忽略。

#查看全部以mysql開頭的軟件
yum list mysql*
#安裝mysql
yum install mysql-server* -y
#啓動mysql
/etc/init.d/mysqld start
#設定mysql自動啓動
chkconfig mysqld on
#複製mysql的配置文件到etc目錄，提示是否覆蓋，選擇y
cp /usr/share/mysql/my-medium.cnf   /etc/my.cnf
#從新設定mysql密碼，默認密碼是【空】，輸入新密碼，注意提問，是否刪除匿名帳戶？【y】  是否禁止遠程登陸？【n】是否移除test數據庫?【y】是否重載權限文件【y】
mysql_secure_installation
#重啓mysql，此時用本機Navicat Premium仍是連不上mysql的！
/etc/init.d/mysqld restart
#用命令訪問mysql
mysql -u root -p
#使用mysql數據庫
use mysql;
#查詢當前用戶狀況，顯示有3條記錄，127.0.0.1；localhost；iz28wi3pigtz；其中最後這個是ECS主機名
select host,user from user;
#把localhost這條記錄的host改成 %； 意思是root能夠由任何主機登陸mysql，網上不少寫法，都沒有and host='localhost'這個條件，常常報錯。
update user set host = '%' where user = 'root' and host='localhost';
#再次查詢，能夠看到host有3個；%；127.0.0.1；iz28wi3pigtz；其實user表的主鍵是user字段和host字段的聯合主鍵。
select host, user from user;
#重啓mysql
/etc/init.d/mysqld restart

安裝go環境

1、源碼安裝

wget https://storage.googleapis.com/golang/go1.7.3.linux-amd64.tar.gz

#將文件解壓到/use/local/路徑下(路徑能夠本身定義)

tar -zxf go1.7.3.linux-amd64.tar.gz -C /usr/local/

配置環境變量

vi /etc/profile
#追加配置
export PATH=$PATH:/usr/local/go/bin
#刷新配置使其生效
source /etc/profile

2、RPM包安裝

rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
yum install golang -y

3、 YUM源安裝

yum install -y golang

安裝成功後，查看go版本

[root@AY140216149Z ~]# go version
go version go1.7.3 linux/amd64

升級glibc版本

查看glibc版本

[root@AY140216131049Z ~]# strings /lib64/libc.so.6 |grep GLIBC_
GLIBC_2.2.5
GLIBC_2.2.6
GLIBC_2.3
GLIBC_2.3.2
GLIBC_2.3.3
GLIBC_2.3.4
GLIBC_2.4
GLIBC_2.5
GLIBC_2.6
GLIBC_2.7
GLIBC_2.8
GLIBC_2.9
GLIBC_2.10
GLIBC_2.11
GLIBC_2.12

mindoc至少須要2.14版本以上glibc，因此須要本身手動升級

#下載2.14版本
wgte https://ftp.gnu.org/gnu/glibc/glibc-2.14.tar.gz
#解壓編譯安裝
tar -xzvf glibc-2.14.tar.gz
cd glibc-2.14
./configure --prefix=/opt/glibc-2.14
make && make install

視機器性能，編譯安裝時間大概須要將近5-10分鐘，請耐心等待,安裝完成以後

#備份
cp  /lib64/libc.so.6   /lib64/libc.so.6.bak
#刪除前必定要備份
rm -rf /lib64/libc.so.6
#建立軟鏈接
ln -s /opt/glibc-2.14/lib/libc-2.14.so /lib64/libc.so.6

查看版本，若是發現2.14說明配置成功

[root@AY140216131049Z build]# strings /lib64/libc.so.6 |grep GLIBC_
GLIBC_2.2.5
GLIBC_2.2.6
GLIBC_2.3
GLIBC_2.3.2
GLIBC_2.3.3
GLIBC_2.3.4
GLIBC_2.4
GLIBC_2.5
GLIBC_2.6
GLIBC_2.7
GLIBC_2.8
GLIBC_2.9
GLIBC_2.10
GLIBC_2.11
GLIBC_2.12
GLIBC_2.13
GLIBC_2.14
GLIBC_PRIVATE

安裝 mindoc

第一步 下載可執行文件

請從 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;

第四步 配置數據庫

請將剛纔解壓目錄下 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

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

第五步 配置代理

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

Nginx 代理的配置文件以下：

server {
    listen       80;
    #此處應該配置你的域名：
    server_name  doc.52itstyle.com;
    charset utf-8;
    #此處配置你的訪問日誌，請手動建立該目錄：
    access_log  /var/log/nginx/doc.52itstyle.com.access.log;
    location ~ .*\.(ttf|woff2|eot|otf|map|swf|svg|gif|jpg|jpeg|bmp|png|ico|txt|js|css)$    {
        #此處將路徑執行 MinDoc 的跟目錄
        root  /mnt/domains/mindoc;
        expires 30m;
    }

    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;
    }
}

第六步 啓動程序

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

#後臺啓動
nohup ./mindoc_linux_amd64 &
# 重啓Nginx
nginx -s reload

界面展現：