宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

MinDoc 的前身是 SmartWiki 文档系统。SmartWiki 是基于 PHP 框架 laravel 开发的一款文档管理系统。因 PHP 的部署对普通用户来说太复杂,所以改用 Golang 开发。可以方便用户部署和实用。

开发缘起是公司IT部门需要一款简单实用的项目接口文档管理和分享的系统。其功能和界面源于 kancloud 。

可以用来储存日常接口文档,数据库字典,手册说明等文档。内置项目管理,用户管理,权限管理等功能,能够满足大部分中小团队的文档管理需求。

之前的文章说过docker安装,那么这篇文章就来说说如何手动安装,喜欢docker安装的同学可以看看之前的文章:

宝塔面板Docker安装mindoc – 一款针对IT团队开发的简单好用的文档管理系统

1、简介

项目:https://github.com/lifei6671/mindoc

安装文档:https://www.iminho.me/wiki/docs/mindoc/mindoc-linux.md

演示:https://doc.iminho.me/

2、准备

(1)宝塔面板(宝塔服务器面板,一键全能部署及管理,送你3188元礼包,点我领取https://www.bt.cn/?invite_code=MV9ub2NxdmI=

(2)宝塔面板配置好golang环境(宝塔面板Linux环境-安装Golang:Go语言环境安装以及程序如何运行

(3)NGINX1.18(版本随意)

(4)MySQL5.7(如果你使用的 mysql 数据库,请创建一个编码为utf8mb4格式的数据库)

(5)Supervisor管理器 1.3

3、部署

(1)下载程序

请从 https://github.com/lifei6671/mindoc/releases 下载最新版的可执行文件,一般文件名为mindoc_linux_amd.tar.gz 或 mindoc_linux_amd64.zip 。

直接用宝塔自带的远程下载功能下载即可,如图:

(2)解压

下载后解压,可以利用宝塔面板自带解压功能,

或者利用命令。

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

(3)创建数据库

宝塔面板创建数据库,额,截个图吧。

如果你使用的是 sqlite 数据库,请将 conf/app.conf 中的数据库配置成如下,系统会自动创建 sqlite 数据库文件:

db_adapter=sqlite3
db_database=mindoc_db

(4)配置数据库

请将刚才解压目录下 conf/app.conf.example 重名为 app.conf,或者用命令:

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

不过最新版本里面已经有了app.conf文件,可以不用修改了(*^____^*),但是数据库还是需要配置下的,大概再59行,具体如下:

####################MySQL 数据库配置###########################
#支持MySQL和sqlite3两种数据库,如果是sqlite3 则 db_database 标识数据库的物理目录
db_adapter="${MINDOC_DB_ADAPTER||sqlite3}"
db_host="${MINDOC_DB_HOST||127.0.0.1}"
db_port="${MINDOC_DB_PORT||3306}"
db_database="${MINDOC_DB_DATABASE||./database/mindoc.db}"
db_username="${MINDOC_DB_USERNAME||root}"
db_password="${MINDOC_DB_PASSWORD||123456}"

自行修改数据库用户名和密码。

(5)初始化数据库

在 MinDoc 根目录下使用命令行执行如下命令,用于初始化数据库:

./mindoc_linux_amd64 install

稍等片刻,程序会自动初始化数据库,并创建,超级管理员账号:admin 密码:123456

(6)启动程序

执行如下命令启动程序:

#修改可执行权限
chmod +x mindoc_linux_amd64

#启动程序
./mindoc_linux_amd64

安装成功截图:

此时访问 http://IP:8181 就能访问 MinDoc 了。(注意,安全中开启8181端口,像阿里云等,还需要额外在安全组开放端口。)

4、设置守护进程

配置好了后,再使用Ctrl+C断开运行,此时程序还没启动,接下来我们还需要启动下。

(1)安装Supervisor管理器

安装路径:软件商店→系统工具

(2)设置守护进程

点开Supervisor管理器进行守护设置,具体如图:

守护成功,截图:

5、设置域名访问

具体看图吧。

效果如图:

6、最后

如果设置SSL,请先停掉dl,之后申请,申请好之后开启dl即可。

前面说过如何docke安装,但是很多同学不喜欢docke安装,所以本教程算是对前面教程的一个补充。

其他没啥好说的,具体使用,请自行折腾。