MinDoc文档管理系统快速搭建教程

MinDoc文档管理系统是一款简单实用的项目接口文档管理和分享的系统，适合小团队使用。

一、MySQL的安装

# 拉取mysql最新镜像
docker pull mysql

# -v E:\docker-volume\mindoc\mysql\conf:/etc/mysql/conf.d挂载MySQL配置
# -v E:\docker-volume\mindoc\mysql\data:/var/lib/mysql挂载MySQL数据
# -e MYSQL_ROOT_PASSWORD=root指定root账户的密码
docker run -d --name mysql-mindoc -p 3306:3306 -v E:\docker-volume\mindoc\mysql\conf:/etc/mysql/conf.d -v E:\docker-volume\mindoc\mysql\data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=root mysql

mysql的配置文件有两个，一个是/etc/mysql/conf.d/config-file.cnf，里面默认是空的；另外一个是/etc/mysql/my.cnf，里面除了自己的配置内容外，还包含了前一个配置的内容。因此我们只需要在宿主机的某个目录下新建一个conf/config-file.cnf，然后按照上面的目录绑定即可-v E:\docker-volume\mindoc\mysql\conf:/etc/mysql/conf.d，这里都只绑定了目录，未具体到配置文件的名称。

然后进入mysql容器内部，为minDoc创建一个数据库。

mysql -u root -p
root
mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
4 rows in set (0.00 sec)

mysql> create database mindoc;

至此，数据库的准备工作就完成了。

二、MinDoc的安装

# -v E:\docker-volume\mindoc\mindoc\uploads:/mindoc/uploads挂载上传的文件内容
# -v E:\docker-volume\mindoc\mindoc\data:/mindoc/database挂载文档内容
# -e DB_ADAPTER=mysql指定数据库类型
# -e MYSQL_PORT_3306_TCP_ADDR=127.0.0.1数据库地址
# -e MYSQL_PORT_3306_TCP_ADDR=127.0.0.1数据库端口
# -e MYSQL_INSTANCE_NAME=mindoc数据库实例名称
# -e MYSQL_USERNAME=root -e MYSQL_PASSWORD=root数据库账密
docker run -d --name mindoc --restart always -p 8181:8181 -v E:\docker-volume\mindoc\mindoc\uploads:/mindoc/uploads -v E:\docker-volume\mindoc\mindoc\data:/mindoc/database -e DB_ADAPTER=mysql -e MYSQL_PORT_3306_TCP_ADDR=127.0.0.1 -e MYSQL_PORT_3306_TCP_PORT=3306 -e MYSQL_INSTANCE_NAME=mindoc -e MYSQL_USERNAME=root -e MYSQL_PASSWORD=root -e httpport=8181 registry.cn-hangzhou.aliyuncs.com/mindoc-org/mindoc:v2.1-beta.5

执行如上命令后，进入容器内容查看日志，看下是否正常启动。

三、MinDoc的使用

• 首页

  首页展示所有的项目信息；

• 项目空间

  • 项目，一个项目只能属于一个项目空间，一个项目空间下可以有多个项目；
    • 文章，在项目内部维护和项目相关的文章；

• 团队

  • 用户，同样是1:n的关系；

• 配置

  • 匿名访问，陌生人无需注册就能访问；
  • 启用注册，陌生人可以自己注册为用户；
  • 启用验证码，登录时需要输入验证码；

• 附件管理

• 标签管理

• 文章，每个人可以发布自己的文章，不属于任何项目。

四、参考文档

Mysql - Official Image | Docker Hub

GitHub - mindoc-org/mindoc: Golang实现的基于beego框架的接口在线文档管理系统