TX028

主機遭到封鎖

主控台

Text.js error TX028: Blocked request. This host (…) is not allowed. Add it to `…` in text.config.ts.

發生原因

text dev,以及綁定至回送位址時的 text start(預設行為),只會回應傳送至 localhost、*.localhost 名稱或 IP 位址的請求。這可防止 DNS 重新綁定攻擊。收到的請求帶有其他 Host 標頭,通常來自通道、反向代理或區域網路主機名稱。

修正方式

在 text.config.ts 中允許該主機。text dev 讀取 Vite 的 vite.server.allowedHosts,而 text start 讀取 server.allowedHosts。開頭的 . 表示允許子網域:

text.config.tsts
import { defineConfig } from "@textjs/app";export default defineConfig({  // text dev  vite: { server: { allowedHosts: ["my-laptop.local", ".ngrok.app"] } },  // text start  server: { allowedHosts: [".example.com"] },});

text start --host 使用回送位址以外的任何位址時,會略過檢查。請參閱在代理後方執行。