MinDoc接口文档在线管理系统

MinDoc 是一款针对IT团队开发的简单好用的文档管理系统。看到公司的文档编写使用的是这款软件,这里搭建一下Mindoc的运行环境。

MinDoc接口文档在线管理系统_第1张图片
image.png

环境

  • CentOS7
  • Docker

过程

  1. 下载mindoc的执行程序,然后解压
wget -c https://github.com/lifei6671/mindoc/releases/download/v0.12/mindoc_linux_amd64.zip
unzip mindoc_linux_amd64.zip
  1. 使用Docker创建数据库

创建MysqL容器,在本地安装mysql客户端,连接mysql,然后创建数据库

docker run --name mindoc -d -p3310:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql:5.6
yum install mariadb
mysql -uroot -h192.168.99.100 -P3310 -p123456
CREATE DATABASE mindoc_db  DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
  1. 在刚才解压的mindoc目录,在配置目录下修改配置文件
#支持MySQL和sqlite3两种数据库,如果是sqlite3 则 db_database 标识数据库的物理目录
db_adapter=mysql
db_host=127.0.0.1
db_port=3310
db_database=mindoc_db
db_username=root
db_password=123456
  1. 初始化Mindoc的数据库
./mindoc_linux_amd64 install
  1. 直接在本地安装Nginx,并发一定要使用Nginx,只要能提供反向代理功能。如果直接能在本地访问当然也是可以的,那样就不用配置Nginx了,因为我是在虚拟机中配置的,无法方法虚拟机内部,因此要安装nginx。
yum install epel*
yum install nginx
vim /etc/nginx/nginx.conf


location / {
    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;
}
  1. 测试
    默认账号是admin,123456


    MinDoc接口文档在线管理系统_第2张图片
    image.png
MinDoc接口文档在线管理系统_第3张图片
image.png
MinDoc接口文档在线管理系统_第4张图片
image.png

MinDoc接口文档在线管理系统_第5张图片
image.png
  1. 剩下的自己进入后台摸索就好了,官方文档给的说明很详细啊

最后

碰到还不错的软件,只停留在知道上没什么用处,亲自搭建一下动动手,让自己理解的更透彻。

参考

  • Mindoc官方首页

你可能感兴趣的:(MinDoc接口文档在线管理系统)