> ## 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-Hans/superun/integrations/cloud">
    了解数据库、认证与后端服务的管理方式。
  </Card>

  <Card title="发布" icon="rocket" href="/zh-Hans/superun/features/publish">
    将验证完成的版本发布到线上环境。
  </Card>
</CardGroup>
