Firefly III 搭建个人财务记账平台

有网友留言需要 适配移动平台可以私有化部署的记账软件,但是一直没有找到合适的国产软件。Firefly III 是国外一款开源的记账软件,提供开放的接口,支持跨平台使用和同步,所以从软件开发角度看,这是一款不错的产品,是否符合国人的使用习惯,只有亲自使用了才知道

什么是 Firefly III ?

Firefly-iii 是一个开源的记账软件,可以自主搭建个人的财务管理服务,帮助用户记录和追踪收入与开销。

老苏记账差不多经历了三个阶段:

  • 第一阶段2011 年以前,一直用 excel 记账;
  • 第二阶段2011 ~ 2013 年开始用金蝶旗下的 随手记,因为是在手机上记账,比 excel 方便多了;
  • 第三阶段2013 年以后,工资卡被老婆忽悠走了,从此老苏达到了 手中无卡,心中无账 的境界🙂

安装

数据库

通过 phpMyAdminMariaDB 10 中新建用户 firefly,创建同名的库 firefly 并授予所有权限。

安装镜像

在群晖上以 Docker 方式安装。

在注册表中搜索 firefly ,选择第二个 fireflyiii/core,版本选择 latest

第一个镜像 jc5x/firefly-iii 也是官网的,只是自 2021年7月1日 起,已经被弃用

docker 文件夹中,创建一个新文件夹,并将其命名为 firefly,然后在 firefly 中再建两个子目录 uploadexport

文件夹装载路径说明
docker/firefly/export/var/www/html/storage/export存放导出文件
docker/firefly/upload/var/www/html/storage/upload存放上传文件

端口

端口不冲突就行,不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号
本地端口容器端口
88888080

环境

可变
APP_KEY必须是 32
DB_HOST数据库地址
DB_PORT数据库端口
DB_CONNECTION数据库类型
DB_DATABASE数据库库名
DB_USERNAME数据库用户
DB_PASSWORD数据库密码

老苏群晖的 IP192.168.0.197MariaDB 10 的端口是 3307

运行

日志中看到👇下面的信息就可以开始使用了

在浏览器中输入 http://群晖IP:8888 就能看到登录界面

第一次需要注册用户

注意:密码不能少于 16 位,建议用密码生成器,使用类似 LZ8xEJ6EPToTboxm 这样的密码

登录成功后的欢迎界面

设置中文

第一件事当然是设置语言啦,在欢迎界面中

  • Bank name:老苏随便填了个 交通银行
  • Balance:应该是余额,默认是欧元,点前面的三角下箭头,找到 chinese yuan,后面填 0
  • Savings balance:储蓄卡余额,先默认没动
  • language 中下拉到底,选择 Chinese Simplified

Submit 之后就是中文界面了

老苏在移动端直接使用 Web 的效果也还可以

现在您可以开启记账之旅,创建预算,跟踪支出,通过报表了解收支情况了。

应用

接口

除了 Web 应用外,Firefly III 还具备 JSON API,提供了专门的 Swagger 文档:https://api-docs.firefly-iii.org

除非你想做基于 Firefly III 的二次开发,否则作为一般用户来说,这个没啥用处,老苏也就顺便提一下。

官方没有提供除了 Web 之外的应用,移动端都是第三方基于👆的 API 开发的,所有的移动客户端都在这里 👉 :https://docs.firefly-iii.org/firefly-iii/other-pages/3rdparty/

Android

Android 平台有 2 个,分别是 Firefly Personal FinancePhoturis III,老苏只下了 Photuris III 简单测试了一下

需要的朋友可以在后台回复 记账 即可获取下载地址

  1. Web 端获取 个人访问令牌

主页 --> 选项 --> 个人档案 --> OAuth 授权 --> 个人访问令牌 --> 创建新令牌

名称只是为了标识,方便多令牌的管理

令牌只显示一次,所以要妥善保管

  1. 登录 android 客户端

打开 app,点 PERSONAL ACCESS TOKEN

输入 服务器地址个人访问令牌后,点 SIGN IN

进入 Options --> Settings --> Language 可以改为 简体中文 界面

从界面看基本上就是高仿的 Web ,简单用了下,比较容易闪退😅

iOS

iOS 只有基于 Workflow 的快捷方式,老苏没有 iOS 设备,给个动图自己研究吧

动图地址:https://github.com/tmytro/firefly-ios-shortcuts

参考文档

firefly-iii/firefly-iii: Firefly III: a personal finances manager
地址:https://github.com/firefly-iii/firefly-iii

Firefly III - A free and open source personal finances manager
地址:https://www.firefly-iii.org/

Docker - Firefly III documentation
地址:https://docs.firefly-iii.org/firefly-iii/installation/docker/

  • 0
    点赞
  • 25
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 22
    评论
