windows和linux docker 安装Showdoc

ShowDoc是一个非常适合IT团队的在线API文档、技术文档工具,我们可以使用Showdoc来编写在线API文档、技术文档、数据字典、在线手册等。有时候我们的文档需要部署在自己的服务器上,这里分享windows环境部署和linux 使用docker部署showdoc方法。

windows

1、安装PHP环境

windows部署showdoc需要php环境,我们下载PHP运行环境(WAMP)wamp-server-wamp5-2-5-multi-win进行使用,我整理了一个资料包:https://pan.baidu.com/s/16M-j5TbNkwp0yL6NnODe9A  提取码:qidi,也可以下载文章附件,或是网上自己寻找这个工具自行安装。

在资料包中找到wamp-server-wamp5-2-5-multi-win.exe打开安装,非常简单

2、安装完后可以看到右下角有图标,右击语言选择Chinese

3、之后单机图标选择  www目录,会自动打开www所在目录地址,将showdoc代码,放入目录中,showdoc代码资料包中有,也可以到https://github.com/star7th/showdoc 进行下载最新版本

4、放入后,我们修改一下wamp-server的地址,默认为80,避免和之后的一些端口冲突。点击小图标,选择Apache->httpd.conf,查找关键字Listen ,修改为你需要的端口号

5、点击右下角小图标,点击重新启动所有服务,在浏览器输入地址,如我配置的端口是8096(根据你的端口号替换,默认80),就输入http://localhost:8096/showdoc,就部署成功啦,默认admin账号为showdoc  密码123456

6、如果需要用Navicat连接数据库,则需要进入\www\showdoc\Sqlite目录中把showdoc.db.php复制一份,名字改为showdoc.db就可以进行连接。

ps:如果需要的话我就上传一个安装录屏,3-5分钟即可安装完成方便快捷。

Linux Docker

docker安装更加简单,如有有朋友需要再linux上安装showdoc,可以选用此方法

1、选择docker镜像,这里我选择的是star7th/showdoc ,默认最新版本,输入

docker pull star7th/showdoc

2、你也可以根据自己的需求,下载对应镜像

3、安装,如果本地没有对应进行会进行下载,不过我们第一步已经拉取镜像了

docker run -it -d --name showdoc -p 20080:80 -p 29000:9000 -p 90443:443 -v 
 /dockerdata/showdoc_data/html:/var/www/html/ star7th/showdoc

-- 挂载和端口映射根据自己需求配置,想详细了解参数的朋友建议先补下docker知识
--name 容器名称
-p 端口映射 宿主机端口号:容器内部端口号
-v 挂载 宿主机目录地址:容器内部目录地址 

4、输入下列指令,如果对于的容器状态为up,则启动成功,页面访问对应地址即可(http://xxx.xx.xx.xx:port/showdoc)

docker ps -a

官方安装手册地址

https://www.showdoc.cc/help?page_id=13732

以上为windows和linux对showdoc的安装方法,有问题欢迎留言

发布了22 篇原创文章 · 获赞 4 · 访问量 3033

猜你喜欢

转载自blog.csdn.net/weixin_43841693/article/details/101776316