versions：强大的静态资源服务器和CDN构建工具

versions：强大的静态资源服务器和CDN构建工具

版本管理器versions 是一个简洁而高效的Node.js模块，它解决了在Node环境中处理静态资产的繁琐问题。通常建议使用NGINX或Varnish等专用静态服务器来提高性能，但versions的目标是通过内存缓存策略，实现与这些专业软件相当的文件服务效率，让静态资源的处理更加便捷。

开发状态

versions的GitHub主分支处于持续开发中，确保每次发布新稳定版前所有测试均通过：

---

特性亮点

versions以其丰富的功能，使搭建简单的静态服务器变得更加容易，甚至可以媲美付费CDN服务：

原始服务器拉取（Origin Pull）

无需将静态内容上传到单独服务器，versions可以从原服务器直接拉取并缓存。

文件缓存设置

自动为每个文件设置适当的缓存头，使浏览器能够从本地缓存而不是服务器获取资源，减少HTTP请求。

高级gzip压缩

对所有兼容格式启用gzip，即使原始服务器不支持。已针对旧版IE禁用或调整以防止不正确的缓存。

REST API 管理

通过REST API可以检查缓存内容，查看缓存键，甚至清空服务器。

统计指标

收集服务器请求和状态的详细统计信息，便于监控和优化。

客户端API

提供专门的客户端库，用于与服务器的REST API交互或通过发布/订阅模式进行通信。

同步机制

保证多个消费者之间配置和版本的一致性，确保相同的缓存被访问。

满满的爱意

versions由热爱技术的人精心打造，为您带来最佳的体验。

---

安装

使用npm安装versions及其依赖：

npm install versions --save

--save 参数会在你的package.json文件中添加versions作为依赖项。

API文档参考

详细的API文档包括服务器API和客户端API：

• 服务器API参考
• 客户端API参考

配置

配置可以通过JSON文件（versions.json）或链式API，也可以两者的结合来进行：

• 认证（auth） 设置安全令牌以保护你的REST API接口。

• 黑名单扩展名（blacklisted extensions） 可以阻止某些扩展名文件从源服务器获取，如.conf或.log等。

• CORS配置（cors） 自定义Access-Control-Allow-Origin头，默认允许所有域。限制为特定域名可提升安全性。

• 目录（directory） 相对于加载versions模块的程序根目录的服务静态内容的目录。

• 强制扩展名（force extensions） 默认要求从源服务器获取的文件需带扩展名，防止常规页面被意外代理。

• 忽略查询字符串（ignore querystring） 是否在生成缓存键时忽略查询字符串，避免因非服务器使用的参数导致缓存失效。

• 内部缓存过期时间（expire internal cache） 内存缓存的生命周期，接受毫秒数或人类可读的时间格式（如“2天”）。

• 最大年龄（max age） 浏览器应缓存文件多久，同样接受毫秒数或时间格式。默认30天，不应超过一年。

• 端口（port） 运行服务器的端口号，默认8080。

• 源服务器（origin servers） 用于获取目录中找不到的资源的服务器对象数组。

• 版本号（version） 缓存版本号，可在客户端间同步，方便按需更新缓存。

• 别名（aliases） 为了并行下载资源，可以在多个子域名或域名下分布文件。

• 日志级别（log level） 控制日志输出的详细程度，默认为"log"，请参阅 dev/null 日志记录器了解更多。

• 插件（plugins） 添加额外的中间件层或自定义Connect兼容模块。

• 同步（sync） 启用客户端与服务器间的配置同步，并在必要时设置Redis配置。

• Redis配置（redis） 使用Redis后端实现实时分布式缓存，需要预安装redis。

---

versions是一个旨在简化静态资源处理的强大工具，无论是用于本地开发还是部署在大型网络环境，都能提供高效且灵活的解决方案。它的特性丰富，不仅实现了缓存优化，还提供了REST API和高级统计，使得管理和监控变得简单易行。现在就加入我们，享受它带给你的便利吧！