搭建IT团队开发的简单好用的文档管理系统

    MinDoc 简介

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

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

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

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

    本地环境：

        Mac + Docker + 宝塔 CentOS7 容器 + MinDoc

    Mac Docker → 宝塔 CentOS7 容器 → MinDoc 完整部署清单

一、docker安装宝塔

    1. 终端执行命令，一键拉取宝塔纯净镜像，打开 Mac 自带「终端」，逐条复制运行：

# 创建数据持久卷（容器删除数据不会丢）
docker volume create bt_data

# 启动宝塔容器，映射宝塔8888面板端口 + MinDoc需要的8181端口
docker run -tid \
--name bt \
--privileged=true \
--restart always \
-p 8888:8888 \
-p 8181:8181 \
-p 80:80 \
-p 443:443 \
-p 3306:3306 \
-v bt_data:/www \
pch18/baota:clear

    2. 进入容器内部安装官方宝塔面板

# 进入宝塔容器终端
docker exec -it bt /bin/bash

# 容器内执行Ubuntu宝塔官方安装脚本
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ed8484bec

        弹出确认输入 y 回车，等待 5~10 分钟安装完成。

        注意：如果本身是root权限，不需要sudo，直接 bash install.sh ed8484bec

    3. 获取宝塔登录信息，安装结束后终端会输出：

外网面板地址: http://127.0.0.1:8888/xxxx
内网面板地址: http://172.17.0.2:8888/xxxx
username: xxx
password: xxx

        直接在 Mac 浏览器打开 http://127.0.0.1:8888 即可进入宝塔面板。

面板安装后无法访问，如何排查？

1. 检查服务器安全组是否放行面板端口,面板端口查看命令：cat /www/server/panel/data/port.pl
2. 检查面板是否运行正常，尝试执行命令重启宝塔：bt restart如无返回报错说明宝塔正常
3. 执行bt default获取最新面板登录地址尝试访问
4. 如有出现报错相关信息，请联系客服

如何查看默认账号密码？

1. 执行bt default获取默认账户密码
2. 执行bt 5 重置宝塔面板密码
3. 如果出现仍无法登录的情况，请联系客服

二、登录宝塔（宝塔面板内操作）

        关闭开机弹出的 LNMP 一键安装弹窗，不要安装 LNMP/LAMP/JAVA 环境，MinDoc 为单文件程序，不需要 Web 运行环境。

        防火墙弹窗直接关闭忽略：Docker 宿主机已做端口映射，容器内防火墙无需启用。

三、进入宝塔终端执行部署命令（逐条复制执行）

步骤 1：创建存放目录并进入
    mkdir -p /www/wwwroot/mindoc && cd /www/wwwroot/mindoc
步骤 2：官方 GitHub 源 + 国内镜像加速下载安装包（官方原文件，无篡改）	
    wget https://github.com/mindoc-org/mindoc/releases/download/v2.2-beta.2/mindoc_linux_amd64.zip
步骤 3：解压压缩包
    unzip mindoc_linux_amd64.zip
步骤 4：赋予二进制程序可执行权限
    chmod +x mindoc_linux_amd64
步骤 5：初始化 SQLite 内置数据库（无需手动新建 MySQL 库）
    ./mindoc_linux_amd64 install

        出现 Install Successfully! 代表数据库初始化完成。

常用命令：

1. 重新进入宝塔命令行		
    docker exec -it bt /bin/bash
2. 停止 / 重启宝塔容器
    docker stop bt
    docker restart bt

四、配置宝塔计划任务，实现后台常驻 + 容器重启自动启动

    1.宝塔左侧菜单栏 → 计划任务 → 添加任务

    配置项：

            任务类型：Shell脚本

    执行周期：每分钟

    任务名称：MinDoc文档服务保活

    脚本内容完整粘贴：

cd /www/wwwroot/mindoc/mindoc_linux_amd64
if ! pgrep -f mindoc_linux_amd64 > /dev/null
then
    nohup ./mindoc_linux_amd64 > mindoc.log 2>&1 &
fi

    2.点击【添加】，任务立即生效，自动拉起 MinDoc 进程。

五、访问 MinDoc 管理后台

    1.本机 Mac 浏览器访问

        http://127.0.0.1:8181

    2. 公司局域网其他电脑访问

        先在 Mac 终端输入 ifconfig 查看本机局域网 IP（如192.168.3.xx），访问：

        http://局域网IP:8181

默认登录账号密码
账号：admin
密码：123456
✅ 登录后第一时间进入个人设置修改默认初始密码。

六、官方项目与文档地址

    GitHub 官方仓库：https://github.com/mindoc-org/mindoc 

    官方使用手册：https://www.iminho.me/wiki/docs/mindoc/ 

本文为崔凯原创文章,转载无需和我联系,但请注明来自冷暖自知一抹茶ckhttp://www.cksite.cn

• 上一篇： 文档系统搭建
• 下一篇： 搭建 webcron