宝塔面板安装 MinDoc 文档管理系统的详细教程

MinDoc 是一款针对IT团队开发的简单好用的文档管理系统，前身是 SmartWiki 文档系统。而 SmartWiki 是基于 PHP 框架 laravel 开发的一款文档管理系统，因 PHP 的部署对普通用户来说太复杂，所以改用 Golang 开发，可以方便用户部署和使用。

MinDoc 开发缘起是公司IT部门需要一款简单实用的项目接口文档管理和分享的系统，其功能和界面源于kancloud。MinDoc 可以用来储存日常接口文档、数据库字典、手册说明等文档，内置项目管理、用户管理、权限管理等功能，能够满足大部分中小团队的文档管理需求。

Github地址：https://github.com/lifei6671/mindoc/releases

下面十一张（www.11zhang.com）分享一下用宝塔面板安装 MinDoc 文档管理系统的详细教程。

演示站点

地址：https://doc.11zhang.com

准备工作

1、服务器自行安装宝塔面板，安装方法文章：https://www.11zhang.com/30.html
2、宝塔面板配置好Golang环境，安装方法详见：https://www.11zhang.com/837.html
3、Nginx 1.22.1 环境（版本随意）
4、Supervisor 进程守护管理器
5、MinDoc 源码（推荐2.0版本），下载地址：https://www.11zhang.com/828.html

搭建教程

1、宝塔面板添加一个MinDoc站点（如 doc.11zhang.com），如果你的 MinDoc 站点想使用 MySQL 数据库，则数据库编码必须是 utf8mb4 格式，如下图；

PS：MinDoc支持MySQL或Sqlite3数据库，如果是个人使用，需求量不大，Sqlite3完全胜任要求，如果是团队使用，建议使用MySQL数据库。

2、下载 MinDoc 源码，解压后上传到网站的根目录（如 /www/wwwroot/doc.11zhang.com），如下图；

3、修改 conf/app.conf 配置文件，填写数据库类型、数据库名、用户名和密码，如下图；

PS：若需要修改默认端口和设置域名，请修改以下2个地方：

4、在 MinDoc 站点根目录下使用如下命令初始化数据库，稍等片刻，程序会自动初始化数据库，如下图：

####### 2.0版本 ####### 
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_amd64 install

####### 2.1版本及以上 #######
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_musl_amd64 install

5、提示 Install Successfully 说明已经安装完成。程序默认会自动初始化一个超级管理员用户：admin，密码：123456，记得登录后重置密码！

6、执行如下命令启动 MinDoc 程序：

####### 2.0版本 ####### 
#修改可执行权限
chmod +x mindoc_linux_amd64
#启动程序
./mindoc_linux_amd64

####### 2.1版本及以上 #######
#修改可执行权限
chmod +x mindoc_linux_musl_amd64
#启动程序
./mindoc_linux_musl_amd64

7、此时输入 http://<服务器IP>:8181 能访问 MinDoc 文档管理系统了。如果访问不了，需要在宝塔后台放行8181端口，若使用阿里云等服务器，还需要额外在服务器上的安全组里开放端口。

●用户名：admin
●密码：123456

8、通过 http://<服务器IP>:8181 这样的方式来访问 MinDoc，显然不太友好也不便于记忆，我们可以使用 Nginx 反向代理绑定域名访问，如下图：

●代理名称：随便填写
●目标URL：http://127.0.0.1:8181
●发送域名：$host
●内容替换：留空

9、最后，还有一个小问题，就是关掉 Xshell 等SSH客户端后，MinDoc 程序也会自动关闭。如果你想让程序在 Linux 下后台运行，可以执行如下命令：

#使程序后台运行
nohup ./godoc &

PS：该命令会使程序后台执行，但是服务器重启后不会自动启动服务。你可以使用 Supervisor 进程守护管理器来做服务，可以使服务器重启后开机自启 MinDoc，具体操作请度娘。

MinDoc设置开机启动

在 Linux 系统中，你也可以使用 systemctl 或 service 命令来管理 MinDoc 服务，例如启动、停止、重启、开机启动或查看服务状态。以下是设置 MinDoc 开机启动的方法（会员自取）：

你学废了吗？若需要要站长协助设置的，可联系站长微信（a328695615）有偿服务！

帮助手册

MinDoc 使用手册：https://doc.gsw945.com/docs/mindoc-docs

1、MinDoc的配置

MinDoc 大部分配置信息都在源目录下的 conf/app.conf 中，只有少部分可在管理后台修改。因此，如果想要修改 MinDoc 的配置请找到配置文件，使用文本编辑器打开配置文件进行修改。

2、修改用户密码

超级管理可在管理后台 [用户管理] - [编辑] 来修改用户的密码，用户个人也可以在个人中心修改密码。

如果忘记了管理员密码，可以在 MinDoc 站点根目录下使用如下命令修改：

####### 2.0版本 ####### 
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_amd64 password -account admin -password 123456

####### 2.1版本及以上 #######
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_musl_amd64 password -account admin -password 123456

另外，还可以直接修改数据库。例如，你知道一个人的密码，直接将数据库 md_member 表中的 password 字段变更成已知的密码密文即可。

3、查看版本

在 MinDoc 站点根目录下，使用以下命令查看当前程序版本和最新程序版本：

####### 2.0版本 ####### 
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_amd64 version

####### 2.1版本及以上 #######
cd /www/wwwroot/doc.11zhang.com
./mindoc_linux_musl_amd64 version