English | 中文

RenewHelper - 时序·守望 是一款基于 Cloudflare Workers 的全栈服务生命周期提醒、管理工具。它专为管理周期性订阅、域名续费、服务器到期等场景设计。无需服务器，零成本托管，提供精美的机甲风（Mecha-style）UI 界面、强大的农历/公历计算核心、多渠道通知推送能力以及 iCal 日程同步。v1.3.5+ 已同时支持Worker方式和Docker方式部署。

• ⚡️ Serverless 架构：完全运行在 Cloudflare Workers 上，利用 KV 存储数据，无需购买 VPS，免费额度通常足够个人使用。v1.3.5+ 已同时支持单机Docker方式部署。
• 📅 智能周期管理：
  • 支持公历与农历（Lunar）周期计算。内置高精度农历算法（1900-2100），支持公历循环（如月付/年付）和农历循环（如生日、传统节日）。
  • 支持按天、月、年为周期的自动推算。
  • 提供“循环订阅”与“到期重置”两种模式。
• 🔔 多渠道通知：
  • 内置支持 Telegram, Bark, PushPlus, NotifyX, Resend (Email), Webhook。
  • 支持自定义提前提醒天数和每日推送时间。
• 🤖 自动化管理：
  • 自动续期：到期自动更新下次提醒时间。
  • 自动禁用：过期太久未处理的服务自动标记为禁用。
  • Cron 触发：支持通过 Cloudflare Cron Triggers 每日定时检查。
• 📆 ICS 日历订阅：提供标准的 .ics 订阅链接，可完美接入 iOS 日历、Google Calendar 或 Outlook，支持基于时区的精确提醒并同步到您的手机日程中。
• 🛡️ 安全可靠：
  • JWT 身份验证，支持高强度密钥自动生成。
  • 混合限流策略（内存 + KV），防止暴力破解。
  • 数据仅存储在您私有的 Cloudflare KV 中。
  • 敏感操作（删除、重置）二次确认。
• 🎨 现代化 UI：
  • Vue 3 + Element Plus 构建的单文件前端。
  • 支持深色/浅色模式切换。
  • 响应式设计，完美适配移动端和桌面端。
  • 中英双语界面。
  • 支持数据导入/导出备份。

1. 点击上方按钮。
2. 授权 Cloudflare 访问您的 GitHub 账户（用于 Fork 仓库）。
3. 按照指引完成部署，Cloudflare 会自动为您创建 Worker 和 KV 命名空间。
4. 重要：部署完成后，请进入 Cloudflare Dashboard -> Workers & Pages -> 您的项目 -> Settings/设置 -> Variables/变量。
   • 添加环境变量：AUTH_PASSWORD，值为您想设置的登录密码（默认为 admin）。
   • 绑定 KV 命名空间：确保变量名为 RENEW_KV（不能改！！！）。

如果您没有 Github，可以直接在 Cloudflare 网页后台完成部署。

1. 登录 Cloudflare Dashboard。
2. 在左侧菜单点击 Workers & Pages -> KV。
3. 点击 Create a namespace。
4. 输入名称：RENEW_KV或其他任意名称 (建议大写，方便识别)，点击 Add。

1. 回到 Workers & Pages -> Overview 页面。
2. 点击 Create application -> Create Worker。
3. 给 Worker 起个名字，例如 renewhelper，点击 Deploy。
4. 部署成功后，点击 Edit code 进入代码编辑器。

1. 在代码编辑器左侧的文件列表中，选中 worker.js。
2. 全选并删除里面的所有默认代码。
3. 将本项目提供的 _worker.js 完整代码复制并粘贴进去。
4. 点击右上角的 Deploy 按钮保存代码。

1. 点击左上角的箭头返回到 Worker 的详情页面 (或者点击顶部的 Worker 名称)。
2. 点击 Settings (设置) -> Variables (变量)。
3. 向下滚动找到 KV Namespace Bindings (KV 命名空间绑定)。
4. 点击 Add binding：
   • Variable name (变量名): 必须填写 RENEW_KV (不能改！！！)。
   • KV Namespace (命名空间): 下拉选择你在第一步创建的那个存储桶。
5. 点击 Save and deploy。

1. 还在 Variables 页面，向上滚动找到 Environment Variables (环境变量)。
2. 点击 Add variable：
   • Variable name: AUTH_PASSWORD
   • Value: 输入你想设置的后台登录密码 (如果不设置，默认为 admin)。
