瓜奇 WordPress 主題是原知名主題 Seven,7B2 開發者的最新力作。瓜奇主題用途廣泛,適用性強,自帶多國語言功能,適合個人博客、社群搭建、商城搭建等場景。
瓜奇主題還在早期的體驗階段,具體的部署過程作者那邊還沒有出來,本文主要介紹其主題的部署過程,方便大家嘗鮮。
- 參考教程:詳情
推薦使用全新的服務器和域名來體驗,切勿使用在正式環境中
架構

有別于傳統主題,瓜奇是一款前后端分離的主題,我們需要分別部署后端和前端內容。
而且,前后端可以分別部署在不同的服務器上。
資源 - 準備
本步驟主要是獲取瓜奇插件和構建的源代碼
登錄 7B2 官網的個人中心,確認自己綁定的手機號或郵箱。
登錄瓜奇官網-構建器,輸入手機號或郵箱登錄
點擊右上角站點配置按鈕

保存API Secret信息,輸入客戶端域名和后端域名并保存。
- API Secret:唯一身份憑證,后續配置瓜奇插件時,通信用
- 客戶端域名:前臺展示用,無任何限制,可以綁定多個,是個域名就能用
- 后端域名:WordPress 管理數據用,有授權限制
注意,客戶端域名和后端域名,后續強制使用 SSL 安全證書

資源 - 下載
點擊右上角下載源碼按鈕

在彈出框中下載好瓜奇插件和前端代碼,保留備用。
注意,我們這里下載的時 PHP 8.1 版本,后續會用到。

后端 - 運行環境
推薦準備 Debian12 系統,連接到服務器后,通過命令行安裝寶塔控制面板
我們安裝以下內容
- Nginx(Nginx 1.26.3)
- MySQL 8.0 以上(MySQL 8.0.35)
- PHP 8.1 (PHP 8.1.32)
- phpMyAdmin 5.0
其中,PHP 推薦安裝 Redis 擴展
后端 - 部署
我們新建一個 PHP 站點,
- 域名選擇上方填寫的后端域名,我這里是 api.npc.ink
- PHP 版本選擇上方準備資源部分的PHP 8.1
- 需要部署 SSL 安全證書
就正常的 部署 WordPress ,
然后安裝我們在“準備資源”時下載的瓜奇插件并啟用。

根據提示,將下載的 loader81.zip 文件下載到本地解壓,將解壓的文件根據要求,上傳到指定目錄
/www/server/php/81/lib/php/extensions/no-debug-non-zts-2222
按照要求添加好代碼后,重啟 PHP 8.1 ,沒有了上述提示,就是配置成功了。
注意:如果你在添加 loader81.so 代碼后,在 PHP 8.1 中安裝了擴展,請重新檢查 loader81.so 代碼的添加狀態,此代碼必須是單獨的一行才行,修改并保存后,記得重啟 PHP 8.1

后端 - WPGraphQL 插件
我們需要搜索 WPGraphQL 插件,并安裝。此插件是給前端提供數據接口用。
安裝并啟用插件后,點擊Settings 選項,選擇 Headless Login 選項,開啟賬戶密碼登錄

后端 - 瓜奇插件
我們從左側菜單中,打開瓜奇菜單選項,
- 在 API Secret 選項中輸入我們在“準備工作”中保存的 API Secret,
- 在前端網址中,輸入我們在“準備工作”中保存的前端域名,
輸入完成后,點擊“保存配置”按鈕

前端 - 準備文件
這一步稍微有點難度,跟著步驟走,不會太難的。
我們在寶塔的“文件”菜單中,找到這個路徑
/www/wwwroot/
新建一個 guaqi.npc.ink 文件夾,將“準備資源”時下載的前端文件放入并解壓,如下圖

前端 - 部署
我們在寶塔面板中,選中“網站” → “Node項目”→“添加Node項目”

配置
- 項目目錄:
/www/wwwroot/guaqi.npc.ink/server
- 項目名稱:可以填站點名稱,或用途等
- 啟動選項:
/www/wwwroot/guaqi.npc.ink/server/index.mjs
- 其他的默認,Node版本選最新的穩定版即可

沒有Node版本可選的,可以點擊“安裝其他版本”

點擊“更新版本列表”后,選擇最新穩定版安裝即可

安裝后,點擊“ Node 版本”選項旁邊的刷新按鈕,即可選擇你需要的 Node 版本

確認選項填寫無誤后,點擊下方保存按鈕即可。
前端 - 配置
點擊寶塔面板菜單中的“網站”→“Node項目”下網站的設置按鈕,
域名管理中添加前端域名

外網映射中開啟映射功能

SSL 選項中,部署 SSL 安全證書

結束
致此,整個瓜奇主題部署完成,您會注意到這幾個方面
- 客戶端域名:
guaqi.npc.ink
- 僅供內容展示用 - 后端域名:
api.npc.ink
- 配置選項用
現在,您可以在后端域名:api.npc.ink
的瓜奇插件中配置各種選項,如下圖

如果您使用與“客戶端域名”不同的“后端域名”,并對“后端域名”進行保密,
那么,您將獲的一個強大的內容管理平臺,他更安全,也更容易更換各種“客戶端域名”馬甲,這在某些需要頻繁更換“客戶端域名”的情況下很有用,如以下情況
- 視頻站
- 資源站
- 外貿多語言站
然后,將客戶端域名:guaqi.npc.ink
提供給外部,您就能公開展示內容了
當然,以上僅僅是部署階段的內容,如果您需要在“客戶端域名”中,正常展示各種內容,您還需要通過瓜奇官網的構建器,分別給移動端、平板端、電腦端分別構建您的:
- 內容頁面
- 自定義頁面
- 文章 - 內頁
- 文章 - 存檔頁
- 文章 - 標簽頁
- 用戶內頁
- 社區 - 帖子內頁
- 社區-帖子存檔頁
- 社區-帖子標簽頁
- 社區-懸賞回答也
構建完成后,點擊右上角的“發布”按鈕,您就能在“客戶端域名”上看到根據您的構建展示的內容了


注意:目前瓜奇主題還在不斷完善中,目前僅供體驗,不推薦使用在正式生產環境中。
上述內容均在測試服務器中搭建,推出本教程后將銷毀服務器處理,還望大家也能保護自己的隱私和安全