lunalux/import-ynab

Import YNAB镜像说明

镜像概述

本镜像提供工具，可将Truelayer（间接对接英国多家银行API）或Revolut（非官方个人账户API）的交易数据导入至YNAB（You Need A Budget），并实现多货币转换及同步时的余额对账功能。

核心功能

• 支持从Truelayer或Revolut导入交易到YNAB
• 多货币交易按交易时汇率转换
• 同步过程中自动对账账户最终余额
• 提供Truelayer（只读权限，90天需续期）和Revolut（全权限，需手机号验证）两种账户配置方式

使用场景

• 需要将英国银行或Revolut账户交易自动同步到YNAB进行预算管理的用户
• 持有多货币账户、希望统一管理交易数据的场景

配置说明

初始化配置

生成默认配置文件到本地secrets目录：

bash
docker run -v $(pwd)/secrets:/app/secrets lunalux/import-ynab config init

添加Revolut账户

执行命令并按提示完成登录（需手机号接收验证码）：

bash
docker run -v $(pwd)/secrets:/app/secrets lunalux/import-ynab config add-revolut

注意：获取的密钥具有Revolut账户全权限（含支付功能），请谨慎保管和使用。

添加Truelayer账户

1. 注册Truelayer免费个人账户并获取客户端密钥，填入secrets目录下的配置文件
2. 执行命令并按OAuth流程完成银行认证：

bash
docker run -v $(pwd)/secrets:/app/secrets lunalux/import-ynab config add-truelayer

认证后授权有效期为90天，需定期续期。

同步交易

运行以下命令同步交易到YNAB（YNAB账户需通过ID匹配，ID可从同步日志复制并填写到YNAB账户备注字段）：

bash
docker run -v $(pwd)/secrets:/app/secrets lunalux/import-ynab sync