> 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/introduction-to-shadefs.md). # ShadeFS 简介 ## **概述** ShadeFS 是一款云盘挂载解决方案，它彻底改变了您与云端存储媒体文件的交互方式。不同于传统云存储解决方案需要先完整下载文件才能访问（咳，Dropbox），ShadeFS 会实时流式传输您所需的片段，类似于 YouTube 提供视频内容的方式。这种方式让您能够立即访问媒体内容，同时优化带宽使用。 ## **主要功能** * ShadeFS 会将您的云盘变成一个本地文件夹，默认可通过“/Volumes”文件夹访问 * 当您挂载一个驱动器时，它会像物理硬盘一样出现在本地文件系统中，同时还具备智能流式传输和缓存的额外优势 * 系统会自动在所有用户之间同步文件树，确保团队中的每个人都能使用相同的内容结构，而不受所在地影响。 * 上传的文件会自动通过我们的代理生成和 AI 分析流水线 ## **系统要求** ShadeFS 需要满足一些要求，才能在您的机器上最佳运行。 * 处理 4K 视频内容时，我们建议最低下载网速为 500Mbps * 带宽较低的用户应考虑使用代理文件或低于 4K 分辨率的内容 * 您的设备还应有足够的存储空间用于缓存，基本操作至少需要 10GB ## **开始使用** 当您下载并打开桌面应用后，可以通过在左侧面板中导航到任意驱动器，点击“...”菜单，然后选择“挂载驱动器”来挂载它。无论您使用的是 Windows、macOS 还是 Linux，该驱动器都会出现在本地文件管理器中。 {% embed url="" %} ## **挂载位置** 默认情况下，每个驱动器都会挂载到操作系统的标准位置。工作区所有者和管理员可以在驱动器设置中的 **常规 > 自定义挂载路径**，使用 **macOS 路径**, **Linux 路径**，以及 **Windows 路径** 字段。 在 Windows 上，您可以将驱动器挂载到某个盘符，例如 `X:` 或 `Z:` （系统盘 C:、D: 和 E: 不允许）。将某个字段留空即可使用系统默认值。 ## **挂载后端（macOS）** 在 macOS 上，ShadeFS 通过内置于 Shade 桌面应用中的文件服务器来挂载驱动器，因此您无需安装任何额外组件。该服务器仅在您的 Mac 上运行，挂载的驱动器会显示在 `/Volumes` 下，与其他驱动器一样。如果您更喜欢 macFUSE，请安装它并在 **使用 macFUSE 后端** 在 **设置 > ShadeFS > 配置**中启用。使用 macFUSE 后端时一次只能挂载一个驱动器，切换此设置时 ShadeFS 会重启。 ## **缓存配置** ShadeFS 使用缓存系统来优化媒体文件的性能。默认情况下，系统会在位于您用户根目录中的 **.shade** 文件夹中创建 26GB 的缓存。不过，您可以在 **设置 > ShadeFS > 缓存管理** 中自定义缓存位置和大小，以更好地满足您的需求。 [管理 ShadeFS 缓存](https://academy.shade.inc/shadefs/managing-the-shadefs-cache) ## **缓存目录** 要修改缓存目录，请在 **设置 > ShadeFS > 缓存管理** 桌面应用中打开并点击 **ShadeFS 缓存目录** 字段（在桌面应用 2.3.21 及更早版本中，此设置位于 **设置 > ShadeFS > 配置**）。在这里，您可以选择电脑上的任意文件夹或外置硬盘作为缓存位置。我们特别推荐使用高速外置 SSD，例如三星 T7，以获得最佳性能。 缓存位置必须位于格式化为 APFS（macOS）、NTFS 或 ReFS（Windows），或 ext4、XFS、Btrfs（Linux）的驱动器上。格式化为 exFAT 或 Mac OS Extended（HFS+）的驱动器不能用于缓存。 ## **ShadeFS 使用指南** ## **权限** ShadeFS 的访问和挂载功能仅限于工作区承包商、成员和管理员使用。当多个用户挂载同一个驱动器时，他们看到的都是相同的文件树，这有助于远程团队无缝协作。 ## **上传** 对于超过 1000 个资源或 100GB 的大规模上传，我们建议使用 Web 应用或桌面应用，而不是通过挂载的驱动器上传。我们已经针对大文件优化了通过应用界面的上传。无论您选择哪种上传方式，内容都会自动在 Web 应用和桌面应用中可见，并触发我们的自动代理生成和 AI 处理系统。 文件可以通过先挂载多个驱动器，然后在电脑文件管理器中在这些驱动器之间移动文件来实现跨驱动器移动 ## **离线访问** ShadeFS 通过 **固定**提供离线访问功能。要在网络较弱（或完全没有网络）的情况下访问特定文件或文件夹，只需在应用中右键单击这些文件/文件夹并选择“固定到缓存”。此操作会将所选内容的完整副本下载到本地缓存，使其即使离线也能完全访问。您可以通过 **已固定项目** 页面查看已固定的文件。 更多内容请见 [离线固定文件](https://academy.shade.inc/shadefs/pinning-files-offline). ## **性能优化** 有几种方法可以最大化 ShadeFS 的性能。 * 使用外置 SSD 作为缓存存储，可显著提高访问速度和整体系统响应能力 * 我们建议根据您的典型工作集来配置缓存大小，以确保经常访问的文件始终可用 * 虽然 ShadeFS 旨在高效利用可用带宽，但在使用挂载盘时尽量保持稳定的互联网连接 * 对于在带宽有限的情况下处理高分辨率内容的用户，我们建议制作代理文件 ## **与 Shade 生态系统的集成** 与其他文件流式传输工具不同，ShadeFS 与 Web 应用和桌面应用深度集成。当您通过挂载的驱动器上传文件时，它们会自动在 Shade 系统中建立索引，并立即在 Web 和桌面应用中可见。 --- # 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://academy.shade.inc/shade-academy/shade-academy-zh/shadefs/introduction-to-shadefs.md?ask=&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.