一个 Fava 控制面板【Fava Management】

探索 Fava Management：一个 Fava 控制面板

在管理财务的过程中，我们常常需要对 Fava 进行操作和维护，但在服务器上运行 Fava 时，可能会遇到 Fava 进程频繁崩溃的问题。为了更好地管理 Fava，本篇博客将介绍一个名为 Fava Management 的开源项目，它不仅提供了重启 Fava 的功能，还为 Fava 添加了基于 Django 的身份验证系统。

项目简介

Fava Management 是一个旨在简化 Fava 管理的工具。它为 Fava 提供了一个控制面板，使得用户可以通过浏览器重启 Fava 进程，并且增强了系统的安全性。该项目集成了 Django 框架，提供了身份验证功能，以保护 Fava 的管理界面。

功能特点

1. Fava 重启
   用户可以通过控制面板轻松重启 Fava，无需直接在服务器上操作。这对于维护和恢复服务尤为重要。

2. Fava 身份验证
   通过 Django 提供的身份验证机制，Fava Management 为 Fava 的管理界面增加了额外的安全层，确保只有授权用户才能访问管理功能。

安装指南

要在本地环境中安装和配置 Fava Management，请按照以下步骤进行操作：

git clone https://github.com/quewen08/fava-management
cd fava-management
# 如果你已经安装了 Fava 和 Beancount，可以跳过下面的 pip 安装
pip install -r requirements.txt
# 创建数据库
python manage.py migrate
# 创建超级用户
python manage.py createsuperuser

开发模式

在开发模式下运行 Fava Management，你需要提供 Fava 的入口文件路径。可以使用以下命令启动开发服务器：

# 路径必须是绝对路径
python3 manage.py runserver --fava="your_beancount_entrypoint_file"

有关 Django 的更多详细信息，可以参考 Django documentation。

生产环境

在生产环境中，你可以使用 Gunicorn 来运行 Fava Management：

BEANCOUNT_FILE=your_beancount_entrypoint_file gunicorn management.wsgi

更多关于 Gunicorn 的信息，请参考Gunicorn documentation。

使用 Docker

如果你更倾向于使用 Docker 来部署 Fava Management，可以使用以下命令：

# CSRF_TRUSTED_ORIGINS是需要https允许登录的域名地址，若该服务需要以https部署，请自行配置。
docker run --rm -v/data/bean:/bean -p8000:8000 -eBEANCOUNT_FILE=/bean/main.bean -eUSERNAME=admin -ePASSWORD=12345678 -eCSRF_TRUSTED_ORIGINS="https://domain1.com,https://domain2.com" -it quewen08/fava-management

使用Docker-compose

version: '3'
services:
  fava:
    image: quewen08/fava-management
    container_name: 'fava'
    restart: always
    ports:
      - "8000:8000"
    environment:
      - BEANCOUNT_FILE=/bean/main.bean
      - USERNAME=admin
      - PASSWORD=12345678
      - CSRF_TRUSTED_ORIGINS="https://domain1.com,https://domain2.com"
    volumes:
      - /data/bean:/bean

增强安全性

为了进一步提高安全性，你可以考虑以下扩展工具：

Django 管理员 IP 限制器
Django OTP
Django 管理员验证码

许可证

Fava Management 使用 MIT 许可证。

---

通过上述介绍，希望你对 Fava Management 项目有了更清晰的了解。它为 Fava 的管理提供了强大的功能，并且易于部署。如果你在使用过程中有任何问题或需要进一步的帮助，请随时联系项目维护者或参考项目的文档。