前言

Firefly III 是一款功能强大的开源个人财务管理工具，可以帮助用户追踪收入、支出、预算和资产。对于想要更好管理个人财务的技术爱好者来说，Firefly III 提供了一个完美的解决方案。本文将指导零基础用户如何在 Ciuic服务器 上部署 Firefly III 系统。

准备工作

在开始之前，您需要准备以下内容：

一台运行 Linux 的服务器（推荐使用 Ubuntu 20.04 LTS）基本的命令行操作知识域名（可选，但推荐）

如果您还没有服务器，可以考虑使用 Ciuic云服务器，它提供了稳定可靠的云计算服务，非常适合部署个人项目。

安装依赖环境

Firefly III 需要以下组件才能正常运行：

PHP 7.4 或更高版本MySQL/MariaDB 数据库Nginx/Apache 网页服务器Composer (PHP 依赖管理工具)

1. 更新系统

首先登录您的服务器，更新系统软件包：

sudo apt update && sudo apt upgrade -y

2. 安装必要的软件包

sudo apt install -y software-properties-commonsudo add-apt-repository ppa:ondrej/php -ysudo apt updatesudo apt install -y php8.1 php8.1-common php8.1-mysql php81-mbstring php8.1-xml php8.1-curl php8.1-gd php8.1-zip php8.1-bcmath php8.1-intl php8.1-fpm php8.1-sqlite3 mariadb-server nginx git unzip

3. 安装 Composer

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

配置数据库

登录 MariaDB：

sudo mysql -u root

创建 Firefly III 数据库和用户：

CREATE DATABASE firefly;CREATE USER 'firefly'@'localhost' IDENTIFIED BY '设置一个强密码';GRANT ALL PRIVILEGES ON firefly.* TO 'firefly'@'localhost';FLUSH PRIVILEGES;EXIT;

安装 Firefly III

1. 下载 Firefly III

cd /var/wwwsudo git clone https://github.com/firefly-iii/firefly-iii.gitsudo chown -R www-data:www-data firefly-iiicd firefly-iii

2. 安装 PHP 依赖

sudo -u www-data composer install --no-dev --prefer-dist

3. 配置环境变量

复制示例配置文件：

cp .env.example .env

编辑 .env 文件，设置数据库连接信息和其他必要配置：

sudo nano .env

主要需要修改以下部分：

APP_URL=http://您的域名或IPDB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=fireflyDB_USERNAME=fireflyDB_PASSWORD=您之前设置的密码

4. 生成应用密钥

sudo -u www-data php artisan key:generatesudo -u www-data php artisan migrate --seedsudo -u www-data php artisan firefly-iii:upgrade-database

配置 Nginx

创建 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/firefly-iii

添加以下内容：

server {    listen 80;    server_name 您的域名或IP;    root /var/www/firefly-iii/public;    index index.php index.html;    location / {        try_files $uri $uri/ /index.php?$query_string;    }    location ~ \.php$ {        include snippets/fastcgi-php.conf;        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;    }    location ~ /\.ht {        deny all;    }}

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/firefly-iii /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl restart nginx

设置定时任务

Firefly III 需要定时任务来执行一些后台操作：

sudo crontab -u www-data -e

添加以下内容：

* * * * * cd /var/www/firefly-iii && php artisan schedule:run >> /dev/null 2>&1

完成安装

现在，您可以通过浏览器访问服务器的 IP 地址或域名来使用 Firefly III 了。首次访问时，系统会提示您创建管理员账户。

安全建议

考虑设置 SSL 证书（可以使用 Let's Encrypt 免费证书）定期备份数据库限制访问 IP 或设置基本身份验证

通过以上步骤，您已经在 Ciuic云服务器 上成功部署了 Firefly III 个人财务管理系统。现在您可以开始记录和管理您的财务数据了。Firefly III 提供了丰富的功能，包括预算管理、账单管理、报表生成等，帮助您更好地了解和控制个人财务状况。

如果您在部署过程中遇到任何问题，可以参考 Firefly III 的官方文档或社区论坛寻求帮助。对于服务器需求，Ciuic云服务 提供了稳定可靠的基础设施，是托管个人项目的理想选择。