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

一劳永逸的到期提醒方案
如果你手里有一堆需要“记得续费 / 到期处理”的东西——域名、服务器、会员订阅、证书、甚至纪念日——那你大概率经历过这种场景:
用的时候才发现过期了,或者被扣费了才想起来。

RenewHelper 正是为解决这类问题而生的工具。它把“时间 + 周期 + 提醒”这件事系统化、自动化,让你少操心。
这篇文章重点介绍 通过 Docker 部署 RenewHelper 的方式,过程简单、稳定,适合长期运行。
RenewHelper 是什么?
项目地址 RenewHelper 是一个用于管理周期性到期事项的 Web 工具,可以统一管理各种需要提醒或续期的内容:

-
• 域名 / 服务器到期
-
• 各类订阅、会员续费
-
• 证书有效期
-
• 生日、纪念日等周期事件
它支持定时检查 + 多渠道通知,把“容易忘”的事情交给系统处理。
为什么推荐 Docker 部署?
相比本地运行或脚本式工具,Docker 部署有几个明显优势:
-
• 环境一次配置,后续几乎不用管
-
• 升级、迁移成本低
-
• 数据可持久化,不怕重启
-
• 非常适合放在 VPS / NAS / 服务器长期运行
一句话:省心、省事、可维护。
Docker Compose 部署示例
下面是一份已经整理好的 docker-compose.yml 示例,直接可用:
version: "3.3"
services:
renew-helper:
image: ieax/renewhelper:latest
container_name: renew-helper
restart: unless-stopped
ports:
- "80:9787" # 访问 http://服务器IP 即可
volumes:
- ./data:/data
environment:
# 登录后台的密码(必填)
- AUTH_PASSWORD=111111 # 定时任务执行频率(强烈建议不要改)
# 每小时的 0 分和 30 分执行一次
- CRON_SCHEDULE=0,30 * * * * # 容器时区,影响定时任务触发时间
- TZ=Asia/Shanghai启动方式:
docker compose up -d启动完成后,在浏览器访问:
http://服务器IP使用上面配置的 AUTH_PASSWORD 登录即可。

几个关键配置说明
1️⃣ 登录密码(AUTH_PASSWORD)
这是后台唯一的登录凭证,请务必修改为自己的强密码。
2️⃣ 定时任务频率(CRON_SCHEDULE)
官方推荐配置为:
0,30 * * * *含义是:每小时的第 0 分和第 30 分执行一次检查。
这个频率在“及时性”和“资源占用”之间比较平衡,不建议随意修改。
3️⃣ 时区设置(TZ)
时区直接影响提醒的触发时间,如果你在国内,使用:
Asia/Shanghai即可。
核心特性一览
⚡ Serverless / 多形态部署
RenewHelper 采用 Serverless 优先设计:
-
• 完全运行在 Cloudflare Workers 上,数据存储于 Cloudflare KV
-
• 无需购买 VPS,无需维护服务器,个人使用基本可覆盖在免费额度内
-
• 自 v1.3.5+ 起,同时支持 单机 Docker 部署,满足自托管与离线环境需求
这意味着:既能“零成本云端运行”,也能“完全掌控本地数据”。
📅 智能周期管理(核心能力)

这是 RenewHelper 的灵魂模块:
-
• 同时支持 公历 / 农历(Lunar) 周期计算
-
• 内置 1900–2100 年高精度农历算法,覆盖长期使用场景
-
• 支持:
-
• 按 天 / 月 / 年 自动推算• 公历循环(如月付、年付订阅)• 农历循环(如生日、传统节日)
-
• 提供两种模型:
-
• 循环订阅(到期即推算下一个周期)• 到期重置(手动确认后重置)
不只是“提醒一次”,而是可持续、可预测的时间管理。
🔔 多渠道通知能力

内置多种主流推送方式,无需二次开发:
-
• Telegram
-
• Bark
-
• PushPlus
-
• NotifyX
-
• Resend(Email)
-
• Webhook
同时支持:
-
• 自定义提前提醒天数
-
• 指定每日推送时间
-
• 多通知渠道并行推送
真正做到:重要的事,一定能被看到。
🤖 自动化管理机制
RenewHelper 不只是“提醒工具”,而是带有自动化策略的管理系统:
-
• 自动续期:到期后自动计算并更新下一次提醒
-
• 自动禁用:长期未处理的过期服务自动标记为禁用
-
• Cron 驱动:
-
• Cloudflare Cron Triggers 定时检查• Docker 环境内 Cron 定期执行
让系统替你盯时间,而不是你盯系统。
📆 ICS 日历订阅
支持标准 .ics 日历订阅:
-
• 可直接接入 iOS 日历 / Google Calendar / Outlook
-
• 支持时区感知的精确提醒
-
• 与手机系统日程天然融合
你甚至不需要打开 RenewHelper,也不会错过提醒。
截选自项目说明

🛡️ 安全与可靠性
在轻量化的同时,安全并未妥协:
-
• JWT 身份认证,支持高强度密钥自动生成
-
• 混合限流策略(内存 + KV),防止暴力破解
-
• 数据仅存储在 你自己的 Cloudflare KV 中
-
• 删除、重置等敏感操作强制二次确认
🎨 现代化 UI 与易用性
-
• Vue 3 + Element Plus 构建的现代前端
-
• 单文件部署,轻量易维护
-
• 支持深色 / 浅色模式
-
• 响应式设计,适配手机与桌面
-
• 中英双语界面
-
• 支持数据导入 / 导出与备份
使用体验总结
RenewHelper 它的定位非常明确:
-
• 把容易忘、容易拖的事情自动化
-
• 把零散的到期提醒集中管理
-
• 把被动挨提醒变成主动可控
部署完成后,基本属于 跑着就不用管 的那种服务,非常适合长期放在服务器角落里默默干活。
如果你正好被各种续费、到期问题反复折腾,这个工具值得一试。