Unity Cache Server 开源项目使用指南

Unity Cache Server 是一个专为本地网络团队环境优化的缓存服务器，旨在加速Unity项目数据的初始导入和平台间的切换。本指南将帮助您了解项目的结构、启动方法以及配置详情。

1. 目录结构及介绍

Unity Cache Server 的目录结构设计以清晰和模块化为主，确保维护和扩展的便利性：

• src: 包含主要的服务实现代码。
  • server.js: 主服务入口文件，负责启动缓存服务器。
  • config: 配置文件夹，存放默认和其他可能的环境配置文件（如default.yml）。
  • lib: 库文件，包含了各种功能模块的实现。
  • test: 测试相关文件，用于保证代码质量。
• package.json: 项目的主要配置文件，记录依赖、脚本命令等。
• README.md: 项目说明文件，包括快速入门、概述和关键特性的介绍。
• LICENSE: 许可证文件，说明了软件的使用权限。

2. 项目的启动文件介绍

启动的关键文件是 src/server.js。然而，通常不直接编辑此文件来启动服务。Unity Cache Server 支持通过命令行工具简便地启动，利用npm作为管理工具。用户可以通过以下命令之一来启动服务：

• 使用最新稳定版：

  npm install unity-cache-server -g
  unity-cache-server
  

• 获取并使用开发版本：

  npm install github:Unity-Technologies/unity-cache-server -g
  unity-cache-server
  

通过添加不同的命令行参数，您可以自定义缓存路径、日志级别、监听端口等。

3. 项目的配置文件介绍

默认配置文件 (config/default.yml)

配置文件位于 config 目录下，默认配置文件为 default.yml。它存储着缓存模块的设置和其他重要功能选项，例如：

• Cache Modules 设置，比如使用 cache_fs （基于文件系统的缓存）作为默认模块。
• General Options，涵盖日志级别、工作线程数、缓存目录路径等。
• Client Configuration 指定允许的PUT交易客户端地址等。

配置选项示例

在 default.yml 中，可以定制cache_fs或cache_ram模块的行为，调整缓存清理策略、最大缓存大小等。例如，对于文件系统缓存，你可以设置过期时间(expireTimeSpan)和最大磁盘占用(maxCacheSize)。

自定义配置

除默认配置外，还可以创建针对不同环境的配置文件，并通过环境变量或命令行参数指定使用哪个配置。例如，通过设置 NODE_ENV 和使用 --save-config 参数来为特定环境生成配置。

export NODE_ENV=development
unity-cache-server --save-config config/local-development.yml

随后，通过环境变量NODE_CONFIG_DIR指定配置目录来应用这些配置。

---

此文档覆盖了 Unity Cache Server 的基本结构、如何启动以及配置方式，提供给您作为一个起点，以便于更深入地使用或贡献于这个项目。在实际部署或开发过程中，详细阅读项目提供的官方文档和API参考将会是不可或缺的步骤。