1、进入showdoc官网帮助目录下 https://www.showdoc.cc/web/#/help?page_id=828455960655160 阅读自动安装部署相关事项;
2、利用xshell进入自己服务器 按教程来, 如果报当前系统没有安装过 docker,则进入步骤3,如果很顺利,那么恭喜你;
3、在控制台 输入命令: yum install docker 进行docker安装,等待安装;
4、安装完成后 输入命令:systemctl start docker.service 启动docker;
5、重新输入命令 : ./showdoc 继续安装showdoc,此时应该没问题了,可以输入你服务器公网ip+端口号进行访问;
6、如果想用自己的域名访问项目,则把showdoc项目中的html文件移动到对应的目录就行了。
7、是不是对步骤6有点疑惑?好吧,我上个例子:
showdoc安装完之后默认放在根目录下 /showdoc_data 然后如果你的域名是 apidoc.xxx.com,那么你应该做的是:
cp -Rf /showdoc_data /data/wwwroot/apidoc.xxx.com (这段命令是复制文件夹至目标文件夹);
复制完之后你可以输入你的域名+端口号测试 比如:apidoc.xxx.com:4999 如果访问成功,那就OK了。
8、虽然前面7不已经解决问题了,但还是有点不完美的地方就是每次要访问项目的时候都需要敲上域名,很烦人,此时就可以考虑考虑用用nginx反向代理,来解决这个问题了,步骤如下:
8.1 进入你的nginx配置文件 一般在 /usr/local/nginx/conf/vhost 里面,找到文件下载到桌面来用编辑器打开;
8.2 在配置文件中添加如下代码:
root /data/wwwroot/apidoc.***.com/html; //把showdoc的目录文件html加上这个它默认就会寻找这个文件下面的index.php文件了
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header X-Nginx-Proxy true;
proxy_set_header Connection "";
proxy_pass http://127.0.0.1:4999; //主要代码,反向代理
}
8.3 配置完成之后把这个配置文件上传到服务器上,一般会提示要不要替换,选择替换即可;
8.4 输入命令: service nginx restart 重启nginx服务;
8.5 此时输入域名 apidoc.xxx.com 应该就能直接打开项目了。