如默

mindoc接口文档在线管理系统(使用宝塔面板安装配置教程)
mindoc简介MinDoc 是一款针对IT团队开发的简单好用的文档管理系统。具体的介绍就不写了,官网地址:htt...
扫描右侧二维码阅读全文
02
2019/01

mindoc接口文档在线管理系统(使用宝塔面板安装配置教程)

mindoc简介

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

具体的介绍就不写了,官网地址:https://www.iminho.me/

本站的文档管理系统就是使用此程序搭建的。地址:https://www.rumosky.wiki
下面,讲一下如何使用宝塔面板搭建此程序。

安装教程

本文以centOS7为例,根据自己安装的经验以及官网文档修改而来,不懂的地方请自行阅读官网文档

安装环境

远程连接到你的服务器,执行yum update -y更新系统

安装Calibre

在安装之前,先依次执行yum install xxx(xxx替换为下列依赖包)
python2.6libstdc++.so.6.0.17GLIBC 2.17libXcompositelibGL

如果最后提示Nothing to do说明你的系统已经安装了该软件,请忽略,执行下一步

确保依赖关系安装上之后,请执行

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"

如果安装成功,执行ebook-convert --version之后会看到3.x的版本号

下载程序

前往上面的mindoc官网,在项目地址里面找到release,发行版本里面会有很多个,一般选择最新的正式版本就行,截止本文发布时间,mindoc最新的正式版本还是1.0.2,最新的测试版本是2.0-beta2

宝塔配置

  • 首先,确保你的服务器上已经安装了宝塔面板,不会安装的请自行百度安装。
  • 在www/wwwroot目录下新建一个文件夹,然后将下载好的压缩包上传到那个文件夹,然后解压到该文件夹根目录
  • 新建一个数据库,数据库字符集请选择utf8mb4,然后记住数据库名,用户名,密码
  • 修改配置文件,在刚刚建立的文件夹下找到mindoc的配置文件,位置是conf/app.conf文件,将刚刚得到的数据库信息填写进去
####################MySQL 数据库配置###########################
#支持MySQL和sqlite3两种数据库,如果是sqlite3 则 db_database 标识数据库的物理目录
db_adapter="${MINDOC_DB_ADAPTER||mysql}"
db_host="${MINDOC_DB_HOST||127.0.0.1}"
db_port="${MINDOC_DB_PORT||3306}"
db_database="${MINDOC_DB_DATABASE||mindoc_db}"
db_username="${MINDOC_DB_USERNAME||root}"
db_password="${MINDOC_DB_PASSWORD||123456}"
  • 修改环境变量,在宝塔文件功能里面,浏览系统文件,找到根目录/etc下的profile文件,在文件最后一行添加:
    export PATH=$PATH:/www/wwwroot/你建立的目录/lib/time/zoneinfo.zip

然后保存文件

  • 进入你放mindoc安装程序的目录,在终端页面执行./mindoc_linux_amd64 install来初始化数据库
  • 执行下面两条命令
#修改可执行权限
chmod +x mindoc_linux_amd64

#启动程序
./mindoc_linux_amd64
  • 在宝塔面板网站选项卡上新建一个网站,网站域名自己写,目录请选择刚刚存放mindoc的那个目录,数据库和ftp都不要选。
  • 配置Nginx代理,点击刚刚创建好的网站的设置按钮,在配置文件里面写入如下代码
server {
    listen       80;

    #此处应该配置你的域名:
    server_name  doc.rumosky.com;

    #SSL-START SSL相关配置,请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    #SSL-END

    charset utf-8;

    #此处配置你的访问日志,请手动创建该目录:
    access_log  /www/wwwlogs/doc_rumosky_com.log;
    location ~ .*\.(ttf|woff2|eot|otf|map|swf|svg|gif|jpg|jpeg|bmp|ico|txt|js|css)$ 
    {
        root "/www/wwwroot/你建立的目录";
        expires 30m;
    }

    location / {
        try_files /_not_exists_ @backend;
    }

    # 这里为具体的服务代理配置
    location @backend {
        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;
    }
}

然后点击保存

  • 现在通过你刚刚设置的域名就可以访问mindoc文档系统了。

补充说明

  • 配置文件里面的#SSL-START和#SSL-END是为了开启ssl证书添加的,如果不添加此代码,在宝塔面板一键开启ssl证书会失败
  • 在执行./mindoc_linux_amd64命令启动程序之后,不能关闭终端,否则程序会关闭,就无法访问了。解决办法就是让它后台运行,偷懒的做法就是执行./mindoc_linux_amd64 &就后台运行。缺点就是服务器重启,mindoc就断开了,需要手动再次运行。
  • 推荐使用官方的解决办法,安装mindoc服务,让mindoc以服务后台运行,优点是即便重启服务器也会保持运行。

安装mindoc服务

安装服务命令
./mindoc_linux_amd64 service install
卸载服务命令
./mindoc_linux_amd64 service remove

执行服务安装后,会创建一个以 mindocd 为服务名的服务。

设置mindoc服务开机启动

  • 在根目录/etc/rc.d里面找到rc.local文件,在最后一行添加service mindocd start,然后保存文件即可。
  • 查看服务状态的命令是service mindocd status
Last modification:April 14th, 2019 at 12:53 am
^_^您的每一分钱,都是对我最大的鼓励!

9 comments

  1. engine

    我用的是apache环境

    1. 如默
      @engine

      实在弄不好,可以直接去官网,询问作者。

    2. 如默
      @engine

      这个跟Apache和Nginx应该是没关系的,安装成功之后就可以使用IP访问,如果访问不了,是不是你的IP被封了?Nginx也只是做了一个反向代理,让你可以用域名访问。Apache也是相同作用,所以应该不是Apache得到问题。

  2. engine

    [root@web doc]# screen

    [root@web doc]# ./mindoc_linux_amd64
    2019/04/22 11:22:24.448 [I] [command.go:34] 正在初始化数据库配置.
    2019/04/22 11:22:24.449 [I] [command.go:86] 数据库初始化完成.
    MinDoc version => v2.0
    build time => Mon Mar 11 08:38:41 UTC 2019
    start directory => /hdd1/web/web/doc/mindoc_linux_amd64

    2019/04/22 11:22:24.522 [I] [asm_amd64.s:1337] http server Running on http://:8181
    这样应该成功了。但是打不开
    45.34.121.14:8181

    1. 如默
      @engine

      你下载好程序之后先修改配置文件,配置好数据库信息,然后初始化安装,最后执行运行命令。
      按照上面的步骤应该是没问题的,检查你的8181端口是否打开

  3. engine

    不做反代的话,用IP+端口可以访问吧,为毛线我的打不开

    1. 如默
      @engine

      肯定可以啊,我最初就是没有反向代理,测试的时候使用IP和端口访问,你要确定你的端口打开了,防火墙没有拦截,配置无误才行。

  4. engine

    一直在关注这个系统,在寻找宝塔的搭建,网站多,方便管理,可以支持apache吗?

    1. 如默
      @engine

      这个不清楚,应该是可以的,只要你Apache配置文件修改好应该没问题。不过建议你去项目源码提交issue问作者吧。

Leave a Comment