1. 背景说明

FIrefly是一个个人财务管理工具。

2. 安装

推荐docker部署,简单方便

2.1 ubuntu服务器安装

2.1.1 基础环境安装

2.1.1.1 基础包

sudo apt install language-pack-nl-base && sudo locale-gen
sudo apt install php8.2-bcmath
sudo apt install php8.2-curl
sudo apt install php8.2-intl

2.1.1.2 composer

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

源管理

# 使用国内镜像
composer config -g repo.packagist composer https://packagist.phpcomposer.com

# 使用阿里镜像
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# 取消镜像
composer config -g --unset repos.packagist

2.1.2 Firefly III安装

2.1.2.1 下载源码

composer create-project grumpydictator/firefly-iii --no-dev --prefer-dist firefly-iii 6.0.11

2.1.2.2 配置权限

sudo chown -R www-data:www-data firefly-iii
sudo chmod -R 775 firefly-iii/storage

2.1.2.3 修改配置

.env 文件

#生成密钥
php artisan key:generate

修改时区：Asia/Shanghai
修改数据库配置：

2.1.2.4 数据库配置

create database firefly

php artisan migrate:refresh --seed
php artisan firefly-iii:upgrade-database
php artisan passport:install

2.1.2.5 nginx配置

location / {
        try_files $uri $uri/ /index.php?$query_string;
        autoindex on;
        sendfile off;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass 127.0.0.1:9001;
    }

2.2 docker服务器安装

建议采用docker-compose安装

配置文件如下

docker-compose.yml

version: '3.3'

services:
  app:
    image: fireflyiii/core:latest
    hostname: app
    container_name: firefly_iii_core
    restart: always
    volumes:
      - ./storage/export:/var/www/html/storage/export
      - ./storage/upload:/var/www/html/storage/upload
    env_file: .env
    networks:
      servernet: {}
    ports:
      - 8003:8080
networks:
  servernet:
    external: true
    name: servernet

servernet为我自定义网络，专门用于服务器网络
.env是基于官方的配置文件的修改而来，可在官网下载

3. 常见问题

3.1 本地化错误

本地系统缺少对应的语言库

#安装语言
sudo apt-get install -y language-pack-zh-hans-base
#生成本地语言
sudo locale-gen
#查看本地支持的语言，设置的语言需要在本地语言内
locale -a