把WordPress站變成AI智能知識庫，WP2AI一鍵部署超簡單！

總所周不知，星哥有一個WordPress站，叫星哥玩云。

最近看了xiaoz的文章 https://blog.xiaoz.org/archives/21824 ，可以將WordPress文章變成智能知識庫，于是根據這篇文章試試看。

這款工具能把咱們辛苦運營的 WordPress 博客內容，一鍵轉化成智能 AI 問答知識庫，不管是提升站內搜索體驗，還是給讀者提供更精準的內容解答，都太香了！今天就把這份保姆級部署教程分享給大家。

一、WP2AI 到底有多好用？

先跟大家說說這款工具的核心亮點，畢竟好用才值得折騰嘛！WP2AI 是由開發者基于 Golang+Vue3 開發的輕量級工具，而且完全開源，對咱們站長來說特別友好。

它的核心功能堪稱 “建站神器”：

1. 1. 自動掃描 WordPress 文章：不用手動一條條導入，工具能批量抓取博客內容，省超多時間；

2. 2. 內容智能向量化：把文字內容轉化為機器能理解的向量數據，這是 AI 問答精準的關鍵；

3. 3. AI 問答搜索：讀者不用再翻遍整篇文章找答案，直接提問，AI 就能精準給出對應內容；

4. 4. 后臺管理 + API 接口：不僅有可視化后臺方便操作，還支持 API 對接，拓展性拉滿。

不管你是個人博客站長，想提升讀者的搜索體驗；還是運營專業知識平臺，需要高效整合內容；甚至是企業網站管理者，想給客戶提供智能問答服務，WP2AI 都能完美適配。

二、Docker 一鍵部署，兩種方式任選

WP2AI 目前僅支持 Docker 安裝，不用操心復雜的環境配置，新手也能輕松上手，星哥實測全程不到 5 分鐘！

方式一：Docker Compose 安裝（推薦）

這種方式配置更清晰，后續管理也方便。先新建一個 docker-compose.yml 文件，復制以下內容：

如果你的 WP2AI 和 WordPress 在同一臺服務器，用 HOST 網絡模式（記得放行 2080 端口）：

                                                           version: '3'
services:
    wp2ai:
        container_name: wp2ai
        volumes:
            - '/opt/wp2ai/data:/opt/wp2ai/data'
        network_mode: "host"
        restart: always
        image: 'helloz/wp2ai'

要是 WP2AI 和 WordPress 不在同一服務器，就用 bridge 網絡模式，修改配置如下：

                                                           version: '3'
services:
  wp2ai:
    container_name: wp2ai
    volumes:
      - '/opt/wp2ai/data:/opt/wp2ai/data'
    ports:
      - '2080:2080'
    image: 'helloz/wp2ai'
    restart: always

配置好后，執行docker-compose up -d就能啟動了。

方式二：Docker 命令行安裝

嫌寫配置文件麻煩？直接用命令行也能搞定！

HOST 網絡模式（需自行放行 2080 端口）：

                                                           docker run -d \
  --name wp2ai \
  -v /opt/wp2ai/data:/opt/wp2ai/data \
  --network host \
  --restart always \
  helloz/wp2ai

想自定義端口的話，用這個命令：

                                                           docker run -d \
  --name wp2ai \
  -v /opt/wp2ai/data:/opt/wp2ai/data \
  -p 2080:2080 \
  --restart always \
  helloz/wp2ai

小提醒：如果拉取鏡像速度慢，換成加速地址pub.tcp.mk/helloz/wp2ai就行。

三、實際執行

星哥的服務器是安裝了寶塔的Linux系統

                                                           準備用到的域名： wp2ai.xgss.net
域名需要提前解析到服務器

如圖，新建站點

2.運行docker

進入寶塔，點擊終端

                                                           docker run -d \
--restart always \
--name wp2ai \
--net=host \
-v /www/wwwroot/wp2ai.xgss.net/data:/opt/wp2ai/data \
pub.tcp.mk/helloz/wp2ai


 # 注意：/www/wwwroot/wp2ai.xgss.net/data 這個路徑可以換成你的

查看日志

                                                           docker logs wp2ai
Database connection succeeded!
sqlite_version=3.46.1, vec_version=v0.1.6


 2026/04/21 10:28:20 /home/runner/work/wp2ai/wp2ai/model/config.go:29
[error] failed to initialize database, got error dial tcp 127.0.0.1:3306: connect: connection refused
failed to connect database: dial tcp 127.0.0.1:3306: connect: connection refused

配置ssl證書

訪問網站。

四、初始化，讓 AI 跑起來

部署完成后，接下來的操作就更簡單了，星哥給大家梳理了關鍵步驟：

1. 1. 訪問 http://你的服務器IP:2080 或者使用域名，按照頁面提示完成初始化配置；

2. 2. 進入后臺【參數設置】，填寫 WordPress 數據庫信息、向量模型、AI 模型等關鍵配置（跟著提示填，不會錯）；

3. 3. 到【文章數據 - 批量掃描】板塊，啟動掃描功能，系統會自動把 WordPress 文章入庫并向量化，實測 1 分鐘大概能處理 15 條內容，耐心等一會兒就行；

4. 4. 數據處理完畢后，在后臺【AI 檢索】或者工具首頁就能測試問答效果了，親測提問的精準度超預期！

我這里填寫硅基流動的向量模型

• ? API Key ：在硅基流動控制臺「API 密鑰」生成并填入

• ? 向量模型名稱（必填）

  ，官方支持以下標準名稱：

• • ? 通用中文首選： BAAI/bge-large-zh-v1.5 （官方默認）

  • ? 多語言長文本： BAAI/bge-m3

  • ? 通義千問系列： Qwen/Qwen3-Embedding-8B 、 Qwen/Qwen3-Embedding-4B 、 Qwen/Qwen3-Embedding-0.6B

  • ? 網易有道： netease-youdao/bce-embedding-base_v1

我這里選擇免費的Qwen/Qwen3.5-4B，你可以選擇其他的模型

6.確認掃描

掃描之后一直卡住

查看錯誤日志：

                                                           error.log 
log.go:40: 批量插入文章ID失敗：empty slice found

批量掃描會報錯：

                                                           log.go:40: 批量插入文章ID失敗：SQL logic error: too many SQL variables (1)

單獨“添加數據”可以正常，項目還有些BUG。

總結

作為一名常年折騰 WordPress 的老站長，星哥真心覺得 WP2AI 是提升博客價值的好工具，但是目前項目還有一些BUG，需要等待作者xiaoz把bug修復一下。

把積累的文章內容轉化成智能知識庫，不僅能讓老內容 “活” 起來，還能給讀者帶來全新的使用體驗，簡直是雙贏。