> 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/troubleshooting.md).

# 故障排除

VergeOS 常见问题的诊断流程和修复方法。

* [配置远程日志转发（Syslog）](https://docs.verge.io/knowledge-base/zh/troubleshooting/configuring-remote-log-forwarding.md) — 如何配置 VergeOS 将系统日志转发到远程 syslog 服务器，以便进行集中日志管理、归档和合规。
* [生成系统诊断](https://docs.verge.io/knowledge-base/zh/troubleshooting/generating-system-diagnostics.md) — 如何在 VergeOS 中生成并提交系统诊断报告；该报告会将所有节点的详细日志打包为一个压缩文件，用于……
* [由于 AER 导致 NVMe 控制器重置](https://docs.verge.io/knowledge-base/zh/troubleshooting/nvme-aer-reset-loop.md) — 诊断由 PCIe AER 事件引起的重复 NVMe 控制器重置，包括单盘和共享路径模式。
* [系统日志](https://docs.verge.io/knowledge-base/zh/troubleshooting/system-logs.md) — 关于查看 VergeOS 中的系统日志、同步日志和系统事件日志（SEL）的指南，包括日志保留、第三方日志转发……
* [VergeOS 更新说明](https://docs.verge.io/knowledge-base/zh/troubleshooting/vergeos-update-instructions.md) — 按步骤说明如何在零停机的情况下更新 VergeOS 环境，包括排查常见的更新问题。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/knowledge-base/zh/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
