FlyBudget 自托管预算 从部署到首个月核对
用七笔合成交易实测 FlyBudget 本机 Docker 部署、月预算、现金流与备份恢复,并核对版本和删除边界。

想把预算放到自己的电脑上,先要回答两个问题:账能否算对,保存的数据能否带走。我用 FlyBudget 的官方 Docker 镜像启动了一个只在本机开放的实例,装入七笔合成交易,核对一个月预算,再删除一笔交易并恢复备份。收入 3,000 美元、支出 1,690 美元、净流入 1,310 美元与账户余额都能对上;恢复后,七笔交易和预算记录也回到原样。
这次样本通过本机 API 装入,再到英文界面检查预算、现金流和备份恢复。手工录入、CSV 导入和预算额度编辑没有完成实测,银行同步也没有启用。下面的记录围绕这个小样本展开。
先确定实际运行的是哪个版本
Reddit 原帖介绍 FlyBudget 的月预算、交易跟踪、现金流图和 Docker 自托管。作者同时也是开发者,帖子适合用来发现项目;真正执行时,我回到公开仓库核对源码和许可证。
这里有一个容易影响复现的差异:仓库 main 的 package.json 已是 1.0.0,而这次拉取的官方 latest 镜像标签仍是 0.1.0,对应源码提交 500ac93310a4dda26b0a0d9c08ec3fefffa24088。本文的部署和结果以该镜像为准,镜像摘要为:
ghcr.io/dtymoszenko/flybudget@sha256:0be7265ccac2a1caf64f2eb5d3154c72d420a33feeffcedc512d9fe86d9b5fe7
对应版本的 LICENSE是 GNU AGPL v3。它允许使用、研究和修改;把修改版通过网络提供给其他人时,需要按许可证向使用者提供对应源码。自己启动原版做预算试验,与提供一个修改后的公共服务,是不同的使用场景。
让测试实例只在本机开放
测试机是 macOS,Docker 引擎报告 Linux aarch64。官方镜像在该环境可以运行,不需要本机编译 React、Express 或 SQLite。容器里的 /data 保存数据库,本次使用独立临时目录,并把端口绑定到 127.0.0.1:18724。
第一次启动没有提供数据加密密钥,服务直接停止,错误是 Server mode requires an encryption key for bank credentials。这个要求在服务器模式下始终存在,即使本轮没有连接银行。补齐 32 字节的 base64 密钥后,实例进入设置流程;从该测试容器日志取一次性设置码,设置本地密码,再打开浏览器登录。密钥、设置码和密码都应留在自己的私有环境。
运行配置的关键部分如下。数据目录必须允许容器的 uid 1000 写入;FLYBUDGET_DATA_KEY 的值需自行生成并妥善保存,命令只传变量名,避免把实际值写进示例:
docker run -d --name flybudget-test \
-p 127.0.0.1:18724:3001 \
--mount type=bind,src=/your/private/test-data,dst=/data \
--env FLYBUDGET_DATA_KEY \
--read-only --tmpfs /tmp --cap-drop ALL \
--security-opt no-new-privileges:true \
ghcr.io/dtymoszenko/flybudget@sha256:0be7265ccac2a1caf64f2eb5d3154c72d420a33feeffcedc512d9fe86d9b5fe7
该版本的 Compose 配置还提供从 secret 文件读取密钥的方式。它默认把端口开放到所有网络接口;这里只测试本机,所以显式使用回环地址。计划从其他设备访问时,HTTPS、反向代理和持久化目录权限都要按自托管文档配置,那部分没有在本轮搭建。
用一个能手算的月份核对预算
合成账户名为 Synthetic Checking,期初余额 1,000 美元,属于预算内 checking 账户。样本月份是 2026 年 9 月,所有收款方也都使用 Synthetic 前缀。API 的金额单位是整数分,收入为正、支出为负,例如工资 3,000 美元传入 300000,房租 1,200 美元传入 -120000。
| 日期 | 类别 | 收支金额 美元 |
|---|---|---|
| 9 月 1 日 | Salary | +3,000 |
| 9 月 2 日 | Rent | -1,200 |
| 9 月 6 日 | Groceries | -80 |
| 9 月 10 日 | Utilities | -90 |
| 9 月 12 日 | Groceries | -120 |
| 9 月 20 日 | Groceries | -140 |
| 9 月 22 日 | Transportation | -60 |
这七笔没有转账、拆分交易或余额调整,方便先验证最基本的计算。月支出为 1,200 + 80 + 90 + 120 + 140 + 60 = 1,690,净流入是 3,000 - 1,690 = 1,310,账户余额是 1,000 + 1,310 = 2,310。账户 API 与现金流 API 都返回这些数值。
预算计划分别是房租 1,200、食品 300、水电 100、交通 80,合计 1,680。实际食品支出 340,超出 40;水电和交通分别余下 10、20,总预算差额为负 10。在 Budget 页面选回 September 后,Planned、Actual、Remaining 三列与手算一致。

