Ubuntu 安装 MinDoc 全流程

  • 2018-04-24
  • 957
  • 0
  • 1

MinDoc 官网:https://www.iminho.me
MinDoc 项目地址:https://github.com/lifei6671/mindoc
MinDoc 下载地址:https://github.com/lifei6671/mindoc/releases

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

MinDoc 的前身是 SmartWiki 文档系统。SmartWiki 是基于 PHP 框架 laravel 开发的一款文档管理系统。因 PHP 的部署对普通用户来说太复杂,所以改用 Golang 开发。可以方便用户部署和实用。

开发缘起是公司IT部门需要一款简单实用的项目接口文档管理和分享的系统。其功能和界面源于 kancloud 。

可以用来储存日常接口文档,数据库字典,手册说明等文档。内置项目管理,用户管理,权限管理等功能,能够满足大部分中小团队的文档管理需求。

演示站点: http://www.bookgod.com

1、安装基础环境

$ apt update    #更新源
$ apt upgrade   #更新系统
$ apt install nginx #安装nginx
$ apt install php   #安装php7,mindoc系统要求php7.0及以上
$ apt install mysql-server php-mysql    #安装mysql及php连接支持
$ apt install mysql-client  #安装mysql连接环境,如果您使用RDS或外部数据库服务器,可以忽略以上步骤直接执行此步骤即可。
$ mysql_secure_installation #针对mysql进行初始设置,每步均有提示,按照提示操作。
$ apt install php-gd php-mbstring php-gettext php-zip openssl php-xml php-curl  #安装其他php支持组件。
$ apt install golang    #安装golang,mindoc主要支持环境。

如果您非ubuntu 16.04请将apt更换为apt-get,如果您是CentOS可以将apt更换为yum进行安装。忽略第二部即可。

之后创建并进入您的程序所期望的安装目录。

创建一个应用于mindoc的数据库,切记,mindoc使用的字符集为utf8mb4,默认排序方式为utf8mb4_general_ci。

CREATE DATABASE mindoc_db  DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;

2、下载及安装

$ wget https://github.com/lifei6671/mindoc/releases/download/v0.10.1/mindoc_linux_amd64.zip #下载mindoc,请按照文章头部地址选择您需要安装的mindoc版本,我使用操作系统为64位。
$ unzip mindoc_linux_amd64.zip  #解压程序包
$ cd conf   #进入系统集配置目录
$ mv app.conf.example app.conf  #重命名配置文件
$ chmod +x mindoc_linux_amd64   #给予文件可执行权限
$ ./mindoc_linux_amd64 install  #针对程序进行安装。
$ ./mindoc_linux_amd64  #启动mindoc,访问:http://ip:8181,测试可用
$ ./mindoc_linux_amd64 service install  #将mindoc加入系统服务启动项

3、启用nginx反向带来,来使用域名及不需要端口号访问

$ cd /etc/apache2/conf-available/   #进入nginx规则目录
$ vim www.bookgod.com   #以您自己的网站访问域名设置一个规则,方便记录。
$ cd ../sites-enabled/
$ ln -s ../sites-available/www.bookgod.com .    #连接规则文件到启动目录

下面是我的nginx规则,但是我启用了https,使用443端口访问,如果您不需要可以自行修改。

server {  
    listen 80;  
    server_name bookgod.com www.bookgod.com;  

    rewrite ^(.*)$  https://$host$1 permanent;  
} 
server {
    listen 443;    
    #此处应该配置你的域名:
    server_name  bookgod.com www.bookgod.com;
    charset utf-8;
    ssl on;
    root html;
    ssl_certificate   /mnt/wwwroot/www.bookgod.com/cert/2141972151410.pem;
    ssl_certificate_key  /mnt/wwwroot/www.bookgod.com/cert/2141972151410.key;
    ssl_session_timeout 5m;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    #此处配置你的访问日志,请手动创建该目录:
    access_log  /mnt/wwwroot/www.bookgod.com/logs/access.log;
    location ~ .*\.(ttf|woff2|eot|otf|map|swf|svg|gif|jpg|jpeg|bmp|png|ico|txt|js|css)$ {
        #此处将路径执行 MinDoc 的跟目录
        root "/mnt/wwwroot/www.bookgod.com/public_html/";
        expires 60m;
    }
    location ~* \.(rar|zip|sql|tar.gz|tar.bz2)$ {
                return 403;
    }
    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;
    }
}

4、支持PDF、EPUB、Mobi、Word等格式下载。

$ vim /etc/hostname #
$ vim /etc/hosts    #如果您是阿里云用户请修改以上及本步骤,否则将报错sudo: unable to resolve host ***
$ apt install calibre   #为了减少安装ebook-convert安装过程中各种组件缺失,先安装一下calibre,所有依赖环境都会安装好。
$ 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()"    #安装calibre-ebook
$ ebook-convert --version   #即可查看calibre-ebook版本,也证明安装成功
$ apt install ttf-wqy-zenhei    #以下一步均为安装中文字体,否则pdf中文会显示方块。
$ apt install fonts-wqy-microhei
$ echo "Hello。你好" > test.txt    #进行一个测试
$ ebook-convert test.txt test.pdf   #测试转换

$ apt install chromium-browser  #如果您不需要打印网页转换,无需此步骤。

评论

还没有任何评论,你来说两句吧

你必须 登录 才能发表评论.