自托管Firefly III财务管理系统 Docker快速部署 NAS内网穿透远程访问

项目介绍

Firefly III 是一款功能强大的自托管个人财务管理工具。它能够帮助你全面掌控自己的收支情况，实现精细化的财务规划和预算管理。无论你想追踪日常开支、规划储蓄目标，还是分析收入支出趋势，Firefly III 都能提供直观的可视化报表和强大的数据分析能力。

这个应用采用复式记账系统，支持多币种、预算管理、分类标签、自动化规则、定期交易、目标储蓄等丰富功能。最重要的是，你的所有财务数据完全掌握在自己手中，不会上传到任何云端服务器，隐私和安全性得到充分保障。Firefly III 还提供了功能完整的 REST API，方便与其他工具进行集成。

项目地址：点我跳转

部署安装

若要在外网也能访问你的财务管理系统，建议配置内网穿透工具。推荐使用帕斯内网穿透，先注册账号备用。具体操作步骤可以参考这份详细的上手指南，能帮助你快速掌握跨平台穿透技巧。

Firefly III 提供了开箱即用的 Docker Compose 配置，让部署变得极其简单。

使用 Docker Compose 快速部署

复制下列配置文件，保存为 `docker-compose.yml`：

1version: '3.3'
2services:
3  firefly_iii_mysql:
4    image: mysql:8.0
5    hostname: firefly_iii_mysql
6    environment:
7      MYSQL_RANDOM_ROOT_PASSWORD: 'yes'
8      MYSQL_DATABASE: firefly
9      MYSQL_USER: firefly
10      MYSQL_PASSWORD: your_secure_password
11    volumes:
12      - firefly_iii_mysql:/var/lib/mysql
13    ports:
14      - "3306:3306"
15
16  firefly_iii_app:
17    image: fireflyiii/core:latest
18    hostname: firefly_iii_app
19    environment:
20      DB_HOST: firefly_iii_mysql
21      DB_PORT: 3306
22      DB_CONNECTION: mysql
23      DB_DATABASE: firefly
24      DB_USERNAME: firefly
25      DB_PASSWORD: your_secure_password
26      APP_KEY: base64:your_app_key_here
27      APP_URL: http://localhost
28      TRUSTED_PROXIES: '**'
29    ports:
30      - "8080:8080"
31    depends_on:
32      - firefly_iii_mysql
33    volumes:
34      - firefly_iii_upload:/var/www/html/storage/upload
35
36volumes:
37  firefly_iii_mysql:
38  firefly_iii_upload:

打开你的 NAS 设备或服务器的 Docker 管理界面，找到 Docker Compose 或容器编排功能。

关键配置说明：

需要修改的部分是数据库密码，请将上面配置中的 `your_secure_password` 替换成你自己的强密码。`APP_KEY` 需要生成一个 base64 编码的密钥，可以在 Linux 环境中使用 `openssl rand -base64 32` 生成。

端口映射：

数据库端口：`3306`（MySQL 内部端口）

应用端口：`8080`（Firefly III 应用访问端口）

如果这些端口在你的系统上已被占用，可以修改冒号前面的数字。例如想改为 8081 访问，可改为 `'8081:8080'`。但容器内的端口（冒号后面的数字）需要保持不变。

存储卷说明：

`firefly_iii_mysql`：存储数据库文件，确保财务数据持久化

`firefly_iii_upload`：存储用户上传的附件和文件

配置完成后，在 NAS 或服务器上执行：

1docker-compose up -d

稍等片刻让容器启动完成。

环境变量设置：

必须设置：

`DB_PASSWORD`：数据库密码（重要！）

`APP_KEY`：应用密钥（base64 编码）

`APP_URL`：应用访问地址

可选设置：

`APP_DEBUG`：调试模式（true/false，默认 false）

`MAIL_DRIVER`：邮件驱动（用于发送通知）

`MAIL_HOST`、`MAIL_PORT`、`MAIL_USERNAME`、`MAIL_PASSWORD`：邮件服务器配置

其他配置项保持默认即可。

部署成功后，在浏览器中访问 `http://你的服务器IP:8080`，就能看到 Firefly III 的登录界面。首次访问会引导你完成初始化设置，包括创建管理员账户。

到这里，你的个人财务管理系统就已经完全部署好了，可以开始记录和分析你的财务数据了。

本篇教程结束