ShowDoc 搭建及使用 - 一个非常适合IT团队的 API文档、技术文档工具

文档地址：https://www.showdoc.com.cn/help/13732

使用docker进行安装：

#原版官方镜像安装命令(中国大陆用户不建议直接使用原版镜像，可以用后面的加速镜像)
docker pull star7th/showdoc 

# 中国大陆镜像安装命令（安装后记得执行docker tag命令以进行重命名）
docker pull registry.cn-shenzhen.aliyuncs.com/star7th/showdoc
docker tag registry.cn-shenzhen.aliyuncs.com/star7th/showdoc:latest star7th/showdoc:latest 

##后续命令无论使用官方镜像还是加速镜像都需要执行

#新建存放showdoc数据的目录
mkdir -p /data/showDocData
chmod  -R 777 /showDocData
# 如果你是想把数据挂载到其他目录，比如说/data1，那么，可以在/data1目录下新建一个showdoc_data/目录，
# 这样既能保持跟官方教程推荐的路径一致，又能达到自定义存储的目的.

#启动showdoc容器-目录地址保持一致（/data/showDocData）
docker run -d --name showdoc --user=root --privileged=true -p 4999:80 \
-v /data/showDocData:/var/www/html/ star7th/showdoc

# 删除旧容器 - 如果需要重启的话
docker stop showdoc && docker rm showdoc 

搭建好之后用nginx做个反向代理

server {
  listen 80;
  server_name XXX.XXX.cn;
  location / {
    proxy_pass http://127.0.0.1:4999/;
  }
}

日常备份数据：

创建sh文件 sh_backup_showdoc_db.sh 执行后按时间创建备份数据

cp /data/showDocData/Sqlite/showdoc.db.php /data/backupFile/showdoc$(date +%Y%m%d%H%M%S).db.php

配置定时任务contable

vi /etc/crontab
#每日 18:15执行
15 18   * * *   root    sh /data/startFile/sh_backup_showdoc_db.sh

如果有需要可直接替换备份数据(名称要改成一致)
/data/showDocData/Sqlite/showdoc.db.php