CentOS 7安装MinDoc文档系统-西瓜社

MinDoc 是一款使用Go语言开发的文档系统，支持Markdown排版，可用于个人Wiki知识库或接口文档管理，部署过程也比较简单，由于自己也需要在做一份游戏WIKI库，在此分享并记录一下。

[title]下载[/title]

访问https://github.com/lifei6671/mindoc/releases下载最新版本并解压，以下命令供参考,请根据实际情况调整。

#创建一个目录
mkdir mindoc && cd mindoc
#下载二进制包
wget https://github.com/lifei6671/mindoc/releases/download/v0.10.1/mindoc_linux_amd64.zip
#解压
unzip mindoc_linux_amd64.zip

#创建一个目录

mkdir mindoc && cd mindoc

#下载二进制包

wget https://github.com/lifei6671/mindoc/releases/download/v0.10.1/mindoc_linux_amd64.zip

#解压

unzip mindoc_linux_amd64.zip

[title]配置数据库[/title]

MinDoc支持Mysql或Sqlite3数据库，西瓜是个人使用，需求量不大，Sqlite3完全胜任要求，如果是团队使用可以考虑使用Mysql。修改conf/app.conf配置文件，将以下Mysql信息注释。

db_adapter=mysql
db_host=127.0.0.1
db_port=3306
db_database=mindoc_db
db_username=root
db_password=123456

db_adapter=mysql

db_host=127.0.0.1

db_port=3306

db_database=mindoc_db

db_username=root

db_password=123456

并取消Sqlite3的注释

adb_adapter=sqlite3
db_database=./database/mindoc.db

1 2	adb_adapter=sqlite3 db_database=./database/mindoc.db

[title]安装[/title]

输入命令./mindoc_linux_amd64 install初始化数据库，当看到“Install Successfully!”说明安装成功，如果报错，请根据报错提示进行排查。

图片[1]-CentOS 7安装MinDoc文档系统-西瓜社

[title]运行与访问[/title]

继续输入命令./mindoc_linux_amd64来启动MinDoc，看到下面的提示说明启动成功，输入http://IP:8181进行访问

图片[2]-CentOS 7安装MinDoc文档系统-西瓜社

如果访问不了，注意防火墙/安全组等放行8181端口，Firewalld放行命令如下：

firewall-cmd --zone=public --add-port=8181/tcp --permanent
firewall-cmd --reload

1 2	firewall-cmd --zone=public --add-port=8181/tcp --permanent firewall-cmd --reload

有关CentOS 7防火墙设置可参考相关博文

CentOS 7下Firewall常用命令

CentOS出现“FirewallD is not running”怎么办

访问http://IP:8181 可以打开了，默认用户名为admin，密码123456，请登录后修改。

图片[3]-CentOS 7安装MinDoc文档系统-西瓜社

图片[4]-CentOS 7安装MinDoc文档系统-西瓜社

如果您希望Mindoc在后台常驻运行，请输入nohup ./mindoc_linux_amd64 &来替代上面的启动命令。

[title]设置域名访问[/title]

通过http://IP:8181这样的方式访问显然不太友好也不便于记忆，可以使用Nginx反向代理绑定域名访问，以下Nginx配置供参考：

server {
  listen 80;
  server_name wiki.xgsa.net;
  access_log off;
  charset utf-8;

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

}