Windows Docker 部署 Firefly III 开源记账软件

本文详细介绍了开源记账软件FireflyIII的部署过程,包括使用Docker容器化部署MySQL数据库以及FireflyIII本身,涉及了必要的环境变量设置和数据映射。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、简介

Firefly III是一款开源的记账软件,支持全球多种语言。它可以帮助用户追踪和管理个人账目、预算和账单,减少支出,节省更多。该软件支持多种货币、银行账户和投资账户,并提供了丰富的报表功能,帮助用户更好地了解个人财务状况。此外,Firefly III还支持使用预算、类别和标签,支持导入数据,并提供许多简洁的财务报告。

Firefly III是自我托管和开源的,意味着它是免费的,没有广告,没有跟踪。用户可以自主搭建个人的财务管理服务,并提供了开放的接口,支持跨平台使用和同步,因此不管是对于个人还是公司来说,都比较适用。如需更多关于Firefly III的信息,建议直接访问其官方网站或查阅相关用户评价和使用手册。

二、部署 DB 依赖

Firefly III 数存储在数据库中,我们这里使用的是 MySQL 数据库。打开 Docker Desktop,切换到 Linux 容器。然后在 PowerShell 执行下面命令,即可启动一个 MySQL 服务。这里安装的是 8.3.0 Tag版本,如果需要安装其他或者最新版本,可以到 Docker Hub 进行查找。

docker run -itd -p 3306:3306 `
--name mysql-8.3.0 `
--restart always -v C:\ProgramDatas\Docker\Containers\mysql-8.3.0\data:/var/lib/mysql `
-v C:\ProgramDatas\Docker\Containers\mysql-8.3.0\conf.d:/etc/mysql/conf.d `
-e MYSQL_ROOT_PASSWORD=123abcABC@! `
mysql:8.3.0

-参数 --restart always 在容器退出时总是重启容器。
-参数 -e MYSQL_ROOT_PASSWORD=123abcABC@! 是环境变量,指定了 MySQL 默认 root 用户的密码。更多环境变量信息可以访问 Environment Variables
-参数 -v C:\ProgramDatas\Docker\Containers\mysql-8.3.0\data:/var/lib/mysql 将容器内的 /var/lib/mysql 数据目录映射到物理机的 C:\ProgramDatas\Docker\Containers\mysql-8.3.0\data 目录下。
参数 -v C:\ProgramDatas\Docker\Containers\mysql-8.3.0\conf.d:/etc/mysql/conf.d 将容器内的 /etc/mysql/conf.d 配置目录映射到物理机的 C:\ProgramDatas\Docker\Containers\mysql-8.3.0\conf.d 目录下。

三、部署 Firefly III

打开 Docker Desktop,切换到 Linux 容器。然后在 PowerShell 执行下面命令,即可启动一个 Firefly III 服务。这里安装的是 6.1.13 Tag版本,如果需要安装其他或者最新版本,可以到 Docker Hub 进行查找。

docker run -d -p 8080:8080 `
--restart always `
--name fireflyiii-6.1.13 `
-v C:\ProgramDatas\Docker\Containers\fireflyiii-6.1.13\upload:/var/www/html/storage/upload `
-v C:\ProgramDatas\Docker\Containers\fireflyiii-6.1.13\export:/var/www/html/storage/export  `
-e APP_KEY=12345678901234567890123456789012 `
-e DB_HOST=host.docker.internal `
-e DB_PORT=3306 `
-e DB_CONNECTION=mysql `
-e DB_DATABASE=FireflyIII `
-e DB_USERNAME=root `
-e DB_PASSWORD=123abcABC@! `
fireflyiii/core:version-6.1.13

容器启动后,程序会检测初始化 DB。如下图 :
在这里插入图片描述

四、Web UI

打开浏览器,访问 http://localhost:8080 地址,即可看到 Firefly III 界面。第一次登录,需要初始化一个账号。
在这里插入图片描述
在这里插入图片描述

背景 最开始记账的时候使用的某著名记账应用,软件本身也算中规中矩,后来一方面因为卖用户信息的传闻闹得沸沸扬扬,一方面觉得输入太慢,也远不如 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
### 使用 Docker 部署 Firefly III #### 准备工作 确保本地环境满足部署需求,包括但不限于操作系统版本、Docker 版本以及 Docker Compose 的可用性。确认 DockerDocker Compose 已经正确安装并处于活动状态[^3]。 #### 下载配置文件与镜像 获取必要的数据库配置文件 `database.env` 可通过如下命令完成: ```bash wget https://raw.githubusercontent.com/firefly-iii/docker/main/database.env ``` 随后拉取最新的 Firefly III 官方镜像来保证使用的是最稳定的服务版本: ```bash sudo docker pull fireflyiii/core:latest ``` 此操作会从官方仓库中下载适用于 Docker 环境下的 Firefly III 应用程序实例[^1]。 #### 编辑 Docker Compose 文件 为了简化多容器应用程序的管理,在根目录下创建一个新的名为 `docker-compose.yml` 的 YAML 格式的定义文档,并按照下面模板编写: ```yaml version: '3' services: app: image: fireflyiii/core:latest ports: - "8080:80" environment: APP_KEY: ${APP_KEY} volumes: - ./data:/var/www/html/storage depends_on: - db db: image: mariadb:latest env_file: - database.env volumes: - ./mysql-data:/var/lib/mysql ``` 注意替换 `${APP_KEY}` 为实际生成的一个随机字符串作为应用密钥,长度通常推荐至少32字符以上。 #### 启动服务 当所有的前置条件都已经准备好之后,可以通过执行以下指令启动整个项目: ```bash sudo docker-compose up -d ``` 这将会以后台模式运行所有指定的服务组件,包括 Web 前端和后端 MySQL 数据库服务器[^4]。 #### 访问系统 一旦上述过程顺利完成,则可以在浏览器地址栏输入 http://localhost:8080 来打开初始页面进行初始化设置流程,比如创建管理员账户等操作。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

菜鸟厚非

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

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

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

打赏作者

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

抵扣说明:

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

余额充值