用 Docker 部署 RenewHelper:管住所有续费和到期时间

一劳永逸的到期提醒方案

如果你手里有一堆需要”记得续费 / 到期处理”的东西——域名、服务器、会员订阅、证书、甚至纪念日——那你大概率经历过这种场景:

用的时候才发现过期了,或者被扣费了才想起来。

RenewHelper 正是为解决这类问题而生的工具。它把”时间 + 周期 + 提醒”这件事系统化、自动化,让你少操心。

这篇文章重点介绍 通过 Docker 部署 RenewHelper 的方式,过程简单、稳定,适合长期运行。


RenewHelper 是什么?

项目地址:https://github.com/ieax/renewhelper

RenewHelper 是一个用于管理周期性到期事项的 Web 工具,可以统一管理各种需要提醒或续期的内容:

适用场景:

  • 域名 / 服务器到期
  • 各类订阅、会员续费
  • 证书有效期
  • 生日、纪念日等周期事件

它支持定时检查 + 多渠道通知,把”容易忘”的事情交给系统处理。


为什么推荐 Docker 部署?

相比本地运行或脚本式工具,Docker 部署有几个明显优势:

  • 环境一次配置,后续几乎不用管
  • 升级、迁移成本低
  • 数据可持久化,不怕重启
  • 适合长期运行,可部署在 VPS / NAS / 服务器

一句话:省心、省事、可维护


Docker Compose 部署示例

下面是一份整理好的 docker-compose.yml 示例,直接可用:

启动方式:

启动完成后,在浏览器访问:http://服务器IP

使用上面配置的 AUTH_PASSWORD 登录即可。


关键配置说明

登录密码(AUTH_PASSWORD)

这是后台唯一的登录凭证,请务必修改为自己的强密码。

定时任务频率(CRON_SCHEDULE)

官方推荐配置为:
,30 * * * *

含义是:每小时的第 0 分和第 30 分执行一次检查

这个频率在”及时性”和”资源占用”之间比较平衡,不建议随意修改。

时区设置(TZ)

时区直接影响提醒的触发时间,如果你在国内,使用:

Asia/Shanghai

即可。


核心特性一览

Serverless / 多形态部署

RenewHelper 采用 Serverless 优先设计

  • 完全运行在 Cloudflare Workers 上,数据存储于 Cloudflare KV
  • 无需购买 VPS,无需维护服务器,个人使用基本可覆盖在免费额度内
  • v1.3.5+ 起,同时支持 单机 Docker 部署,满足自托管与离线环境需求

这意味着:既能”零成本云端运行”,也能”完全掌控本地数据”。


智能周期管理(核心能力)

这是 RenewHelper 的灵魂模块:

  • 同时支持 公历 / 农历(Lunar) 周期计算
  • 内置 1900–2100 年高精度农历算法,覆盖长期使用场景
  • 支持多种周期模式:
  • 天 / 月 / 年 自动推算
  • 公历循环(如月付、年付订阅)
  • 农历循环(如生日、传统节日)
  • 提供两种模型:
  • 循环订阅(到期即推算下一个周期)
  • 到期重置(手动确认后重置)

不只是”提醒一次”,而是可持续、可预测的时间管理。


多渠道通知能力

内置多种主流推送方式,无需二次开发:

同时支持:

  • 自定义提前提醒天数
  • 指定每日推送时间
  • 多通知渠道并行推送

真正做到:重要的事,一定能被看到。


自动化管理机制

RenewHelper 不只是”提醒工具”,而是带有自动化策略的管理系统:

  • 自动续期:到期后自动计算并更新下一次提醒
  • 自动禁用:长期未处理的过期服务自动标记为禁用
  • Cron 驱动
  • Cloudflare Cron Triggers 定时检查
  • Docker 环境内 Cron 定期执行

让系统替你盯时间,而不是你盯系统。


ICS 日历订阅

支持标准 .ics 日历订阅

  • 可直接接入 iOS 日历 / Google Calendar / Outlook
  • 支持时区感知的精确提醒
  • 与手机系统日程天然融合

你甚至不需要打开 RenewHelper,也不会错过提醒。

截选自项目说明


安全与可靠性

在轻量化的同时,安全并未妥协:

  • JWT 身份认证,支持高强度密钥自动生成
  • 混合限流策略(内存 + KV),防止暴力破解
  • 数据仅存储在 你自己的 Cloudflare KV
  • 删除、重置等敏感操作强制二次确认

现代化 UI 与易用性

  • Vue 3 + Element Plus 构建的现代前端
  • 单文件部署,轻量易维护
  • 支持深色 / 浅色模式
  • 响应式设计,适配手机与桌面
  • 中英双语界面
  • 支持数据导入 / 导出与备份

使用体验总结

RenewHelper 的定位非常明确:

  • 把容易忘、容易拖的事情自动化
  • 把零散的到期提醒集中管理
  • 把被动挨提醒变成主动可控

部署完成后,基本属于 跑着就不用管 的那种服务,非常适合长期放在服务器角落里默默干活。

如果你正好被各种续费、到期问题反复折腾,这个工具值得一试。