3. 点击 Save and deploy。

为了让自动续期功能生效，须要设置定时触发器。

1. 点击页面顶部的 Triggers (触发器) 标签。
2. 向下滚动找到 Cron Triggers。
3. 点击 Add Cron Trigger。
4. Cron schedule: 准确输入 0,30 * * * * (代表 UTC 时间每天每个半点检查一次，不能改！！！)。
5. 点击 Add Trigger。

此方法适合希望自动同步更新且关注隐私安全的用户。您无需授权第三方应用，所有密钥均存储在您自己的 GitHub 仓库中。

1. Fork 项目：点击本项目右上角的 Fork 按钮，将仓库复制到您的 GitHub 账户。

2. 准备 Cloudflare 密钥：

   • Account ID：登录 Cloudflare Workers 首页右侧获取。
   • API Token：My Profile -> API Tokens -> Create Token -> 选择 Edit Cloudflare Workers 模板 -> 生成并复制。

3. 创建 KV 数据库：

   • 在 Cloudflare 后台创建一个 KV 命名空间（如 RENEW_KV）。
   • 复制该 KV 的 ID。

4. 配置 GitHub Secrets：

   • 进入您 Fork 的仓库 -> Settings -> Secrets and variables -> Actions。
   • 点击 New repository secret，依次添加4个变量：
     • CF_API_TOKEN: 填入您的 API Token。
     • CF_ACCOUNT_ID: 填入您的 Account ID。
     • CF_KV_ID: 填入您刚刚复制的 KV ID (Actions 会自动注入)。
     • AUTH_PASSWORD: 填入您的登录密码(设置后，即使同步代码也不会被覆盖)。

5. 启用并部署：

   • 进入 Actions 标签页，点击绿色按钮 I understand my workflows... 启用。
   • 在左侧选择 Deploy to Cloudflare Workers，点击右侧 Run workflow 手动触发首次部署。
   • 后续更新：每当原作者发布新版本，您只需在 GitHub 点击 Sync Fork，Actions 会自动将最新代码（含新功能）部署到您的 Worker，同时保留您的密码设置。

RenewHelper 支持通过 Docker 进行一键私有化部署。该方案利用 Miniflare 在本地模拟 Cloudflare Workers 环境，配合 Node-cron 实现稳定的定时任务，确保数据完全掌握在您自己手中。

• 服务器需安装 Docker 和 Docker Compose。

1. VPS新建一个文件夹（例如 renewhelper）。
2. 在文件夹中创建一个名为 docker-compose.yml 的文件，填入以下内容：

services:
  renew-helper:
    # 官方镜像地址
    image: ieax/renewhelper:latest
    container_name: renew-helper
    restart: unless-stopped
    ports:
      - "9787:9787" # 将容器内部的 9787 端口映射到宿主机的 9787
    volumes:
      # 数据持久化：将宿主机的 ./data 目录挂载进去，防止重启丢失数据
      - ./data:/data
    environment:
      # --- 核心配置 ---
      
      # 1. 登录密码 (必填)
      - AUTH_PASSWORD=你的访问密码
      
      # 2. 定时任务频率 (关键配置)
      # 建议：设置为每30分钟运行一次，不要修改！！！
      # 语法："0,30 * * * *" 表示在每小时的第0分和第30分各触发一次。
      - CRON_SCHEDULE=0,30 * * * *
      
      # 3. 容器时区
      # 决定了 Cron 什么时候"醒来"，建议设置为你所在的地区
      - TZ=Asia/Shanghai

3. 启动服务：

   docker compose up -d

4. 打开浏览器访问：http://你的服务器IP:9787。为了安全地通过互联网访问 RenewHelper（例如 https://renew.example.com），建议配置反向代理。

services:
  renew-helper:
    image: ieax/renewhelper:latest
    container_name: renew-helper
    restart: unless-stopped
    # 移除 ports 映射，只暴露端口给 Caddy，更安全
    expose:
      - "9787"
    volumes:
      - ./data:/data
    environment:
      - AUTH_PASSWORD=admin
      - CRON_SCHEDULE=0,30 * * * *
      - TZ=Asia/Shanghai

  caddy:
    image: caddy:alpine
    container_name: caddy-proxy
    restart: unless-stopped
    ports:
      - "80:80"   # HTTP
      - "443:443" # HTTPS
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    depends_on:
      - renew-helper

