grostim/fava-docker

fava-docker 镜像文档

镜像概述和主要用途

fava-docker是一个为beancount-fava构建的Docker镜像，基于Yegle的基础版本扩展开发。该镜像旨在提供便捷的个人财务跟踪环境，通过集成额外工具增强beancount-fava的自动化处理能力，支持财务数据版本控制、交易智能导入及PDF账单解析等功能。

核心功能和特性

• 基础功能：基于beancount-fava，提供财务数据可视化与管理界面
• 扩展工具集成：
  • Git：支持财务数据版本控制与历史追踪
  • smart-importer：实现银行交易数据智能匹配与自动导入
  • poppler-utils（含pdftotext）：解析PDF格式账单并提取文本数据
  • wget：支持从网络获取交易数据文件
  • cron：配置定时任务实现自动化数据同步与导入
  • beancount-plugins-metadata-spray：增强财务数据元数据处理能力

环境变量

使用场景和适用范围

• 个人财务跟踪与预算管理
• 银行/支付平台交易记录自动化导入
• 多格式财务文档（含PDF）批量处理
• 财务数据版本化管理与备份
• 需要定时执行财务数据同步的场景

使用方法和配置说明

基本运行命令

bash
docker run -d \
  -p 5000:5000 \
  -e BEANCOUNT_FILE=/data/main.beancount \
  -v /本地/beancount文件路径:/data \
  fava-docker

参数说明：

• -p 5000:5000：映射容器5000端口到主机，通过http://localhost:5000访问fava界面
• -e BEANCOUNT_FILE=/data/main.beancount：指定容器内beancount主文件路径（需与数据卷挂载路径对应）
• -v /本地/beancount文件路径:/data：挂载本地beancount数据目录到容器内/data目录，实现数据持久化

数据持久化配置

建议将本地财务数据目录挂载到容器内，确保数据持久化与版本控制：

bash
docker run -d \
  -p 5000:5000 \
  -e BEANCOUNT_FILE=/data/finances/main.beancount \
  -v /home/user/finance-data:/data \
  fava-docker

定时任务配置（cron）

1. 进入运行中的容器：docker exec -it [容器ID] /bin/bash
2. 编辑crontab：crontab -e
3. 添加定时任务（例如每日自动同步数据）：

   bash
   0 2 * * * cd /data && git pull && fava import /data/transactions.csv
   

4. 保存退出，cron服务将自动应用配置