> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 獨立測試環境

> 已上線專案可開啟與線上隔離的測試後端，用於驗證資料、登入和第三方對接（限時免費，以產品內為準）。

## 這是什麼

用一句話說：給你**已經上線**的專案，再開一套「練習用 / 試錯用」的後端。

這套環境和真正給用戶用的線上環境互相隔離，改壞了一般也不會動到線上。

可以把它理解成：

* **線上環境** = 正式開門營業的店
* **測試環境** = 倉庫後廚 / 試菜間

你在試菜間怎麼折騰，預設都不會自動變成店裡給客人上的菜。

<img src="https://b.ux-cdn.com/uxarts/files/t20260831110420/hqd1osvf.png" alt="superun 雲計算中的獨立測試環境入口" width={900} />

***

## 解決什麼問題

上線後你可能還想：

* 試一下新的登入方式會不會壞
* 改資料庫、加欄位，先別直接動正式資料
* 對接微信 / 支付 / 第三方回調，先用一套「測試地址」驗證

如果直接在線上試，一不小心就會影響真實用戶。獨立測試環境就是為這種「上線後再驗證」準備的。

***

## 在哪裡找

1. 打開你的專案。
2. 進入 **研發 → 技能庫 → superun 雲計算**。
3. 打開 **「測試環境」** 標籤（上方可能有 **FREE / 限時免費** 標識）。

<Note>
  該 Tab 目前主要在國內站展示（以產品內入口為準）。專案須**已發佈上線**，並使用 **superun 雲計算**；只連接自有 Supabase 的專案不會顯示該入口。
</Note>

***

## 誰能用

| 角色        | 能做什麼         |
| --------- | ------------ |
| 專案所有者     | 開啟、重試、重建測試環境 |
| 所有者 + 編輯者 | 可查看測試環境配置    |
| 其他人       | 看不到該入口內容     |

開啟前會彈出確認框，請先讀完規則。確認按鈕可能有短倒計時，防止誤點。

***

## 測試環境與線上差在哪

### 1. 互相隔離

測試環境有自己的：

* 訪問地址（URL）
* 資料庫裡的資料
* 登入 / 認證配置

在測試環境裡改的東西，**不會自動同步到線上**；環境被回收後，測試側改動也不會保留。

### 2. 資料從哪來

測試資料通常來自**近期線上備份**（首次進入或每日回收後再進，常按今日 / 昨日線上備份準備）。

因此：

* 可能仍含有接近真實的資料，請按敏感資料標準謹慎使用
* 不要把測試配置 / 密鑰發給第三方當正式配置

### 3. 閒置會被回收

閒置的測試環境會在**每天凌晨 2 點**被回收，避免長期佔資源。若當時專案仍在活躍使用，系統可能保留測試環境。回收後再進會從近期線上備份自動恢復，期間雲工具與測試構建暫不可用；測試環境裡做的改動也可能丟失。

### 4. 第一次要等一會兒

首次開啟，或每天回收後再進，都要等系統準備好。頁面上會顯示進度（例如：分配資源 → 從備份建庫 → 發佈測試服務）。請保持頁面打開，耐心等待。

***

## 開啟後你會看到什麼

準備好之後：

* 頂部會提醒：你現在配的是**測試環境**，URL / 資料 / 認證都不是線上那套
* 下面可以像配置雲計算一樣，查看 / 管理這套測試後端
* 所有者還能點 **「重建測試環境」**

***

## 「重建」是什麼意思

**重建** = 刪掉當前測試環境，再按最新線上備份重開一套。

請注意：

* 測試環境裡的表資料、認證配置、其它改動會**永久丟失**
* **線上不會受影響**
* 重建期間測試環境暫時不可用，需要再等一段時間

適合：測試環境弄亂了、想重新從正式資料拷一份乾淨的。

***

## 費用

產品上標了 **「限時免費」**（入口常見 **FREE** 標識）。以後是否長期免費，以頁面最新說明為準。

***

## 建議你怎麼用

**適合：**

* 上線後再驗登入、資料庫、介面
* 給第三方填「測試回調地址」前，先在測試環境跑通
* 想大膽試錯，又不想動正式用戶資料

**務必注意：**

* 看清當前是測試還是線上（URL 不一樣）
* 不要把測試環境的地址 / 密鑰當成正式配置交給合作方
* 重要驗證盡量當天做完——凌晨可能被回收
* 只有所有者能開；需要開的話找專案主人
* 每次恢復或重建後，重新驗證認證、Edge Function、Webhook 和第三方回調
* 不要把重要資料或配置的唯一副本只保存在測試環境中

**不適合指望：**

* 把測試環境當長期正式環境用
* 以為測試裡改的資料會自動同步到線上
* 沒上線的專案直接開測試環境

***

## 最簡流程（三步）

1. 先把專案**發佈上線**。
2. 專案所有者打開 **雲計算 → 測試環境**，點 **「開啟測試環境」**，確認規則。
3. 等狀態變成就緒後，用測試環境的配置去做驗證；搞亂了就 **重建**。

需要把驗證結果推到線上時，仍透過 **運營 → 發佈**；測試環境裡直接改的表資料、用戶或配置不會自動上線。

***

## 一句話記住

測試環境 = 已上線專案的獨立後廚：能試錯、和正式店隔離，但會定時收攤，且資料可能來自正式店的備份。

***

## 常見問題

<AccordionGroup>
  <Accordion title="為什麼無法開啟測試環境？">
    請確認專案已上線、已啟用 superun 雲計算、正在國內站使用，並且你是專案所有者。只連接自有 Supabase 的專案不會顯示入口。編輯者可以查看，但不能開啟、重試或重建。
  </Accordion>

  <Accordion title="沒上線的專案能開測試環境嗎？">
    不能。專案必須已發佈上線後才能開啟。
  </Accordion>

  <Accordion title="測試環境裡改的資料會同步到線上嗎？">
    不會。測試與線上互相隔離；回收或重建後，測試側改動也不會保留到線上。
  </Accordion>

  <Accordion title="為什麼頁面一直顯示正在準備？">
    建庫、恢復配置、Edge Function 與測試構建是非同步完成的。請保持頁面打開並等到「已就緒」。若明確失敗，所有者可重試；長時間卡在同一階段時，請攜帶專案 ID 與當前階段聯繫支援。
  </Accordion>

  <Accordion title="凌晨回收後怎麼辦？">
    再次進入會從近期線上備份自動恢復，或由所有者重新開啟；此前測試環境內的改動可能丟失。
  </Accordion>

  <Accordion title="重建會影響線上站點嗎？">
    不會。重建只刪除並重建測試環境；線上繼續運行，但當前測試環境中的資料和配置會被永久丟棄。
  </Accordion>

  <Accordion title="第三方服務應該配置哪個地址？">
    測試驗證用測試環境地址，正式對外用線上地址。兩套不同，切換時請同步更新回調、Webhook、白名單和憑證。
  </Accordion>

  <Accordion title="協作編輯者可以開啟嗎？">
    不可以。只有專案所有者可以開啟、重試或重建；編輯者可以查看配置。
  </Accordion>
</AccordionGroup>

## 相關文件

* [superun 雲計算](/zh-Hant/superun/integrations/cloud)
* [發佈](/zh-Hant/superun/features/publish)