> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/zh/tenants/tenant-crash-cart-guide.md).

# 租户 Crash Cart 指南

## 概述

该 **租户故障急救车** 是一台实用型虚拟机，旨在在租户的外部网络配置错误或其他无法访问时，为租户的 VergeOS 环境提供应急访问。通过直接连接到租户的核心网络，即使正常访问路径不可用，故障急救车也能让父系统管理员登录租户 UI。

在恢复场景中尤其有用，因为由于网络问题、防火墙配置错误或外部 IP 设置不正确，租户操作员无法访问自己的 UI。

## 何时使用故障急救车

在以下情况下，故障急救车是合适的：

* 无法通过正常的外部 URL 访问租户 UI。
* 外部网络设置配置错误，需要修正。
* 防火墙规则被更改，导致阻止了 UI 访问。
* 租户的外部网络已关闭电源或未按预期运行。
* 你需要一条直接的内部路径进入租户环境进行故障排查。

## 主要特性

* 可作为 **配方** 在 Marketplace 中提供。
* 提供一条连接路径，从 **父系统** 进入租户。
* 不会 **未** 绕过租户身份验证——仍然需要有效的租户管理员凭据。
* 不包含任何特殊工具；其用途是在内部展示租户 UI。

***

## 前提条件

* 在父系统上创建/启动虚拟机以及指定租户的权限
* 访问 **服务（Marketplace）** 目录。
* 用于修复目标租户的租户管理员级凭据。
* 对租户网络和外部网络配置的基本了解。

***

## 部署租户故障急救车

### 1. 创建故障急救车虚拟机

1. 导航到 **租户** 并选择需要恢复的租户。
2. 在 **租户网络** 部分中，找到 **故障急救车** 字段并点击 **-- 创建 --**.
3. 提供一个 **名称** 为该虚拟机。
4. 选择一个 **集群** （或保留默认值）。
5. 点击 **提交** 以创建虚拟机实例。

虚拟机将被创建，并自动附加到租户的核心网络。

{% hint style="success" %}
**替代方案：从 Marketplace 创建**

你也可以从 **虚拟机** > **+ 新建虚拟机**。在 **目录**，选择 **服务（Marketplace）**，选择 **租户故障急救车**，然后点击 **下一步**。在此处，提供名称，选择集群，并选择要附加到的租户。
{% endhint %}

***

### 2. 启动并访问故障急救车控制台

1. 从 VM 仪表板中，单击 **开机**.
2. 使用 **远程控制台** 或左上角的控制台按钮打开控制台。
3. 使用虚拟机中显示的用户名和密码登录 OS shell **注意** 部分。

{% hint style="success" %}
**启动后，虚拟机可能会自动登录到 OS shell。故障急救车绝不会自动登录到 VergeOS UI。**
{% endhint %}

***

### 3. 登录到租户 VergeOS UI

虚拟机启动后，它会显示一个指向租户 VergeOS UI 的浏览器会话。

1. 输入你的 **租户管理员凭据**.
2. 继续对租户的外部网络配置进行必要的修复。

即使租户的外部网络无法访问，故障急救车也能提供内部访问。

***

## 常见故障排查场景

故障急救车是解决以下问题的合适工具：

* 租户 URL 或外部 IP 地址更新不正确
* 阻止 UI 访问的防火墙规则（例如，端口 80/443 被禁用）
* 外部网络已关闭电源且无法自动重启
* 其他阻止正常 UI 连接的租户外部网络问题

***

## 最佳实践

* **将故障急救车虚拟机保持关机状态以便重复使用** 以避免在紧急恢复期间延误。
* 如果要重复使用：
  * 关闭该虚拟机。
  * 编辑虚拟机的配方实例，将其设置为 **--无--** 以解除附加。
  * 下次需要时，编辑配方实例，选择所需的租户并将其启动。

***

## 清理和重复使用选项

完成修复后，你可以：

### 推荐：保留该虚拟机以供日后使用

* 关闭故障急救车虚拟机。
* 选择 **编辑配方实例** 位于左侧菜单中；在 **选择要附加到的租户**，选择 ***--无--***; **提交** 以保存更改。
* 让该虚拟机保持可用，以便快速重新部署。
* 之后可通过编辑配方实例将其重新分配给不同的租户。

### 替代方案：删除虚拟机

* 如果你希望环境干净一些，可以将该虚拟机完全删除。
* 该配方仍将在 *Marketplace* 中可用，以便在未来任何需要时创建新的实例。

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/zh/tenants/tenant-crash-cart-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.