Mindoc简介

MinDoc 是一款针对IT团队开发的简单好用的开源文档管理系统。

基于Golang 开发。可以方便用户部署和实用,同时增加Markdown和HTML两种编辑器。

支持markdown中的 美人鱼图、流程图等图形。

自带的有API模板、数据字典模板等页面模板。内置项目管理、用户管理、权限管理等功能。

官网:https://www.iminho.me/

环境搭建

Mysql搭建

  1. 在linux上创建mysql用户,到Mysql官网下载安装包: mysql-8.0.28-1.el7.x86_64.rpm-bundle.tar

  2. 卸载系统自带的 mariadb,会和mysql-community-lib中的mariadb冲突

    1. # 查看系统中是否安装了mariadb
    2. rpm -qa | grep mariadb
    3. # 卸载已安装的mariadb,和mysql-community-lib中的mariadb冲突
    4. rpm -e mariadb-libs-5.5.56-2.el7.x86_64 --nodeps
  1. /usr/local/下创建mysql文件夹

  2. 将安装包上传到/usr/local/mysql目录并解压

    1. tar -xvf mysql-8.0.28-1.el7.x86_64.rpm-bundle.tar
  1. 依次安装mysql安装包中的组件:
    1. # 安装bundle中的server依赖组件
    2. rpm -ivh mysql-community-common-8.0.28-1.el7.x86_64.rpm
    3. rpm -ivh mysql-community-client-plugins-8.0.28-1.el7.x86_64.rpm
    4. rpm -ivh mysql-community-libs-8.0.28-1.el7.x86_64.rpm
    5. rpm -ivh mysql-community-client-8.0.28-1.el7.x86_64.rpm
    6. rpm -ivh mysql-community-icu-data-files-8.0.28-1.el7.x86_64.rpm
    7. # 如果缺少libaio,则还需安装libaio依赖
    8. yum install libaio
    9. # 安装bundle中的server
    10. rpm -ivh mysql-community-server-8.0.28-1.el7.x86_64.rpm

对mysql进行初始化操作:

  1. 执行初始化
    1. mysqld --initialize;
    2. chown mysql:mysql /var/lib/mysql -R
    3. # 启动服务,并设置开机自启
    4. systemctl start mysqld.service
    5. systemctl enable mysqld
  1. 查看安装的mysql的root初始化密码
    1. cat /var/log/mysqld.log | grep password
  1. 进入mysql
    1. # 使用root身份进入mysql,初始密码为/var/log/mysqld.log中随机生成的密码
    2. mysql -uroot -p
  1. 使用sql修改root密码为root
    1. -- 使用 mysql_native_password 组件修改密码
    2. alter user 'root'@'localhost' identified with mysql_native_password by 'root'; -- 最后的root即为密码
    3. -- 使用exit或者\q退出,然后使用新设置的密码重新连接
  1. 设置允许远程访问
    1. create user 'root'@'%' identified with mysql_native_password by 'root';
    2. grant all privileges on *.* to 'root'@'%' with grant option;
    3. flush privileges;
  1. 设置密码不过期
    1. alter user 'root'@'localhost' identified by 'root' password expire never;

关闭防火墙:

  1. systemctl stop firewalld
  2. systemctl disable firewalld

为Mindoc创建数据库

  1. CREATE DATABASE mindoc_db DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;
  2. create user 'mindoc'@'%' identified by 'mindoc';
  3. grant all privileges on mindoc_db.* to 'mindoc'@'%';
  4. flush privileges;

安装配置Mindoc

  1. 如果服务器没有golang环境,可以在github上下载编译后的最新版可执行文件:mindoc_linux_amd64.zip

  2. 上传到服务器,解压

    1. mkdir mindoc
    2. cd mindoc
    3. # 上传文件
    4. unzip mindoc_linux_amd64.zip
  1. 进入conf文件夹,复制一份配置文件,修改配置文件
    1. cp app.conf.example app.conf
  1. 配置数据库
    1. db_adapter=mysql
    2. db_host=localhost
    3. db_port=3306
    4. db_database=mindoc_db
    5. db_username=mindoc
    6. db_password=mindoc
  1. 在MinDoc根目录下执行命令初始化数据库:
    1. ./mindoc_linux_amd64 install
  1. 数据库中表创建完成后,会自动创建一个超级管理员:admin/123456

启动程序:

  1. ./mindoc_linux_amd64

访问项目:http://localhost:8181

用户:admin/123456