showdoc 的安装使用
2018-10-31 本文已影响25人
XM_Dong
现在开发项目总是没有文档，喊来喊去的传递 word 真的是让人感觉回到了通讯全靠吼的年代了。最近自己都是在做一些纯 web 的开发，虽说自己的老本行 iOS 还没有扔下，但是真的是没有当年对她的的执着了。最近在和小伙伴开发移动端后台，一直以来都想开发一个开发后台出来，总是因为自己懒惰而没有做成。前几天研究下开源的文档管理，虽说阿里的 RAP 真的不错 ，但是要是一个不懂 java 的人真的很难使用。showdoc 这款真的不错（虽然我们不能随意修改他的界面及项目结构），对于只是想在自己的服务器上安装一个使用的文档还是足够的，它使用的是 sqlite 数据库，但是哪家公司会有10000+的项目呢。
下面我就说下我在我自己的小服务器安装的心得吧！
showDoc官网上有自动安装的过程
这里我主要说下你自动安装会遇到的问题
首先你你先下载 showdoc 文件
cd #你指定的目录
#下载脚本并赋予权限
wget https://www.showdoc.cc/script/showdoc;chmod +x showdoc;
接下来安装，在执行下面命令之前我说明下，你的服务器必须打开 DNS 8.8.8.8，不然在自动安装 docker 的时候会报错。我在安装的时候总是报错也是很抓头的。
vim /etc/resolv.conf
#添加
nameserver 8.8.8.8
当然，你的服务器的 DNS 设置了。就直接执行下面方式就可以了
#默认安装中文版。如果想安装英文版，请加上en参数，如 ./showdoc en
./showdoc
执行完之后就可以通过 ip：4999 访问到你的服务器 ，当然你的服务器需要将端口4999打开，如果不知道怎么打开，参考：阿里云服务器专有网络直接分配公网ip后如何被外网访问
showDoc 的其他操作
#执行上面命令便会自动安装完成。下面附上脚本其他命令，以便管理showdoc时可以用得上。
#停止
./showdoc stop
#重启
./showdoc restart
#升级showdoc到最新版
./showdoc update
#卸载showdoc
./showdoc uninstall