食品预算 300,实际 340;全月计划 1,680,实际 1,690。
准备测试分类时,我还遇到一个显示边界:直接通过 API 新建的费用分类未指定 budgetType,它们参与总数计算,却没有出现在固定或弹性预算分组的明细里。为分类补上 fixed 或 flexible 后,明细才完整显示。因此自己写导入脚本时,金额和类别 ID 对上还不够,预算类型也要完整;正常界面的创建流程与 API 批量装入要分别验证。
右侧 Left to budget 是 1,320,即收入 3,000 减去已分配计划 1,680。账户余额 2,310 还包含期初资金,二者描述的是不同对象。这个简单样本说明,看见几个绿色数字时仍要先认清它们的口径。

现金流图显示样本收入 3,000、支出 1,690、净收入 1,310。
截图的 Cash Flow 选择 6M 范围,实例只有这一月的七笔样本,所以汇总与单月查询相同。43.7% 是净收入除以收入的展示结果,图里的 Savings 表示该范围的结余;它不是另一笔已经转入储蓄账户的交易。
备份是否真的能把账恢复回来
我在 Settings → Data 点 Download Backup,得到格式为 flybudget-backup、版本 2 的 JSON。文件包含账户、类别、交易、月预算等表,七笔样本都在其中;同期 CSV 导出包含一行表头和七行交易。CSV 适合核对流水,完整 JSON 才覆盖这次恢复所需的预算和分类。
随后通过本机 API 删除 140 美元的食品交易,服务返回 204,备份读回剩六笔,账户余额变成 2,450。回到 Data,在 Restore Backup 选择刚才下载的 JSON,确认 Replace my data。界面报告恢复七笔交易,并提示原数据库已另存为恢复前的安全副本。
恢复后再导出 JSON,去掉自动变化的 exportedAt 字段,其余所有表与原备份完全相同;账户余额恢复为 2,310。这里验证了删除一笔交易之后的恢复路径,也验证了完整备份对这个小样本的往返一致性。银行凭据没有进入该 JSON 备份,涉及银行连接时还要单独管理加密密钥和连接配置。
删除按钮与真正清除副本的区别
我另建一个零余额的 Synthetic Archive Probe 账户,调用删除账户接口后,它从活动列表消失,但新的完整备份里仍有该账户及非空的 closedAt 字段。对应源码也显示,删除账户执行的是关闭操作。
删交易可以改变活动账本,关闭账户可以整理列表;两者都不会自动销毁已经下载的 JSON、恢复前的数据库安全副本或浏览器离线副本。准备撤掉自托管实例时,应先停止自己创建的容器,确认是否保留数据库和备份,再处理自己的持久化目录及浏览器副本。此次只验证逻辑删除与恢复,没有验证磁盘安全擦除。
数据掌控需要把整条路径看清
这次实际路径是浏览器 → 本机端口上的 Express API → /data 中的 SQLite 数据库,导出再回到本机文件。打开现金流页面时,浏览器资源请求的来源只有 http://127.0.0.1:18724。该版本代码包含 Plaid、SimpleFIN 和收款方标志等网络能力;本轮没有配置银行连接或使用外部标志服务,因此这一观察只覆盖所走的页面与合成样本流程。
FlyBudget 对这类小规模手动维护的预算有一个实用起点:本机实例能够把类别预算、真实流水口径和可恢复备份放在同一条工作链里。选择它之前,我会先用自己的合成月份跑一遍同样的算式,确认版本、分类、期初余额与备份目录,再决定是否放入真正账本。多账户转账、拆分、跨月结转和银行同步会改变核对条件,应在需要时分别测试。