宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

宝塔面板60字数 2105阅读模式

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

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

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

之前的文章说过docker安装,那么这篇文章就来说说如何手动安装,喜欢docker安装的同学可以看看之前的文章:

1、简介

项目:https://github.com/lifei6671/mindoc

安装文档:https://www.iminho.me/wiki/docs/mindoc/mindoc-linux.md

演示:https://doc.iminho.me/

2、准备

(1)宝塔面板(宝塔服务器面板,一键全能部署及管理,送你3188元礼包,点我领取https://www.bt.cn/?invite_code=MV9ub2NxdmI=

(2)宝塔面板配置好golang环境(宝塔面板Linux环境-安装Golang:Go语言环境安装以及程序如何运行

(3)NGINX1.18(版本随意)

(4)MySQL5.7(如果你使用的 mysql 数据库,请创建一个编码为utf8mb4格式的数据库)

(5)Supervisor管理器 1.3

3、部署

(1)下载程序

请从 https://github.com/lifei6671/mindoc/releases 下载最新版的可执行文件,一般文件名为mindoc_linux_amd.tar.gz 或 mindoc_linux_amd64.zip 。

直接用宝塔自带的远程下载功能下载即可,如图:

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

(2)解压

下载后解压,可以利用宝塔面板自带解压功能,

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

或者利用命令。

tar -xzvf mindoc_linux_amd64.tar.gz
unzip mindoc_linux_amd64.zip

(3)创建数据库

宝塔面板创建数据库,额,截个图吧。

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

如果你使用的是 sqlite 数据库,请将 conf/app.conf 中的数据库配置成如下,系统会自动创建 sqlite 数据库文件:

db_adapter=sqlite3
db_database=mindoc_db

(4)配置数据库

请将刚才解压目录下 conf/app.conf.example 重名为 app.conf,或者用命令:

cp conf/app.conf.example conf/app.conf

不过最新版本里面已经有了app.conf文件,可以不用修改了(*^____^*),但是数据库还是需要配置下的,大概再59行,具体如下:

####################MySQL 数据库配置###########################
#支持MySQL和sqlite3两种数据库,如果是sqlite3 则 db_database 标识数据库的物理目录
db_adapter="${MINDOC_DB_ADAPTER||sqlite3}"
db_host="${MINDOC_DB_HOST||127.0.0.1}"
db_port="${MINDOC_DB_PORT||3306}"
db_database="${MINDOC_DB_DATABASE||./database/mindoc.db}"
db_username="${MINDOC_DB_USERNAME||root}"
db_password="${MINDOC_DB_PASSWORD||123456}"

自行修改数据库用户名和密码。

(5)初始化数据库

在 MinDoc 根目录下使用命令行执行如下命令,用于初始化数据库:

./mindoc_linux_amd64 install

稍等片刻,程序会自动初始化数据库,并创建,超级管理员账号:admin 密码:123456

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

(6)启动程序

执行如下命令启动程序:

#修改可执行权限
chmod +x mindoc_linux_amd64

#启动程序
./mindoc_linux_amd64

安装成功截图:

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

此时访问 http://IP:8181 就能访问 MinDoc 了。(注意,安全中开启8181端口,像阿里云等,还需要额外在安全组开放端口。)

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

4、设置守护进程

配置好了后,再使用Ctrl+C断开运行,此时程序还没启动,接下来我们还需要启动下。

(1)安装Supervisor管理器

安装路径:软件商店→系统工具

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

(2)设置守护进程

点开Supervisor管理器进行守护设置,具体如图:

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

守护成功,截图:

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

5、设置域名访问

具体看图吧。

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

效果如图:

宝塔面板手动安装MinDoc – 一款针对IT团队开发的简单好用的文档管理系统

6、最后

如果设置SSL,请先停掉dl,之后申请,申请好之后开启dl即可。

前面说过如何docke安装,但是很多同学不喜欢docke安装,所以本教程算是对前面教程的一个补充。

其他没啥好说的,具体使用,请自行折腾。

weinxin
我的微信
微信公众号
关注大鸟博客公众号
 最后更新:2022-12-7
大鸟
评论  60  访客  59  作者  1
    • 南通伍林堂文化传播有限公司
      南通伍林堂文化传播有限公司 3

      开启ssl系统错误,服务器错误。

      • asd
        asd 0

        配置不成功 ,失败

        • WSLXB2006
          WSLXB2006 0

          博主辛苦了

          • m0re
            m0re 0

            守护进程可能会有些问题,其他暂时没有问题

            • 耳闻一生
              耳闻一生 1

              守护进程 学习一下

              • 耳闻一生
                耳闻一生 1

                配置不成功,查询守护进程的目录配置

                • 熊猫
                  熊猫 4

                  看看进程守护这一步。

                  • hq
                    hq 0

                    非常感谢博主的分享

                    • MJJ
                      MJJ 0

                      看一下下

                      • hanchen
                        hanchen 1

                        学习一下

                        • 是的是的
                          是的是的 1

                          试试怎么样

                          • 是的是的
                            是的是的 1

                            博主辛苦了

                            • wukoo
                              wukoo 1

                              太强了,哥

                              • wukoo
                                wukoo 1

                                终于学会了,牛比,大鸟哥

                                • mindoc
                                  mindoc 0

                                  学习下配置

                                  • dfsd
                                    dfsd 0

                                    配置不成功

                                    • 南二环的胖纸
                                      南二环的胖纸 1

                                      安装完成了提示还是启动不起来

                                      • 大苏打3
                                        大苏打3 1

                                        配置不成功 ,失败

                                        • 优麦兔
                                          优麦兔 1

                                          谢谢分享教程

                                          • 小火柴
                                            小火柴 1

                                            基本都是成功,为啥ip*端口访问不了

                                            • 362598524
                                              362598524 0

                                              0000厉害了

                                              • mjj
                                                mjj 0

                                                谢谢分享教程

                                                • 兰兰
                                                  兰兰 1

                                                  感谢博主分享

                                                  • 666666666
                                                    666666666 0

                                                    6666666啊

                                                    • 不不不我就是
                                                      不不不我就是 1

                                                      好人一生平安

                                                      • 帅帅
                                                        帅帅 0

                                                        感谢分享

                                                      匿名

                                                      发表评论

                                                      匿名网友

                                                      :?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

                                                      确定