使用 Docker Compose 部署 Firefly III

🧱 一、准备工作

确保你系统中已安装以下组件（你之前应该已经装好）：

docker -v
docker compose version

📁 二、创建项目目录并准备配置

mkdir -p ~/firefly
cd ~/firefly

新建 docker-compose.yml 文件：

version: '3.5'

services:
  fireflyiii:
    image: fireflyiii/core:latest
    container_name: fireflyiii
    restart: unless-stopped
    ports:
      - 8080:8080
    environment:
      APP_KEY: base64:YOUR_RANDOM_KEY_HERE
      DB_HOST: db
      DB_PORT: 3306
      DB_CONNECTION: mysql
      DB_DATABASE: firefly
      DB_USERNAME: firefly
      DB_PASSWORD: fireflypassword
      TRUSTED_PROXIES: '**'
      APP_URL: http://your-server-ip:8080
    depends_on:
      - db

  db:
    image: mariadb:10.6
    container_name: firefly_db
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: firefly
      MYSQL_USER: firefly
      MYSQL_PASSWORD: fireflypassword
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - ./mysql:/var/lib/mysql

🔐 三、生成随机 APP_KEY

你可以在终端生成 APP_KEY，用于环境变量：

openssl rand -base64 32

结果形如 Y2F0cy1hcmUtd2lsZC0xMjM0NTY=

加上前缀 base64:，填入上面的 APP_KEY 位置。

🚀 四、启动容器

docker compose up -d

首次启动会自动安装依赖并初始化数据库，访问地址是：

http://你的服务器IP:8080

🛠️ 五、初始化 Firefly III

打开网页后，会提示你创建第一个用户（管理员）
设置密码后即可登录 Firefly III Web 管理界面
可进入设置页面创建 API Token，给安卓 App 用
后续可配置中文、分类、资产、预算、报表等

🧽 六、中文设置（可选）

进入 Web 后台：

设置（Settings）→ 用户（User）→ 语言（Language）选择中文

✅ 七、常用操作

查看日志：

docker compose logs -f fireflyiii

重启服务：

docker compose restart

停止服务：

docker compose down

✅ 八、下一步建议

✔ 设置 nginx + HTTPS 域名访问（建议）
✔ 安装安卓 App（Firefly III Mobile）
✔ 设置账本、账户、自动化脚本导入微信账单等

发送评论编辑评论