> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/managing-the-shadefs-cache.md).

# 管理 ShadeFS 缓存

## **概览**

ShadeFS 使用本地缓存系统，让你能够流畅、高效地访问存储在云端的媒体文件。了解如何配置和管理此缓存，以优化你的工作流程性能并管理本地存储。

## **缓存基础**

默认情况下，ShadeFS 会在 `.shade` 文件夹中分配 26GB 的缓存空间，该文件夹位于你电脑用户根目录下。此缓存作为流式传输媒体片段的临时存储位置，因此你的文件管理器和 NLE 可以立即访问你的媒体。

## **位置管理**

你可以将 ShadeFS 存储缓存的位置更改为你机器上的某个文件夹，或外部设备：

1. 打开 Shade 应用中的“设置/偏好”菜单
2. 进入缓存设置部分
3. 选择你偏好的缓存目录

为了获得最佳性能，我们建议将高速外部 SSD（例如 Samsung T7）用作缓存位置。此配置性能更高，也能让你的系统盘空出来用于其他操作。

你的外置硬盘不能格式化为 exFAT，因为我们使用稀疏文件来存储缓存文件。请将你的硬盘格式化为 APFS 或 NTFS

<figure><img src="/files/b754d9dfd47a908ccdea9722ec220f3677fba1ae" alt=""><figcaption></figcaption></figure>

## **缓存大小**

缓存大小可以通过“挂载驱动器”面板更改，或通过 **设置 > 偏好设置**。默认的 26GB 缓存足以满足基本操作，但你可以将其增加到你电脑上可用的空闲空间上限，或增加到你设置的缓存目录所能容纳的大小。调整这些设置时，请考虑你通常的工作流程项目大小和可用存储空间。缓存大小在所有驱动器之间共享。如果你同时挂载了多个驱动器，它们都将共享同一缓存空间。

<figure><img src="/files/0ba8ef5feec1678926f9013ffc979dafb84457f0" alt=""><figcaption></figcaption></figure>

## **离线访问**

在需要在没有网络连接的情况下仍能保证访问特定文件的场景中，你可以将文件固定为离线可用。当你固定某个文件或文件夹时，它会下载一个完整副本 **到** 你的缓存之外，使其可离线使用。这意味着固定不会考虑你机器拥有多少存储空间。如果你尝试固定的内容超过了可用存储，你的机器将耗尽空间并出现问题。要固定内容：

1. 在 Shade 应用中导航到所需文件或文件夹
2. 右键单击该项目
3. 选择“固定到缓存”

更多信息请见： [离线固定文件](/shade-academy/shade-academy-zh/shadefs/pinning-files-offline.md)

## **性能注意事项**

你的缓存配置会直接影响系统性能。为了获得最佳体验：

* 为你的缓存位置使用高速存储设备，建议硬件请查看 [为 Shade 缓存选择外置 SSD](https://academy.shade.inc/shadefs/choosing-an-external-ssd-for-shade-cache)
* 为你日常的工作集分配足够的缓存大小
* 监控缓存驱动器上的可用空间
* 考虑将经常使用的文件固定，以获得稳定的访问体验

请记住，虽然更大的缓存大小可以提升频繁访问文件时的性能，但它们也会在你的本地系统上占用更多存储空间。


---

# 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://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/managing-the-shadefs-cache.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.
