ShowDoc

介绍ShowDoc的各种功能


Docker方式安装

<h3>基础安装</h3> <p>安装前请确保你的环境已经装好了docker服务 。docker的安装教程在网上比较多,可以搜索了解下。这里重点介绍showdoc.</p> <pre><code class="language-bash"># 原版官方镜像安装命令(中国大陆用户不建议直接使用原版镜像,可以用后面的加速镜像) # 如果你打算安装ARM版本的docker镜像,请将 latest 标签改为 arm-latest。如果失败,可尝试根据自身设备架构,加入--platform参数 docker pull star7th/showdoc:latest # 中国大陆镜像安装命令(安装后记得执行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 /showdoc_data/html chmod -R 777 /showdoc_data # 如果你是想把数据挂载到其他目录,比如说/data1,那么,可以在/data1目录下新建一个showdoc_data/目录, # 然后在根目录的新建一个软链接/showdoc_data到/data1/showdoc_data # 这样既能保持跟官方教程推荐的路径一致,又能达到自定义存储的目的. #启动showdoc容器 docker run -d --name showdoc --user=root  --restart=always --privileged=true -p 4999:80 \ -v /showdoc_data/html:/var/www/html/ star7th/showdoc </code></pre> <p>根据以上命令操作的话,往后showdoc的数据都会存放在 /showdoc_data/html 目录下。 你可以打开 <a href="http://localhost:4999">http://localhost:4999</a> 来访问showdoc (localhost可改为你的服务器域名或者IP)。账户密码是showdoc/123456,登录后你便可以看到右上方的管理后台入口。建议登录后修改密码。 对showdoc的问题或建议请至 [github](<a href="https://github.com/star7th/showdoc">https://github.com/star7th/showdoc</a> &quot;github&quot;) 出提issue。若觉得showdoc好用,不妨点个star。</p> <h3>如何升级</h3> <p>这里的升级是针对上面docker安装方式的升级。如果你原来是采用非docker安装方式(如php安装方式)的话,请跳过本部分文字,直接去看下部分。</p> <pre><code class="language-bash"> # 从原版官方库更新镜像。(中国大陆用户不建议直接使用原版镜像,可以用后面的加速镜像) 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 ##后续命令无论使用官方镜像还是加速镜像都需要执行 rm -rf /showdoc_data/html_bak #备份。如果可以的话,命令中的html_bak还可以加上日期后缀,以便保留不同日期的多个备份 mv /showdoc_data/html /showdoc_data/html_bak # 新建准备存放新版代码的目录 mkdir -p /showdoc_data/html chmod -R 777 /showdoc_data/html # 删除旧容器 docker stop showdoc &amp;amp;&amp;amp; docker rm showdoc #启动showdoc容器 docker run -d --name showdoc --user=root --privileged=true -p 4999:80 \ -v /showdoc_data/html:/var/www/html/ star7th/showdoc #执行新代码安装。默认安装中文版。如果想安装英文版,将下面参数中的zh改为en curl http://localhost:4999/install/non_interactive.php?lang=zh #转移旧数据库 \cp -f /showdoc_data/html_bak/Sqlite/showdoc.db.php /showdoc_data/html/Sqlite/showdoc.db.php #转移旧附件数据 \cp -r -f /showdoc_data/html_bak/Public/Uploads/. /showdoc_data/html/Public/Uploads # 重新给权限 chmod -R 777 /showdoc_data/html #如果中途出错,请重命名原来的/showdoc_data/html_bak文件为/showdoc_data/html ,然后重启容器便可恢复。 </code></pre> <h3>非docker安装方式如何升级到docker安装方式</h3> <p>先参考前文,用docker方式全新安装一个showdoc,并且做好数据持久化。 接下来,假设你原来安装的旧showdoc已上传到服务器的 /tmp/showdoc 目录,那么</p> <pre><code class="language-bash"> #转移旧数据库 \cp -r -f /tmp/showdoc/Sqlite/showdoc.db.php /showdoc_data/html/Sqlite/showdoc.db.php #转移旧附件数据 \cp -r -f /tmp/showdoc/Public/Uploads/. /showdoc_data/html/Public/Uploads </code></pre> <h3>数据备份</h3> <p>备份/showdoc_data/html 目录即可。比如执行下面命令压缩存放</p> <pre><code class="language-bash">zip -r /showdoc_data/showdoc_bak.zip /showdoc_data/html # 其中showdoc_bak.zip可以用日期后缀命名,以便多个备份。你也可以用定时任务来实现定时备份。</code></pre> <h3>其他参考命令</h3> <pre><code class="language-bash"> docker stop showdoc # 停止容器 docker restart showdoc #重启showdoc容器 docker rm showdoc #删除showdoc容器 docker rmi star7th/showdoc #删除showdoc镜像 docker stop $(docker ps -a -q) ;docker rm $(docker ps -a -q) ; #停止并删除所有容器。危险命令,不懂勿用。 docker rmi -f `docker images | grep showdoc| awk '{print $3}'` # 删除所有名字含有showdoc关键字的镜像</code></pre> <h3>其他支持</h3> <ul> <li> <p>常见问题:[点此查看](<a href="http://www.showdoc.cc/help?page_id=16118">http://www.showdoc.cc/help?page_id=16118</a> &quot;点此查看&quot;)</p> </li> <li> <p>如果你没有自己的服务器,但又想使用ShowDoc作为分档分享工具,你可以使用在线的ShowDoc <a href="http://www.showdoc.com.cn">http://www.showdoc.com.cn</a></p> </li> <li> <p>ShowDoc使用交流qq群</p> <p>[点此查看]( <a href="https://www.showdoc.com.cn/help?page_id=6912631551342243">https://www.showdoc.com.cn/help?page_id=6912631551342243</a> &quot;点此查看&quot;)</p> </li> </ul>

页面列表

ITEM_HTML