volumes:
  caddy_data:
  caddy_config:

# 请将此处替换为您解析好的域名
your-domain.com {
    encode gzip
    # renew-helper 是 docker 服务名，9787 是容器内部端口
    reverse_proxy renew-helper:9787
}

docker compose up -d

为了确保通知时间准确，请确保以下两处设置一致：

1. Docker 环境变量 (TZ)：决定了 RenewHelper 什么时候醒来执行检查。
2. 网页端 -> 系统设置 -> 偏好时区：决定了 RenewHelper 醒来后，认为现在是几点。

• 数据位置：所有数据（订阅列表、系统配置、日志）都保存在 docker-compose.yml 同级目录下的 ./data 文件夹中。
• 备份：直接复制或压缩 ./data 文件夹即可。
• 迁移：在通过 Docker 部署新实例时，将备份的 ./data 文件夹放入目录，启动后数据会自动恢复。

当项目发布新版本时，执行以下命令即可更新：

# 1. 拉取最新镜像
docker compose pull

# 2. 重建并重启容器
docker compose up -d

部署成功后，访问您的 Worker 域名或您添加的自定义域名（如 https://renewhelper.your-name.workers.dev或 https://renewhelper.your-domain.com）。

1. 首次登录：使用您设置的 AUTH_PASSWORD（默认 admin）解锁。
2. 系统设置：点击控制台右上角的 系统设置 (SETTINGS) 按钮。
   • 时区设置：非常重要！请选择您所在的时区（如 Asia/Shanghai），这决定了提醒和日历的准确性。
   • 通知总开关：开启后可配置具体的推送渠道。

在“系统设置” -> “通知配置”中填写：

• 名称：服务的名称（如 "Netflix 4K"，"Google Voice - 8888"）。
• 标签：用于分类（如 Media, Server, Domain, PhoneNumber），支持多选。
• 模式：
  • 📅 循环订阅：每隔固定周期（如 1 个月/1 个自然年/1 个农历年）到期的各种事项，如月付会员订阅、年付 VPS 续费等。
  • ⏳ 到期重置：到期后需手动或自动处理，有效期随之展期的各种事项，如 eSIM 动账延长 180 天有效期、签到增加服务时长等。
• 农历开关：开启后，周期将按农历计算（适合农历生日、事物提醒）。
• 自动化策略：
  • 自动续期：到期后自动将下次到期日顺延一个周期。
  • 自动禁用：到期超过指定天数未处理，自动标记为禁用。

点击主界面的 运行日志 (LOGS) 按钮，可查看所有自动化任务的历史记录、推送结果以及操作审计。

在“系统设置”中找到 日历订阅 区域。

1. 复制订阅链接。
2. iOS: 设置 -> 邮件 -> 账户 -> 添加账户 -> 其他 -> 添加已订阅的日历。
3. Google Calendar: 添加日历 -> 来自 URL 或从订阅链接下载后文件导入。
4. Outlook: 文件 -> 添加日历 -> 从 WEB 订阅或从订阅链接下载后文件导入。
5. 手机自带日程 APP: 在 CalDAV 服务商添加订阅链接，手机添加 CalDAV 订阅信息进行日程同步或从订阅链接下载后，在日程软件中导入。
6. 注意: 链接包含安全 Token，请勿泄露。如泄露可点击“重置令牌”。

1. 数据安全：所有数据存储在您的 Cloudflare KV 中, 建议定期手动导出 JSON 备份。
2. 免费版限制：（Docker方式不受此限制）
   • Cloudflare Workers 免费版每天限制 100,000 次请求。
   • KV 每天写入限制 1,000 次。

如果您发现了 Bug 或有新功能建议，欢迎提交 Issue 或 Pull Request。

如果您觉得 RenewHelper 对您有帮助，欢迎请作者喝一杯咖啡 ☕️。您的支持是我持续更新的动力！

加密货币 - 国际用户

⚠️ 注意：此地址仅支持 EVM 兼容链 (以太坊/币安链/Polygon等)，请不要充值 TRC20 (波场) 资产！！！

爱发电 - 国内用户

License: MIT Copyright (c) 2025 LOSTFREE