[Open Source Update] RenewHelper v2.0 Deep Guide: Not Just a Reminder, but Your Digital Asset Financial Steward

RenewHelper 迎来发布以来最大规模的升级——v2.0 版本

除了完善的多渠道通知提醒以外,本次更新重构了核心逻辑,引入了多币种汇率自动换算、支出趋势分析、历史账单管理。无论你是管理几台 VPS,还是几十个订阅,v2.0 都能让你对每一笔数字支出如指掌。


:glowing_star: v2.0 核心亮点:三大维度升级

1. 财务看板:钱花在哪里,一目了然

v2.0 不再只是告诉你“什么时候过期”,而是告诉你“花了多少钱”。

  • 多币种自动汇率换算

  • 功能:支持 USD, CNY, EUR, GBP 等主流货币。系统接入了免费的汇率Frankfurter API(该API服务也支持用户自建),并利用 KV 缓存机制优化性能,每天自动更新汇率。

  • 体验:你购买的是美元支付的服务器,是日元支付的游戏会员?没问题。系统会自动将它们换算为你设置的“默认币种”(如 CNY),并统计总资产规模。

  • 双模式支出分析 (Dashboard)

  • 点击首页的 “视图切换” (View Switch)“支出分析”,你将看到全新的可视化图表。

  • 账单金额模式 (Bill Amount):按服务的订阅周期统计,包含开启了自动续费的未来预测账单统计,适合做预算规划。

  • 实际支出模式 (Actual Cost):按你实际付款的操作日期统计,适合查看每月的现金流压力。

  • 交互式图表:支持查看“月度趋势”曲线、“月度平均支出”和“年度汇总”柱状图,也可以点击某个月份查看当月的详细消费明细。

2. 账单管理:全生命周期记录

以前的版本只记录“下一次到期日”,v2.0 开始记录每一次“续费历史”。

  • 完整的续费历史 (Renewal History)

  • 现在,你可以为每一个服务记录无限条历史账单。

  • 补录功能:老用户的福音。点击服务菜单中的“历史记录” → “+”,可以补录过去几年的续费记录,系统会自动计算历史总花费。

  • 智能续费:点击“手动续期”时,系统会自动根据你的周期设置(如:月付、年付、农历周期)预填充开始和结束日期,并自动填入价格。

  • 未来账单预测 (Upcoming Bills)

  • 左上角的 :bell: 铃铛图标 变得更聪明了。

  • 它不仅显示即将到期的服务,还会根据你的“自动续期”设置,预测未来 N 天内需要支付的金额总和。

  • 自定义阈值:你可以在设置中调整“待付款提醒天数”(默认为 7 天),提前规划资金。

3. 体验与部署:更自由,更强大

  • 高级筛选器 (Smart Filters)
  • 服务太多找不到?v2.0 增加了强大的筛选栏。
  • 按状态:已过期、n天内到期、30天内到期。
  • 按稳定性:新服务 (<30天)、长期服务 (>1年)。
  • 按标签:点击标签即可快速聚合查看。
  • 自动更新:支持 Watchtower,镜像更新后自动拉取,保持最新,懒人福音。
  • 自定义通知标题:现在的推送通知(Telegram, PushPlus 等)支持自定义标题。你可以把它改为“我的财务日报”或任何你喜欢的名字,让提醒更具个性化。

:hammer_and_wrench: v2.0 快速上手教程

如果你是新用户且想一次部署并保持更新建议按README中,方式三:GitHub Actions 部署并启用sync上游同步(注意必须设置完secrets才会部署成功)。

场景一:从 v1.x 升级与数据迁移

如果你是老用户,更新代码后,可能会发现很多项目没有历史账单数据。

  1. 部署新代码:将 _worker.js 替换为 v2.0.20 版本。
  2. 数据迁移工具
  • 进入 设置 (Settings)数据管理
  • 点击 “升级旧数据 (Migrate Old Data)”
  • 作用:系统会自动扫描所有旧项目,根据它们当前的“上次续费时间”和“周期”,自动生成一条初始的账单记录。这能让你立刻看到财务统计数据,而无需手动一个个添加。(除了手动操作,系统也每日会自动扫描并提醒一次)

场景二:如何记账?

假设你刚续费了一台年付 $50 的 VPS。

  1. 在列表中找到该 VPS,点击 “手动续期” (Renew) 按钮。
  2. 系统会弹出对话框:
  • 续费日期:自动填入今天。
  • 账单周期:自动根据去年的结束日期往后推算一年(例如 2025-06-012026-06-01),无需手动计算。
  • 金额:自动填入预设的 $50(你也可以根据实际修改金额)。
  1. 点击 “确认”
  2. 结果:服务的“到期日”自动更新,同时在后台生成了一笔历史账单。你的“支出分析”看板中,今年的支出会自动增加 $50(对应的汇率换算金额)。

场景三:查看“我今年在订阅上花了多少钱?”

  1. 点击主界面右上方的 “视图切换”,选择 “支出分析”
  2. 在右侧的 “年度汇总” 区域,你将看到本年度的总支出柱状图。
  3. 点击 “2026” 柱状条,左侧的趋势图将展示 2026 年每个月的消费分布。
  4. 看一眼左上角的数字,那就是你今年的“订阅总账单”。

:spouting_whale: Docker 部署指南 (支持自动更新)

对于不想依赖 Cloudflare Workers 的用户,现在可以直接使用 Docker compose部署:

services:
  renewhelper:
    image: ieax/renewhelper:latest
    container_name: renewhelper
    restart: unless-stopped
    ports:
      - "9787:9787"
    volumes:
      - ./data:/data
    environment:
      # 1. 设置登录密码
      - AUTH_PASSWORD=admin
      
      # 2. 设置 Cron 定时任务 (Cron 表达式)
      - CRON_SCHEDULE=0,30 * * * *
      
      # 3. 容器时区 (影响日志和本地时间计算)
      - TZ=Asia/Shanghai

  # 若需自动更新保留以下watchtower配置
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 86400 --cleanup
    environment:
      - TZ=Asia/Shanghai

  • 数据持久化:建议挂载 /app/data 目录以保存 KV 数据。
  • 多架构支持:镜像支持 amd64 和 arm64。

结语

RenewHelper v2.0 不仅仅是一个记录工具,它试图解决的是数字时代的“订阅焦虑”。通过自动化的计算、清晰的图表和精准的提醒,它让你从被动的“等待扣费”,变为主动的“财务掌控”。

立即升级,开启你的订阅资产管理 2.0 时代!

:backhand_index_pointing_right: 项目地址: GitHub - RenewHelper
演示站地址https://lostfree.de5.net
演示站密码:demo
演示站千万不要保存你推送渠道的各种TOKEN和API KEY!!!
代码完全开源,MIT 协议。
如果觉得好用,求大佬们给个 Star :glowing_star: 支持一下!
有 Bug 或建议欢迎提 Issue 或在楼里反馈。

25 Likes

Thanks for the great tutorial sharing! :xhj001:

Thank you for sharing :xhj001:

Study hard! :xhj15:

UI is quite good, pretty nice

Thank you for sharing

Thank you for sharing :xhj001:

Thanks sir

Thank you for sharing!

Thank you for sharing :xhj006:

Thank you for sharing

Thank you for sharing

Thank you for sharing sourceMappingURL

I also come to support.

yongqilai

Thank you for sharing

Thank you for sharing!

support

1 Like

Thank the great contributor for the share

grab a red envelope

1 Like