前言

MinDoc 是一款针对IT团队开发的简单好用的文档管理系统。可以用来储存日常接口文档，数据库字典，手册说明等文档。内置项目管理，用户管理，权限管理等功能，能够满足大部分中小团队的文档管理需求。

主要功能

• 项目管理，可以对项目进行编辑更改，成员添加等。
• 文档管理，添加和删除文档，文档历史恢复等。
• 用户管理，添加和禁用用户，个人资料更改等。
• 用户权限管理 ， 实现用户角色的变更。
• 项目加密，可以设置项目公开状态，私有项目需要通过Token访问。
• 站点配置，二次开发时可以添加自定义配置项。
• 附件管理，可管理所有项目中上传的文件。
• 项目导出，目前支持导出 PDF、Word、EPUB、MOBI、Markdown 等格式项目。
• 标签管理，可关系已存在的项目标签
• 导入项目，支持导入Markdown压缩包成为一个项目
• 二级目录部署，支持将 MinDoc 部署到二级子目录

部署与配置

centos8运行MinDoc

获取

#下载可执行文件
mkdir -p /opt/mindoc && cd /opt/mindoc
wget https://github.com/mindoc-org/mindoc/releases/download/v2.1-beta.1/mindoc_linux_amd64.zip

#解压并赋予可执行权限
unzip  mindoc_linux_amd64.zip   && rm mindoc_linux_amd64.zip
chown -R nginx:nginx mindoc_linux_amd64

配置

cd  mindoc_linux_amd64/conf/
cp app.conf.example app.conf && vim app.conf 

//注释mysql 打开sqlite3
db_adapter=sqlite3
db_database=mindoc_db

初始化

cd ..
./mindoc_linux_amd64 install

手动启动

./mindoc_linux_amd64

服务化

安装supervisor

#安装
dnf install epel-release
dnf install supervisor

#启动
systemctl enable --now supervisord

配置

vim /etc/supervisor/conf.d/mindoc.ini
[program:mindoc]
user=nginx
directory=/opt/mindoc/mindoc_linux_amd64/
command=/opt/mindoc/mindoc_linux_amd64/mindoc_linux_amd64
autostart=true
autorestart=true
startsecs=5
stopsignal=HUP
stopasgroup=true
stopwaitsecs=5
stdout_logfile_maxbytes=20MB
stdout_logfile=/var/log/supervisor/%(program_name)s-out.log
stderr_logfile_maxbytes=20MB
stderr_logfile=/var/log/supervisor/%(program_name)s-err.log

supervisor管理

# 进入Supervisor交互式工具，进入后可以输入help查看支持的命令
supervisorctl

# 停止所有进程
supervisorctl stop all

# 启动所有进程
supervisorctl start all

# 查看所有进程状态
supervisorctl status

# 重新加载，会重启所有进程
supervisorctl reload

docker运行MinDoc

docker-compose.yml

MinDoc:
  image: registry.cn-hangzhou.aliyuncs.com/mindoc/mindoc:v2.0-beta.2
  container_name: ly-mindoc
  privileged: false
  restart: always
  ports:
    - 8181:8181
  volumes:
    - ./database:/mindoc/database
    - ./uploads:/mindoc/uploads
  environment:
    - MINDOC_RUN_MODE=prod
    - MINDOC_DB_ADAPTER=sqlite3
    - MINDOC_DB_DATABASE=./database/mindoc.db
    - MINDOC_CACHE=true
    - MINDOC_CACHE_PROVIDER=file
    - MINDOC_ENABLE_EXPORT=false
    - MINDOC_BASE_URL=
    - MINDOC_CDN_IMG_URL=
    - MINDOC_CDN_CSS_URL=
    - MINDOC_CDN_JS_URL=
  dns:
    - 223.5.5.5
    - 114.114.114.114

启动

docker-compose up -d

访问测试

默认地址 http://ip:8081/ 账号密码 admin/123456

FAQ

GLIBC库报错

//查看当前版本
yum install binutils
strings /lib64/libc.so.6 |grep ^GLIBC_2