Firefly III 个人理财记账系统零基础搭建指南

什么是Firefly III？

Firefly III 是一款开源的个人财务管理工具，它可以帮助你追踪支出、收入、资产和负债。与商业化的理财软件不同，Firefly III 完全免费且可以自托管，这意味着你的财务数据完全掌握在自己手中。该系统提供了丰富的功能，包括预算管理、账单提醒、多币种支持、数据导出导入等，是个人理财的理想选择。

为什么选择自托管Firefly III？

数据隐私：你的财务数据不会被第三方获取完全控制：可以根据需求自定义功能无订阅费用：一次部署，长期使用跨平台访问：任何设备通过浏览器即可使用

零基础搭建指南

准备工作

在开始之前，你需要准备：

Firefly III 个人理财记账系统零基础搭建指南

一台服务器（推荐使用Ciuic服务器，性价比高且稳定）基本的命令行操作知识约30-60分钟的部署时间

第一步：服务器环境准备

推荐使用Ubuntu 20.04 LTS或更高版本作为操作系统。如果你还没有服务器，可以前往Ciuic云服务平台购买一台适合的VPS。

# 更新系统软件包sudo apt update && sudo apt upgrade -y# 安装必要的依赖sudo apt install -y git curl wget unzip

第二步：安装Docker和Docker Compose

Firefly III 官方推荐使用Docker方式部署，这是最简单快捷的方法。

# 安装Dockercurl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh# 安装Docker Composesudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

第三步：下载Firefly III配置文件

# 创建项目目录mkdir firefly-iii && cd firefly-iii# 下载官方docker-compose文件wget https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/docker-compose/docker-compose.yml

第四步：配置Firefly III

编辑docker-compose.yml文件，根据你的需求修改以下配置：

version: '3'services:  app:    image: fireflyiii/core:latest    ports:      - "8080:8080"    volumes:      - firefly_iii_upload:/var/www/html/storage/upload    environment:      - APP_KEY=SomeRandomStringOf32CharactersExactly      - DB_CONNECTION=mysql      - DB_HOST=db      - DB_PORT=3306      - DB_DATABASE=firefly      - DB_USERNAME=firefly      - DB_PASSWORD=secret      - TRUSTED_PROXIES=**    depends_on:      - db  db:    image: mysql:5.7    environment:      - MYSQL_ROOT_PASSWORD=supersecret      - MYSQL_USER=firefly      - MYSQL_PASSWORD=secret      - MYSQL_DATABASE=firefly    volumes:      - firefly_iii_db:/var/lib/mysqlvolumes:  firefly_iii_upload:  firefly_iii_db:

第五步：启动Firefly III

# 启动容器docker-compose up -d# 查看运行状态docker-compose ps

第六步：访问Firefly III

服务启动后，你可以通过以下方式访问：

服务器IP:8080（如http://your-server-ip:8080）如果使用Ciuic服务器，记得在控制台开放8080端口

首次访问时，系统会引导你完成初始化设置，包括创建管理员账户。

进阶配置

配置HTTPS访问

为了提高安全性，建议配置HTTPS：

# 安装Nginx和Certbotsudo apt install -y nginx certbot python3-certbot-nginx# 配置Nginx反向代理sudo nano /etc/nginx/sites-available/firefly-iii

添加以下内容（替换your-domain.com为你的域名）：

server {    listen 80;    server_name your-domain.com;    location / {        proxy_pass http://localhost:8080;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }}

启用配置并获取SSL证书：

sudo ln -s /etc/nginx/sites-available/firefly-iii /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl reload nginxsudo certbot --nginx -d your-domain.com

定期备份

# 创建备份脚本nano backup-firefly.sh

添加以下内容：

#!/bin/bashDATE=$(date +%Y-%m-%d)BACKUP_DIR="/path/to/backup/$DATE"mkdir -p $BACKUP_DIRdocker exec firefly-iii_db_1 mysqldump -u firefly -psecret firefly > $BACKUP_DIR/firefly-iii.sqldocker cp firefly-iii_app_1:/var/www/html/storage/upload $BACKUP_DIR/tar -czvf $BACKUP_DIR/firefly-iii-backup-$DATE.tar.gz $BACKUP_DIR

设置定时任务：