> ## 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.

# 獨立測試環境

> 透過 superun 雲端運算為已上線專案建立與線上隔離的臨時後端環境，用於安全完成上線前驗證。

**獨立測試環境** 會為已上線專案建立一套單獨的後端環境，供你繼續研發和做上線前驗證。線上站點繼續連接線上環境；專案研發區則使用測試環境的資料庫、認證設定和服務位址。

<Note>
  此功能目前面向 **中國站使用 superun 雲端運算的已上線專案**。產品目前標示為 **限時免費**，具體開放範圍與計費請以產品內最新提示為準。
</Note>

## 測試環境與線上環境

|       | 測試環境                                  | 線上環境                   |
| ----- | ------------------------------------- | ---------------------- |
| 主要用途  | 研發、除錯和上線前驗證                           | 為真實使用者提供服務             |
| 初始資料  | 從近期線上備份建立，可能包含線上資料                    | 目前即時線上資料               |
| 位址與認證 | 使用獨立的測試位址和認證設定                        | 使用穩定的線上位址和認證設定         |
| 變更影響  | 在測試環境中直接修改的資料和設定不會自動同步到線上，回收或重建後還可能遺失 | 持久保留，只會被明確的線上發布或線上操作改變 |
| 生命週期  | 閒置環境每日回收，需要時重新恢復                      | 持續為線上站點提供服務            |

<Warning>
  環境隔離可以避免測試操作直接修改線上，但測試環境仍可能含有近期備份的線上資料。請按線上資料的安全標準使用，不要把金鑰、個人資料等敏感內容暴露在截圖、對話或第三方服務中。
</Warning>

## 開啟前準備

* 專案必須 **目前處於上線狀態**；從未發布或已經下線的專案不能開啟。
* **專案擁有者** 可以開啟、重試或重建；開啟後，**擁有者和編輯者** 都可以查看和使用。
* 專案必須使用 superun 雲端運算。只連接自有 Supabase 的專案不會顯示此入口。

## 開啟測試環境

<Steps>
  <Step title="進入 superun 雲端運算">
    在專案中開啟 **研發 → 技能庫 → superun 雲端運算**，進入 **測試環境** 分頁。
  </Step>

  <Step title="確認隔離規則">
    點擊 **開啟測試環境**。確認你已了解測試與線上的位址、資料和認證互相隔離，以及閒置環境和測試變更可能被回收。
  </Step>

  <Step title="等待環境就緒">
    superun 會從近期線上備份建立測試資料庫，恢復必要設定和 Edge Function，並發布測試建置。請保持目前頁面開啟以查看進度；頁面顯示 **測試環境已就緒** 後再開始驗證。
  </Step>

  <Step title="在測試環境中研發和驗證">
    使用此分頁中的資料庫、認證、日誌等雲端工具。設定回呼位址、Webhook、白名單或第三方金鑰時，先確認使用的是 **測試環境位址**，不要誤用線上位址。
  </Step>
</Steps>

需要更新線上站點時，仍然透過 **營運 → 發布** 完成。請把「發布」當作進入線上環境的明確邊界，不要假設在測試環境中直接修改的資料表資料、使用者或設定會自動複製到線上。

## 每日回收與自動恢復

系統會在每天 **凌晨 2 點** 檢查並回收閒置的測試環境。若專案當時仍處於活躍使用狀態，系統會保留測試環境。環境被回收後，再次進入專案會自動從近期線上備份開始恢復。

恢復需要一些時間，期間測試環境中的雲端工具和測試建置暫不可用。上一個測試環境中的臨時資料或設定不保證保留。

## 從線上重建

如果需要一套基於最新可用線上備份的乾淨環境，或目前測試環境已經被測試變更污染，可以點擊 **重建測試環境**。

<Warning>
  重建會永久刪除目前測試環境中的資料表資料、認證設定和其他測試變更，但不會刪除或修改線上環境。
</Warning>

只有專案擁有者可以發起重建。狀態重新變為「已就緒」前，請不要繼續研發或驗證。

## 安全使用清單

* 查詢或修改資料前，先核對環境標示和位址。
* 除錯時使用測試回呼位址和測試憑證；正式上線時再使用線上設定。
* 假設測試資料庫中可能含有來自近期備份的敏感線上資料。
* 不要把重要資料或設定的唯一副本只保存在測試環境中。
* 每次恢復或重建後，重新驗證認證、Edge Function、Webhook 和第三方回呼。

## 常見問題

<AccordionGroup>
  <Accordion title="為什麼無法開啟測試環境？">
    請確認專案目前處於上線狀態、已經啟用 superun 雲端運算、正在中國站使用，並且你的角色是專案擁有者。編輯者可以查看和使用，但不能開啟、重試或重建。
  </Accordion>

  <Accordion title="為什麼頁面一直顯示正在準備？">
    資料庫建立、設定恢復、Edge Function 部署和測試建置都是非同步完成的。請保持頁面開啟並等待「已就緒」。如果頁面明確顯示失敗，專案擁有者可以重試；若長時間停留在同一階段，請攜帶專案 ID 和頁面顯示的階段聯絡支援人員。
  </Accordion>

  <Accordion title="為什麼昨天的測試資料不見了？">
    閒置測試環境會每日回收，之後再從近期線上備份恢復。在測試環境中直接產生的變更屬於臨時內容，不保證能跨回收或重建保留。
  </Accordion>

  <Accordion title="重建會影響線上站點嗎？">
    不會。重建只刪除並重新建立測試環境，線上環境會繼續運作；但目前測試環境中的資料和設定會被永久捨棄。
  </Accordion>

  <Accordion title="第三方服務應該設定哪個位址？">
    測試驗證時使用測試環境位址，正式對外服務時使用線上位址。兩套位址不同，切換環境時請明確更新回呼位址、Webhook、白名單和憑證。
  </Accordion>
</AccordionGroup>

***

<CardGroup cols={2}>
  <Card title="superun 雲端運算" icon="cloud" href="/zh-Hant/superun/integrations/cloud">
    了解資料庫、認證與後端服務的管理方式。
  </Card>

  <Card title="發布" icon="rocket" href="/zh-Hant/superun/features/publish">
    將驗證完成的版本發布到線上環境。
  </Card>
</CardGroup>
