部署 Firefly III 最推荐的方式是使用 Docker Compose,它非常高效且易于维护。以 v6.1.12 版本为例,完整的安装和配置过程如下。
请注意:Firefly III 的新版本(如 v6.5+)要求 PHP 8.5 或更高版本。虽然 v6.1.12 的官方文档仍建议使用 PHP 8.5,但在旧版 PHP 上运行可能会遇到问题。如果你不确定 PHP 环境,强烈建议使用 Docker 方式安装,以避免环境兼容性问题。
🔧 系统要求与准备工作
无论是哪种安装方式,都需要先确保环境满足以下要求:
- 服务器:一台运行 Linux(如 Ubuntu、Debian)、Windows 或 macOS 的机器。
- 软件:
- Docker 方式:需要安装 Docker 和 Docker Compose。
- 手动方式:需要预先配置好 LAMP、LEMP 或 WAMP 环境,并确保 PHP 版本满足要求。
- 数据库:MySQL、MariaDB、PostgreSQL 或 SQLite 均可。Firefly III 会自动创建所需的数据库表结构。
- 网络:服务器需要能够正常访问互联网,以下载镜像和依赖。
🚀 安装步骤
以下是两种主流安装方法的详细步骤,你可以根据自己的需求和技术背景选择。
方法一:使用 Docker Compose 安装(推荐)
这是最简便、最推荐的安装方式。
创建项目目录:在服务器上创建一个专用目录,并进入该目录。
mkdir~/firefly-iiicd~/firefly-iii下载必要文件:使用
curl命令下载官方提供的 Docker Compose 文件和两个配置文件(环境变量文件)。curl-Ohttps://raw.githubusercontent.com/firefly-iii/docker/main/docker-compose.ymlcurl-Ohttps://raw.githubusercontent.com/firefly-iii/firefly-iii/main/.env.examplecurl-Ohttps://raw.githubusercontent.com/firefly-iii/docker/main/database.env重命名配置文件