Firefly III:免费开源的自主托管个人财务管理器
Firefly III 是一个自由开源、可自托管的个人财务管理器,用于记录收入与支出、管理预算/分类/标签,并提供财务报表、定期交易、规则化交易处理、复式记账、储蓄目标、双因素认证、多币种支持与覆盖大部分功能的 REST JSON API。项目强调隐私友好,不使用 AI、不依赖云端,在你明确指示前不会连接外部服务器。
社区作者 · zZz
它解决什么问题
项目定位
Firefly III 是一个(自托管的)个人财务管理器,帮助你跟踪支出和收入,从而少花多存。它支持预算、分类和标签,提供多种数据导入工具,并内置大量财务报告。项目的核心理念是:知道钱去了哪里,就能阻止它继续流向那里。
README 明确其定位:**No AI, no cloud and privacy-friendly**——不使用 AI、不使用云,隐私友好。Firefly III 完全自托管且相互隔离,在你明确告诉它之前,永远不会联系外部服务器。
配图 1 为 Firefly III 项目 Logo(作者 Cherie Woo)。README 结尾处还说明:本 readme 完全未使用 LLM 或其他人工文本生成器撰写。
主要功能
README 列出的功能分为几层:
- 关键特性:完全自托管且隔离,不会主动连接外部服务器;提供 REST JSON API,覆盖 Firefly III 几乎每一部分。
- 最令人兴奋的功能:创建定期交易来管理资金;基于规则的事务处理,可自定义规则。
- 基础但合理的能力:复式记账系统;用储蓄罐(piggy banks)为某个目标存钱;查看收入与支出报表。
- 超出预期的能力:双因素认证(2FA)以增强安全性;支持任何你想要的货币;提供 Docker 镜像。
- 组织与呈现:清晰的视图展示财务状况、便于浏览记录的导航、大量图表。
- 更多功能见官方文档。
适用对象
README 明确说明:适合想要跟踪自身财务、又不希望把财务记录上传到云端的人(当然你仍然可以上传,只是不必如此)。它还要求你有一点技术能力、喜欢开源软件,并且不介意折腾(自托管)服务器。
安装方式概览
README 给出的运行/安装途径包括:官方 demo 站点(已预置示例账务)、在自己的服务器上安装、使用 Docker 运行、通过 Kubernetes 部署;商业选项方面有 Hostinger 一键安装(赞助选项,使用付费方案会向开发者支付小额回报);此外还有 Softaculous、AMPPS、Cloudron、Lando、Yunohost 等(非赞助,但支持项目开发)。具体命令与步骤需查阅官方文档与最新 release 页面。
生态与开发
多位用户围绕 Firefly III API 构建了工具,相关清单见官方文档。项目欢迎贡献:可在主仓库提交 issue,或通过 Gitter、Mastodon 联系;仓库中提供贡献指南(contributing guidelines)、行为准则(code of conduct)与安全策略(security policy);也欢迎帮忙修 bug、思考新功能或翻译 Firefly III。
项目背景与立场
README 提到该项目源自并在欧盟(🇳🇱)运行,并配有一面欧洲旗帜图(配图 2),文中表达了支持本地软件开发者、重视(数字)主权的立场;同时包含一段关于亿万富翁与法西斯主义者破坏民主与国际联盟的政治性表述。
赞助与支持
Firefly III 是一个副业项目。README 提供 Patreon、GitHub Sponsors、ko-fi(配图 3 为 ko-fi 的“Buy Me a Coffee”按钮图)与 Liberapay 等赞助渠道。项目由 TestMu AI 赞助(配图 4 为其标识),其支持让作者能更轻松地测试 Firefly III,并在每个版本中引入更少的 bug;Hostinger 则通过返利计划赞助项目。
许可证
本项目采用 GNU Affero General Public License v3(AGPLv3)授权。
联系方式
邮箱 [email protected];支持渠道包括 GitHub Discussions(提问与支持)、Gitter.im(即时交流)、GitHub Issues(bug 与问题)、Mastodon(新闻与更新)。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
来源 README 未给出具体的命令行安装指令,仅列出运行/安装途径与前置条件,实际命令与顺序请以官方文档(Read the docs)和最新 release 页面为准。
准备与选择路径:
- 先体验(无需安装):访问官方 demo 站点,站内已预置一份示例财务账务,可直接试用。
- 自建服务器安装:README 写明 “You can install it on your server”,即在自己的服务器上部署;需要自行准备并维护服务器环境。
步骤 3
Docker 运行:README 确认提供 Docker 镜像(“There is a Docker image”),可用 Docker 方式运行。
- Kubernetes 部署:README 列出可 “deploy via Kubernetes”。
- 面板/一键安装(第三方或商业):
- Hostinger 提供一键安装(赞助选项;若使用其付费方案,会向 Firefly III 开发者支付小额回报)。
- Softaculous、AMPPS、Cloudron、Lando、Yunohost(均非赞助,但会支持项目开发)。
首次运行要点:Firefly III 完全自托管且相互隔离,在你明确要求之前不会连接任何外部服务器,因此首次使用需要先自行完成部署并访问你自己的实例;按 README 建议,可先通过 demo 站点了解界面与功能,再决定采用哪种安装方式。
常见问题与更多细节:README 指向“Read the docs”文档获取更多功能与安装细节;问题可在 GitHub Discussions 提问,bug 通过 GitHub Issues 提交,即时交流可走 Gitter.im,新闻与更新见 Mastodon。
