cioraneanu/firefly-pico

Firefly Pico Docker镜像文档

镜像概述

本镜像为Firefly III的官方配套应用Pico提供Docker化部署支持。Pico是一款轻量级Web应用，作为Firefly III（个人财务管理系统）的辅助工具，旨在通过简洁直观的界面简化交易记录与跟踪流程，提升财务管理效率。

核心功能与特性

• Firefly III无缝集成：通过API与Firefly III实例深度对接，实现交易数据实时同步
• 简化交易录入：提供轻量化Web界面，减少交易记录操作步骤，降低使用门槛
• 轻量级设计：资源占用低，部署便捷，适合个人服务器、家庭NAS等多种环境
• 专注核心需求：聚焦交易跟踪核心功能，界面简洁直观，提升日常使用体验

使用场景与适用范围

• Firefly III用户辅助工具：为已使用Firefly III的用户提供更便捷的交易记录入口
• 个人财务管理场景：适用于需要快速记录日常收支、管理个人账户的个人用户
• 高频交易记录：简化频繁交易（如日常消费、报销等）的录入流程
• 多设备访问支持：通过Web界面实现跨设备访问，方便随时记录交易

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name firefly-pico \
  -p 3000:3000 \
  -e FFIII_URL="https://your-firefly-instance.com" \
  -e FFIII_TOKEN="your-firefly-api-token" \
  cioraneanu/firefly-pico:latest

Docker Compose部署

创建docker-compose.yml文件进行编排部署：

yaml
version: '3'
services:
  firefly-pico:
    image: cioraneanu/firefly-pico:latest
    container_name: firefly-pico
    ports:
      - "3000:3000"  # 宿主机端口:容器端口
    environment:
      - FFIII_URL=https://your-firefly-instance.com  # Firefly III实例完整URL（需包含http/https）
      - FFIII_TOKEN=your-firefly-api-token  # Firefly III个人访问令牌
      - PORT=3000  # 容器内部应用运行端口（默认3000）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

配置参数

参考链接

• 项目源码：https://github.com/cioraneanu/firefly-pico
• Firefly III官方网站：[***]