安卿辰博客前言
在当今的工作与生活场景中，各类订阅服务（如VPS、域名、云服务等）已逐渐成为我们不可或缺的一部分。不过，随着订阅数量的不断增加，我们很容易遗忘续费日期，从而引发服务中断或其他不便。为了高效管理这些服务的生命周期，RenewHelper - 时序·守望应运而生。
RenewHelper 是一款基于 Cloudflare Workers 的全栈服务生命周期提醒与管理工具，专为周期性订阅、域名续费、服务器到期等场景打造。与传统管理工具不同，它无需复杂服务器部署，可实现零成本托管。该工具提供精美的机甲风（Mecha-style）UI 界面，并内置强大的农历/公历计算核心，能够精准计算各类到期时间。此外，RenewHelper 还支持多渠道通知推送，确保您不会错过任何重要提醒，同时可与 iCal 日程同步，方便在不同设备上查看和管理提醒。
在本期教程中，我们将通过 Docker 部署 RenewHelper，助您快速搭建自己的订阅服务到期提醒系统。无论您是个人用户还是团队管理者，都可以借助此工具确保所有关键服务不会因忘记续费而中断。
项目简介
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 构建的单文件前端。
- 支持深色/浅色模式切换。
- 响应式设计，完美适配移动端和桌面端。
- 中英双语界面。
- 支持数据导入/导出备份。
有关截图
主界面
新增服务
通知方式
IOS设备Bark通知界面
安卓设备建议使用微信推送
部署方法
使用Docker安装
cloudflare方式无需服务器即可部署
本教程主要演示使用Docker进行安装部署，操作简单便捷
准备条件
1）一台服务器
我们使用莱卡云VPS进行演示
需要VPS的用户可以参考以下配置信息及资源占用情况
莱卡云
本期Docker容器占用资源情况如下，仅供参考，内存占用大约100M
2）本项目使用到的项目
本教程使用的官方GitHub地址
目前有156个Stars
3）域名
建议绑定域名，否则可能存在安全风险
①VPS部署
一、Docker环境部署
在VPS上安装Docker和Docker-Compose
Docker官方安装文档（英文）
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档（英文）
https://duan.yyzq.eu.org/docker-002
CentOS安装Docker和Docker-Compose（中文）
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-Compose（中文）
https://duan.yyzq.eu.org//04
推荐直接使用一键脚本
Docker安装脚本
bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)
执行以下命令查看Docker版本
docker --version
Docker version 29.1.3, build f52814d
Docker-Compose安装脚本
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose
执行以下命令查看Docker-Compose版本
docker-compose --version
Docker Compose version v5.0.1
二、部署命令
使用root账户登录服务器，执行以下步骤
Docker-Compose命令
创建一个目录并进入该目录
mkdir renewhelper ;cd renewhelper
然后新建docker-compose.yml文件
vim docker-compose.yml
services:
renew-helper:
image: ieax/renewhelper:latest # 官方镜像地址
container_name: renew-helper # 容器名称
restart: always # 设置容器重启策略，always 表示容器退出时自动重启
ports:
- "9787:9787" # 将容器内部的 9787 端口映射到宿主机的 9787，方便外部访问
volumes:
- ./data:/data # 数据持久化：将宿主机的 ./data 目录挂载进去，防止容器重启后数据丢失
environment:
- AUTH_PASSWORD=123456abc # 登录密码：设置容器内部的登录密码，必填项
- CRON_SCHEDULE=0,30 * * * * # Cron 调度：设置容器定时任务的执行时间，语法为 "分钟 小时 日 月 星期"，例如："0,30 * * * *" 表示每小时的第0分和第30分执行任务
- TZ=Asia/Shanghai # 时区设置：定义容器的时区，建议设置为你所在的地区，便于定时任务的正确执行
三、执行容器运行命令
docker-compose up -d #运行容器
docker-compose ps #查看是否启动成功
正常启动后显示如下
docker-compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
renew-helper ieax/renewhelper:latest "docker-entrypoint.s…" renew-helper 2 weeks ago Up 2 weeks 0.0.0.0:9787->9787/tcp, [::]:9787->9787/tcp
四、Web界面
打开Web页面使用
成功启动后，需开放相应端口（如9787）的防火墙，即可通过Web端访问
主界面
http://ip:9787
②飞牛NAS部署
直接复制上述VPS的Compose配置，参考VPS步骤操作即可
启动成功
绑定域名
在VPS上建议绑定域名，以便于公网使用
绑定域名的教程请参考以下内容
绑定域名视频教程
B站
YouTube
绑定域名可参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch
简单使用
新增服务
通知服务
iOS设备建议使用Bark或微信pushplus
安卓设备建议使用PushPlus
电报推送我测试多次未成功，有兴趣的可以自行尝试
如有任何问题，可直接留言或联系我
如有任何问题，可直接留言或联系我
如有任何问题，可直接留言或联系我
欢迎关注我们的微信公众号！
