Docer部署ShowDoc-如何在本地搭建一个属于自己的在线文档

1、环境准备

        Docker version 27.3.1

         如何安装Docker，请见Ubuntu正确安装Docker和Docker Compose详细讲解。

2、Docker安装ShowDoc

2.1、下载ShowDoc镜像
 

root@keyan:~# docker pull star7th/showdoc

        执行记录，如下所示：

root@keyan:~# docker pull star7th/showdoc
Using default tag: latest
latest: Pulling from star7th/showdoc
da9db072f522: Pull complete 
de547441a4ff: Pull complete 
c7590f70f5d2: Pull complete 
1d867e5ebdf5: Pull complete 
8ecfb8ee1636: Pull complete 
5fc63d72f560: Pull complete 
5a95d1d969d3: Pull complete 
3b8da19c3457: Pull complete 
70cc9d7c2d21: Pull complete 
4f4fb700ef54: Pull complete 
1ad37780cc3e: Pull complete 
d1de838bd60f: Pull complete 
c4bda143f250: Pull complete 
e09b53b7d23b: Pull complete 
7e7b08fd16ee: Pull complete 
24559b32e2ee: Pull complete 
96cf3ddfacb9: Pull complete 
2b3d83a2c875: Pull complete 
21d23a973497: Pull complete 
f790e7a6166e: Pull complete 
03ccaca4d46b: Pull complete 
53d7c5d412e0: Pull complete 
9e3469791fce: Pull complete 
Digest: sha256:36201b6751d2511143df665c1daa05931b469d1933fbe6acee8ed5cc5b6cecdd
Status: Downloaded newer image for star7th/showdoc:latest
docker.io/star7th/showdoc:latest
root@keyan:~# 

        可以查看pull下来的showdoc，如下所示：

root@keyan:~# docker images
REPOSITORY        TAG       IMAGE ID       CREATED        SIZE
star7th/showdoc   latest    45f12220f272   29 hours ago   601MB
root@keyan:~# 

2.2、创建数据目录

root@keyan:~# mkdir -p /data/showdoc

2.3、目录授权

root@keyan:~# chmod -R 777 /data/showdoc

2.4、运行ShowDoc容器

         说明：本机使用5099端口映射容器的80端口，可以根据需要自定设定

root@keyan:~# docker run -d --name showdoc --user=root --privileged=true -p 5099:80  --restart always -v /data/showdoc:/var/www/html/ star7th/showdoc
aa35190cc10215586ec56e91b180f7c70a18cb82efe6bd83a2eb63e06057518e
root@keyan:~# 

        也可以使用80

root@keyan:~# docker run -d --name showdoc --user=root --privileged=true -p 80:80  --restart always -v /data/showdoc:/var/www/html/ star7th/showdoc
a2e67385b1ba93fcf23e685658a53f093867064ef27fb87c3a5e8ea0b159f744
root@keyan:~# 

        如使用80端口， showdoc访问地址：http://192.168.x.13/，如下图：

   

2.5、查看ShowDoc容器状态

root@keyan:~# docker ps -a
CONTAINER ID   IMAGE             COMMAND                  CREATED         STATUS         PORTS                                                        NAMES
aa35190cc102   star7th/showdoc   "/entrypoint bash do…"   6 seconds ago   Up 4 seconds   443/tcp, 9000/tcp, 0.0.0.0:5099->80/tcp, [::]:5099->80/tcp   showdoc
root@keyan:~# 

root@keyan:~# docker ps -a
CONTAINER ID   IMAGE             COMMAND                  CREATED          STATUS          PORTS                                                  NAMES
cd337e2309f8   star7th/showdoc   "/entrypoint bash do…"   59 seconds ago   Up 58 seconds   443/tcp, 0.0.0.0:80->80/tcp, :::80->80/tcp, 9000/tcp   showdoc
root@keyan:~# 

3、ShowDoc使用

        本地IP:192.168.x.13

  3.1、ShowDoc在线文档系统初始化

        showdoc访问地址：http://192.168.x.13:5099/

点击：选择语言：中文，初始化成功，默认管理员账户密码是showdoc/123456。如下图：

点击：进入首页，如下图：

  3.2、ShowDoc在线文档系统登录

输入用户名/命名：showdoc/123456，如下图：

进入showdoc在线文档系统，如下图：

通过浏览器访问地址，使用showdoc，如下图：

也可下载客户端，点击客户端，进入客户端下载页面，showdoc客户端，如下图：

3.3、showdoc客户端安装

     双击安装showdoc Setup 1.1.0.exe，安装完成后在电脑桌面上出现一个图标：   

双击showdoc图标，配置showdoc服务地址,如下图：

输入showdoc账号密码，如下图：

进入showdoc客户端界面，如下图：

       修改密码，如下图：

至此，可以使用搭建的在线文档系统。