tdtgit/sitemap-warmer

DATUAN Sitemap Warmer

镜像概述和主要用途

DATUAN Sitemap Warmer 是一个CLI工具，通过扫描网站的sitemap.xml文件预热缓存。它支持多种编码格式（如brotli、gzip）及图片格式（如AVIF、WebP），可自动识别最近更新的URL并进行缓存预热，有效提升网站访问速度。适用于各类拥有sitemap.xml端点的网站，尤其适合使用SEO插件（如RankMath SEO、Yoast SEO、Jetpack）生成站点地图的WordPress等网站。

核心功能和特性

• 多编码支持：预热brotli、gzip等压缩格式的资源
• 图片优化：支持AVIF、WebP等现代图片格式的缓存预热
• 智能筛选：默认仅预热最近5分钟（300秒）内更新的URL（通过sitemap.xml的<lastmod>标签判断）
• 灵活配置：可通过参数调整预热范围、请求间隔、资源类型等
• 多环境兼容：支持Docker快速部署，也可通过NodeJS在各类操作系统（Ubuntu/CentOS/*nix、Windows、MacOS）运行

使用场景和适用范围

• 网站性能优化：定期预热缓存，减少用户访问时的服务器响应时间
• 内容更新后缓存刷新：在发布新内容或更新页面后，自动预热相关URL
• 低配置服务器保护：通过设置请求间隔（--delay）避免服务器负载过高
• 多域名管理：支持同时预热多个网站的缓存

使用方法和配置说明

Docker快速启动

无需安装NodeJS环境，直接通过Docker运行：

bash
docker run tdtgit/sitemap-warmer yourdomain.com

注：默认使用https://协议，若网站使用http://，需显式指定，如docker run tdtgit/sitemap-warmer http://nonhttps.com

非Docker环境要求

• NodeJS 10/12/14
• 拥有sitemap.xml端点的网站（如[***]

安装与基本使用

1. 安装NodeJS后，全局安装工具：

   bash
   npm install -g datuan-sitemap-warmer
   

2. 基本命令（替换datuan.dev为目标域名）：

   bash
   warmup datuan.dev
   # 或指定http协议
   warmup http://nonhttps.com
   

定时运行配置

推荐通过cron任务定期执行，保持缓存持续有效：

• 每分钟预热最近更新的URL：

  bash
  * * * * * warmup datuan.dev
  

• 每12小时预热所有URL（确保全覆盖）：

  bash
  0 */12 * * * warmup datuan.dev -a
  

• 多域名配置示例：

  bash
  * * * * * warmup http://domain1.com
  */2 * * * * warmup domain2.net
  */5 * * * * warmup domain3.xyz
  

配置参数说明

命令格式：warmup <域名/URL> [参数]

高级选项

自定义请求头

可通过--headers参数添加自定义请求头，格式为--headers.<头名称> "值"：

bash
warmup datuan.dev --headers.auth "Bearer super_secret" --headers.user-agent "My own crawler"