linux 安装部署 showdoc

港控/mmm° 2021-10-19 16:18 646阅读 0赞

今天，日月教大家如何在自己的服务器部署showdoc,当然，  
如果你没有自己的服务器，但又想使用ShowDoc作为分档分享工具，你可以使用在线的ShowDoc  
[http://www.showdoc.cc][http_www.showdoc.cc]

**本篇文章，将手把手教大家如何在自己的服务器部署使用showdoc.**

**安装docker**

Docker 运行在 CentOS 7 上，要求系统为64位、系统内核版本为 3.10 以上。  
通过 uname -r 命令查看你当前的内核版本  
**1、安装一些必要的系统工具**

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 1]

**2、添加软件源信息**

sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

![在这里插入图片描述][2019081323125169.]

**3、更新 yum 缓存**

sudo yum makecache fast

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 2]

**4、安装 Docker-ce**

sudo yum -y install docker-ce

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 3]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 4]

**5、启动 Docker 后台服务**

sudo systemctl start docker

![在这里插入图片描述][20190813231448817.]

OK，至此，docker安装完毕，有人可能会问，为啥要安装docker？那当然是showdoc的安装需要依赖docker啦！！！

## 安装ShowDoc ##

**1、下载脚本并赋予权限**

wget https://www.showdoc.cc/script/showdoc
    
    
    chmod +x showdoc

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 5]

**2、执行脚本**  
\#默认安装中文版。如果想安装英文版，请加上en参数，如 ./showdoc en

./showdoc

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 6]

如看到上图的结果，则说明安装成功。默认端口为4999，记得要去防火墙开启访问端口。  
浏览器访问http://ip:4999  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 7]

至此，showdoc算是部署完毕了，默认账号密码是：showdoc 123456  
至于怎么使用我这里就不在一一介绍了，showdoc官方文档写的很详细，让我青睐这款工具的主要原因有两个。一个是自动化生成API接口文档，再就是自动化生成数据字典文档。  
官方文档地址：[https://www.showdoc.cc/help?page\_id=1385767280275683][https_www.showdoc.cc_help_page_id_1385767280275683]

如果该文章有帮助到您，就留言点个赞吧！您的支持与肯定是我持续更新最大的动力。

[http_www.showdoc.cc]: http://www.showdoc.cc
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70]: /images/20211019/dc102c965556468b97150c5a13f1cddc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 1]: /images/20211019/5737827317c648eb8467d4604bd3faa7.png
[2019081323125169.]: /images/20211019/97af2d1d74c743f69a81e0e104e8f5ce.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 2]: /images/20211019/7ae8e5d1f92845bcaee274a4b443dd71.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 3]: /images/20211019/7905183643954d1cb870824abd023740.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 4]: /images/20211019/224fe59c22064633b8d82e90f3eb4f05.png
[20190813231448817.]: /images/20211019/9c72afa56e854c848f8f089922be2658.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 5]: /images/20211019/613ca54a424e440e81377f14b7037700.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 6]: /images/20211019/f52ee10fb3bc412e99dda90c8f05ae04.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDYyMzczNg_size_16_color_FFFFFF_t_70 7]: /images/20211019/4caad9c57c77456cab319625ac089164.png
[https_www.showdoc.cc_help_page_id_1385767280275683]: https://www.showdoc.cc/help?page_id=1385767280275683