tarioch/fava

tarioch/docker-fava Docker镜像文档

镜像概述

tarioch/docker-fava是一个预配置的Docker镜像，包含了Fava应用程序。Fava是一个现代化的Web界面，用于查看和编辑Beancount复式记账文件，提供了丰富的财务数据可视化、报表生成和交易管理功能。

核心功能与特性

• 完整集成Fava应用程序，无需手动配置
• 提供直观的财务数据可视化界面
• 支持Beancount文件的查看和编辑
• 内置多种财务报表和分析工具
• 响应式设计，适配各种设备屏幕
• 支持多用户访问控制
• 自动检测Beancount文件变更并更新

使用场景

• 个人财务管理和记账
• 小型企业财务记录管理
• 财务数据可视化与分析
• 家庭预算规划与跟踪
• 个人财务报告生成

快速开始

基本使用 (docker run)

bash
docker run -d -p 5000:5000 -v /path/to/your/beancount/file.beancount:/beancount/main.beancount tarioch/docker-fava

然后通过浏览器访问 http://localhost:5000 即可使用Fava界面。

Docker Compose 配置

yaml
version: '3'
services:
  fava:
    image: tarioch/docker-fava
    ports:
      - "5000:5000"
    volumes:
      - /path/to/your/beancount/file.beancount:/beancount/main.beancount
    restart: unless-stopped

详细配置

环境变量

卷挂载

• 必须挂载Beancount文件到容器内的/beancount/main.beancount路径，或通过BEANCOUNT_FILE环境变量指定自定义路径
• 可以挂载额外的目录用于存放报表或其他配置文件

高级使用示例

指定自定义Beancount文件路径:

bash
docker run -d -p 5000:5000 \
  -e BEANCOUNT_FILE=/data/finances.beancount \
  -v /path/to/your/data:/data \
  tarioch/docker-fava

使用额外选项运行:

bash
docker run -d -p 5000:5000 \
  -v /path/to/your/beancount/file.beancount:/beancount/main.beancount \
  tarioch/docker-fava \
  fava --port 5000 --host 0.0.0.0 /beancount/main.beancount

访问应用

启动容器后，通过浏览器访问以下地址即可使用Fava:

• 本地: http://localhost:5000
• 远程: http://<服务器IP地址>:5000

持久化数据

为确保财务数据不会丢失，请确保正确挂载Beancount文件作为卷。建议定期备份您的Beancount文件。

版本更新

要更新到最新版本的Fava，只需拉取最新的镜像并重新创建容器:

bash
docker pull tarioch/docker-fava
docker stop <container-name>
docker rm <container-name>
# 然后使用之前的run命令重新创建容器

相关资源

• https://beancount.github.io/fava/
• https://beancount.github.io/docs/
• https://github.com/tarioch/docker-fava