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，然後用你自己的賬戶登入下，看看所有的項目是否存在，也可以登入預設的管理者賬号（我就是先登入的管理者賬号，然後一直以為沒有遷移成功呢）。