Linux 安装 minDoc 接口文档在线管理

2019-12-18 17:39:11 浏览数 (1)

昨天被分配给公司安装 minDoc 水文记录一下安装的过程

MinDoc 是一款针对IT团队开发的简单好用的文档管理系统。 MinDoc 的前身是 SmartWiki 文档系统。SmartWiki 是基于 PHP 框架 laravel 开发的一款文档管理系统。因 PHP 的部署对普通用户来说太复杂,所以改用 Golang 开发。可以方便用户部署和实用。 开发缘起是公司IT部门需要一款简单实用的项目接口文档管理和分享的系统。其功能和界面源于 kancloud 。 可以用来储存日常接口文档,数据库字典,手册说明等文档。内置项目管理,用户管理,权限管理等功能,能够满足大部分中小团队的文档管理需求。

下载

我是从 https://github.com/lifei6671/mindoc/releases 下载最新版的可执行文件,一般文件名为 mindoc_linux_amd.tar.gzmindoc_linux_amd64.zip

代码语言:javascript复制
#进入存放项目的根目录
cd /data/httpd/

#创建存放 `minDoc` 目录  并进入
mkdir minDoc && cd minDoc

#下载可执行文件压缩包
wget https://github.com/lifei6671/mindoc/releases/download/v2.0/mindoc_linux_amd64.zip

# 解压该压缩包
unzip mindoc_linux_amd64.zip

配置数据库

MinDoc 支持 MySQLSqlite3 数据库,因为up这个是给公司搭建的是团队使用所以选择了 MySQL,如果是个人用需求量不大的话选择 Sqlite3 就好。

我用的是 MySQL 数据库,需要创建一个编码为utf8mb4 格式的数据库,也可以用 CREATE DATABASE mindoc_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; 命令来创建,如果用 sqlite 数据库 直接在 conf/app.conf 中的数据库配置成如下,系统会自动创建 sqlite 数据库文件

好了接下来修改一下数据库配置,先找到配置文件 conf/app.conf

代码语言:javascript复制
# 进入conf 目录
cd conf/

# 保险起见我习惯在改配置文件前备个份
cp app.conf app.conf.example

# 打开app.conf
vi app.conf

找到数据库配置进行配置,并且注释掉 Sqlite3

安装

配置完成后变可以安装了

代码语言:javascript复制
# 需要回到 minDoc 根目录
cd ../

# 执行如下命令,用于初始化数据库
./mindoc_linux_amd64 install

等待了大约一分钟,程序会自动初始化数据库,当看到“Install Successfully!”说明安装成功,这时会自动创建一个超级管理员账号:admin 密码:123456

运行并安装服务

安装完成后需要先授予权限并安装服务

代码语言:javascript复制
chmod  x mindoc_linux_amd64 && ./mindoc_linux_amd64 service install

这样就能注册到系统服务中了,也就是说是以后台运行的方式运行服务

之后就可以 service 控制minDoc 的启用停用和重启拉 service mindocd start/stop/restart

当然还可以查看 minDoc 的状态 service mindocd status

这样就安装完毕了.直接使用了

0 人点赞