【Docker应用】使用Docker部署个人财务管理系统Firefly III

作为一名长期关注个人财务管理的技术爱好者，最近我在自己的绿联NAS上成功部署了Firefly III——一个功能强大的开源个人财务管理系统。今天就来分享我的Docker部署经验，帮助大家快速搭建属于自己的财务管理平台。

一、为什么选择Firefly III？

Firefly III不仅提供了完整的账户管理、预算规划、账单跟踪等功能，还支持多币种交易和丰富的财务报表。通过Docker部署，我们可以在任何支持Docker的环境中获得一致的运行体验，极大简化了安装和维护流程。

二、准备工作

在开始部署前，请确保你的系统已经安装Docker和Docker Compose。我使用的是绿联NAS，需要通过SSH连接到设备进行操作。

三、部署步骤

1. 下载配置文件

首先，我们需要准备三个核心文件：

• Docker Compose文件 ：从官方仓库下载，定义服务的完整配置。下载命令为：wget -O docker-compose.yml https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/docker/compose/docker-compose.yml
• Firefly III配置文件 （.env）：包含应用运行参数 。下载链接为：https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/.env.example，如果失效，可以从官方文档获取。保存为 .env。
• 数据库配置文件 （.db.env）：设置数据库连接信息。下载链接为：https://raw.githubusercontent.com/firefly-iii/docker/main/database.env，如果失效，可以从官方文档获取。保存为 .db.env。

2. 关键配置修改

• 修改 .env文件中的 DB_PASSWORD值
• 修改 .db.env文件中的 MYSQL_PASSWORD值
• 确保两个密码完全一致

3. 启动服务

在配置文件所在目录执行以下命令：

docker compose -f docker-compose.yml up -d --pull=always

参数说明：

• -d：后台运行
• --pull=always：总是拉取最新镜像

【可选】如果启动时遇到端口冲突（默认使用80端口），需要修改Docker Compose文件中 app:ports的配置，将 80:8080改为 [闲置端口]:8080。

【可选】如果需要查看实时日志确认运行状态，使用命令：docker compose -f docker-compose.yml logs -f

4. 访问应用

部署完成后，在浏览器中访问 http://[设备IP]:[配置的端口]即可进入Firefly III的初始化页面。

四、初次使用指南

首次访问时，需要注册一个管理员账户。注册完成后，我建议按照官方教程完成以下基础设置：

1. 创建账户 ：添加银行账户、现金账户等
2. 设置预算 ：为不同消费类别设置预算上限
3. 录入交易 ：开始记录日常收支

五、注意事项

• 数据备份 ：定期备份Docker卷中的数据，防止意外丢失
• 版本更新 ：使用 --pull=always参数可以确保每次启动都使用最新版本
• 性能优化 ：如果运行在资源有限的设备上，可以考虑调整数据库配置

六、结语

如果你在部署过程中遇到任何问题，可以参考Firefly III的官方文档或在社区中寻求帮助。希望这篇指南能够帮助你顺利开启个人财务管理的新篇章！

部署环境：绿联NAS + Docker
Firefly III版本：最新稳定版

七、参考链接

https://docs.firefly-iii.org/how-to/firefly-iii/installation/docker/#start-the-container

本文为博主原创教程，遵循 CC BY-NC-SA 4.0 共享协议。欢迎任何个人及非商业性转载，但必须注明原文出处。