showdoc私有部署-数据迁移-服务器迁移

showdoc的在线文档已经开始限制人数了，所以，团队就私有化部署了showdoc。

showdoc私有部署，使用，其实不复杂，即使不用指定db做数据存储也没关系，可以做到数据迁移或者服务器迁移的。

先给个官网地址：https://www.showdoc.com.cn/help/1385767280275683

安装部署

我们选一种最快捷的方式，自动安装，如图：

命令

#停止
 ./showdoc stop 

 #重启
 ./showdoc restart

 #升级showdoc到最新版
 ./showdoc update

 #卸载showdoc
 ./showdoc uninstall
           

服务器或数据迁移

官网描述：

这里的迁移服务器，指的是：服务器A已经安装好了showdoc， 然后现在要迁移到服务器B去。

首先参考教程，在新服务器上全新安装一个showdoc。推荐使用官方自动脚本或者docker方式安装。

假如你是官方自动脚本或者docker方式安装，那么数据将放在/showdoc_data/html下。复制旧服务器的Sqlite/showdoc.db.php，以及Public/Uploads/下的所有文件（如没有则可忽略之），覆盖到新showdoc目录的相应文件。覆盖后重新给这些文件可写权限.

（可选）如果原有文档里已经有上传的图片和附件，换新的域名的时候也许访问不了。可进入数据库把图片附件路径改一下。showdoc使用sqlite数据库。数据库文件是安装目录下的Sqlite/showdoc.db.php。你可以网络搜索如何在命令行中使用 sqlite数据库，或者使用SQLiteStudio等可视化工具。进入数据库后，执行update page set page_content = replace(page_content,’原始host’,’新host’); 和 update upload_file set real_url= replace(real_url,’原始host’,’新host’);

常见误区

复制旧服务器文件过去后，忘记给可写权限

新服务器本身没有安装好环境，如缺少php-sqlite扩展等

直接用新代码覆盖旧代码，而不是按照官方推荐方式去做。

服务器转移数据的时候使用FTP。注意，如果使用FTP，应该用二进制模式传输，否则会破坏数据库文件

注意⚠️：

迁移后，重启showdoc，然后用你自己的账户登录下，看看所有的项目是否存在，也可以登录默认的管理员账号（我就是先登录的管理员账号，然后一直以为没有迁移成功呢）。