背景 最开始记账的时候使用的某著名记账应用,软件本身也算中规中矩,后来一方面因为卖用户信息的传闻闹得沸沸扬扬,一方面觉得输入太慢,也远不如 Excel 灵活,于是改用 Excel。 Excel 的好处就比较多了,输入快捷,统计方便,扩展灵活。但因为当时记得是简单的流水账,虽然可以分类统计开销之类,但各种账户之间的情况一团乱麻,最近接触到复式记账法,打算尝试下,而支持复式记账的软件可供选择的就不多了。 GnuCash 免费开源、支持 Windows、支持复式记账,相比 Excel,麻烦的就是需要记录的东西比较多(其实 Excel 也可以复式记账,不过功能实现上相对麻烦,不如专业软件省心) ,好处是你可以精确知道自己有多少钱了(或者,钱在哪了?或者,有没有钱了?或者,欠多少钱了?) 目前使用的是 GnuCash 2.6.18 版本(中文界面)。 复式记账概念 对于普通用户来说,GnuCash 涉及到大量财务方面的专业词汇,本身的汉化也不全,上手可能略有麻烦,建议使用之前简单了解一下复式记账法。 (以下说法仅供参考)因为复式记账是以公司为主体的,所以有些概念套到个人、家庭账目上会很别扭,像借记、贷记的说法也比较绕,开始可以略过,基本上了解「一切皆科目,数字在科目中流动」即可。具体来说,任何一笔账目,都会至少对应两个科目——点个外卖,「支出」会变化,如果信用卡付账,「负债」会变化,如果现金付账,「资产」会变化。至于左列、右列、加还是减这些也可以等具体记账时实践。此外的两大科目,「收入」很好理解,发工资了,「收入」和「资产」都会变化;「权益」这个概念因为也是主要针对公司的(谁出了多少本钱?),个人使用的时候,可以简单理解为最开始记账的时刻各个账户(科目)有多少钱(「所有者权益」-「期初余额」) 软件的使用 科目设置 装好软件后会首先要求设置科目层次(不清楚设置的话一路前进即可),因为后面要提到的快速补全不支持中文的问题,可以先选择「通用科目」,之后根据实际情况修改成英文或拼音,不同科目大类的设定多有不同,不熟悉复式记账的最好直接修改「通用科目」中特定或类似的科目。科目大类一般为默认的「权益」、「资产」、「负债」、「收入」、「支出」。 账目不对的时候系统会自动生成「不平衡的」科目,这是因为复式记账任何账目至少涉及两大科目而实际录入的账目不平的关系,改好账目后「不平衡的」科目金额会归零(「孤立的」科目情况类似) 存储格式 GnuCash 提供了四种存储格式,xml 格式有定期的数据备份(sqlite3 似乎没有),数据库放在云同步软件(Dropbox 或者坚果云)中就可以轻松实现多终端同步使用了。 快速录入 科目快速补全(Quickfill) 对中文用户来说有点尴尬,中文版默认创建中文科目,而该功能仅支持英文(不包括数字),所以为了使用该功能,建议使用英文(或拼音)命名所有科目。例如 Assets:Cash(ZiChan:XianJin) 可以在任意科目类单元格里使用 A:C (Z:X)快速补全(中间的冒号可以在设置「编辑-首选项-科目-分隔字符」中修改为其他符号,如填入 slash 可修改为 /) 注意,「自动提升列表」(功能编辑-首选项-账簿-动作)和科目快速补全功能有点冲突,可以关闭该功能(或者使用每次打冒号之前按下 Esc 键关闭提示列表,再用子科目的首字母补全)。 日期快速切换 在日期类单元格,可以使用 - = 切换至前一天和后一天 _ + 切换至前一周和后一周 m h 切换至本月的第一天和最后一天 y r 切换至本年的第一天和最后一天 t 切换至今天 金额简单计算 作为一款记账软件,GnuCash 在金额类单元格里提供了简单的计算功能,例如可以直接输入 30*2 这类表达式(不需要输入 = 号) 交易记忆补全 在描述单元格输入之前输入过的内容时,会出现自动补全提示,TAB 执行补全会根据匹配历史交易自动补全整个交易(包括相关科目和金额),这个功能极大的减轻了频繁发生的日常开支记账的工作量。 账簿模式 GnuCash 提供了「基本分类账」、「自动拆分分类账」和「交易日记账」三种账簿模式(「查看」菜单),新手建议一般情况下使用「基本分类账」模式方便账目录入,需要拆分交易的时候切换到「交易日记账」模式方便分割交易。另外可以通过 工具-总分类账 菜单调出「总分类账」页面,熟练的话直接在该页面记账更方便(不需要打开或者选择科目页面)。 拆分交易 因为关系到交易涉及各科目的准确记录,拆分交易这种操作就很有必要了(购买记录根据物品拆分,支出记录根据付款方式拆分等)。Gnucash 的拆分交易操作刚接触有点绕,新手建议切换至「交易日记账」模式中操作。 具体操作(根据物品拆分的情况),(「交易日记账」下),每笔交易在选中状态时至少包括四行内容: 第一行为交易描述,可以在描述单元格中填入交易梗概(因为在其他模式中无法直接看到具体分割条目的备注,所以梗概建议有一定信息量方便查阅) (之后 TAB 转入)第二行开始记录具体分割条目,首先记录资金去向,依次填入(可通过 TAB 切换)备注(物品名)、科目(消费类别)、资金收入(物品价格)、资金支出(应为空)。(之后 TAB 转入)第三行重复,直至分项物品记录完毕。 (之后 TAB 转入)最后一行记录资金来源,依次填入备注(可为空)、科目(支出账户)、资金收入(应为空)、资金支出(支出总金额),其中资金支出一栏已由系统自动计算,可与实际支出金额对照校验。 对账 对于个人用户来说,涉及存在清晰账单(银行卡、支付宝之类)的科目,对账功能比较好用。下面以具体操作说明: 选择特定科目,右键 - 对账,选择日期(如信用卡的账单日期),期末余额(信用卡的账单金额)- 确定,对账窗口会列出所有对账期间的收入和支出明细,分别全选(Crtl + A,空格),账目无误的话右下角的差额会为 0,否则表示账目与实际不符,需要手动修正(补充)具体账目或者通过「面板菜单栏-余额」自动添加条目修正,修正无误后点击「选中项对账」即可。(对账操作后,对过账的条目的第五列内容会由「未」变为「对」) 修改界面语言 在 \\gnucash\\etc\\gnucash\\environment 任意位置中添加 链接:https://www.jianshu.com/p/d04231e2c76f
评论 22
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

杨浦老苏

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值