Ghostfolio 3.90.0 介绍与选型指南

开源财富管理系统 Ghostfolio 3.90.0 介绍与选型：NestJS+Angular 架构、功能特性、与 Firefly III/Actual 量化对比及 Ghostfolio Premium 边界（2026-10-23 实查）

Ghostfolio财务记账自托管2026/10/23

Ghostfolio 3.90.0 介绍与选型指南

目标：讲清 Ghostfolio——开源财富管理（Wealth Management）与投资组合追踪系统的定位、架构、功能与自托管选型边界，并与 Firefly III、Actual 做量化对比。信息溯源自官方仓库与官网（查询日期 2026-10-23），版本与星数均为实查值。

一、环境信息（信息源与查询口径）

  • 产品：Ghostfolio（ghostfolio/ghostfolio），官网 ghostfol.io
  • 版本：3.90.0（2026-10-21 发布，GitHub Releases 实查；查询日期 2026-10-23）
  • 许可：AGPL-3.0（仓库 LICENSE 实查）
  • 星数：9.6k（shields.io 实时徽章实查，2026-10-23）
  • 对比对象版本：Firefly III v6.7.9（25k stars）、Actual v26.10.0（30k stars），均为 2026-10-23 实查
  • 技术栈溯源：仓库 package.json（Node engines >=22.23.4、Prisma 7.10.0）与 README「Technology Stack」节

二、软件概述

Ghostfolio 自我定位是 Open Source Wealth Management Software（官方 README 原文）：面向「忙碌的个人」追踪股票、ETF 与加密货币持仓，用数据驱动投资决策，为个人长期连续运行设计（README 原文 "designed for personal use in continuous operation"）。官方给的用户画像是：多平台交易者（多券商/银行）、buy & hold 策略践行者、关注组合构成洞察、重视隐私与数据所有权、拒绝电子表格的用户。

一句话划界：Ghostfolio 管「投资组合」，不管「日常记账」——它不做收支流水与预算（那是 Firefly III/Actual 的领地），而做持仓、成本、分红与组合绩效（ROAI、时间加权收益）的持续追踪。

商业模式：官方同时运营 Ghostfolio Premium 云托管服务（订阅制），收入用于基础设施、专业数据提供方与开发投入；自托管社区版完全免费且含全部核心功能（详见八、）。

三、核心架构

官方 README「Technology Stack」节 + 仓库结构实查（查询日期 2026-10-23）：

  • 语言与工程：TypeScript 全栈，Nx monorepo 工作区（apps/api 后端、apps/client 前端、libs/common 共享类型）；
  • 后端：NestJS（Express 之上的结构化 Node 框架），REST API 前缀 /api/v1（部分新路由 /api/v2）；
  • 数据库：PostgreSQL（唯一持久层），ORM 用 Prisma 7.10.0，schema 与迁移全由 Prisma 管理；
  • 缓存：Redis（行情报价缓存、后台任务）；
  • 前端：Angular + Angular Material，工具类用 Bootstrap，PWA 移动优先设计（无原生 App，装到主屏即用）；
  • 行情数据：可插拔数据提供方——YAHOO（默认免费）、COINGECKO（加密货币，凭 API Key）、MANUAL（自建资产）、GHOSTFOLIO（Premium 专业数据源）；官方 FAQ 明确「暂不计划扩充核心数据源，其余均实验性」；
  • 部署形态：官方多架构 Docker 镜像（amd64/arm64/arm-v7）+ docker-compose 三服务栈（app + PostgreSQL + Redis），亦可源码构建 + systemd 裸机运行；
  • 实验性前沿：ENABLE_FEATURE_MCP 可在 /mcp 暴露 Model Context Protocol 服务器（AI 助手接入点），3.90.0 迁移记录中已有 MCP 权限域变更，属活跃演进方向。

依赖链全景：Angular SPA → NestJS API → PostgreSQL（账户/活动/资产档案/市场数据）+ Redis（缓存）→ 外部行情源（YAHOO 等）。

四、功能特性

官方 README Features 清单实查（查询日期 2026-10-23）：

  • 交易活动的创建、更新与删除（BUY/SELL/DIVIDEND 等类型）；
  • 多账户管理（多券商/银行账户分组，平台 Platform 概念聚合同一机构账户）；
  • 组合绩效：平均投入回报 ROAI 含分红（总回报），时间维度 Today/WTD/MTD/YTD/1Y/5Y/Max；
  • 多种图表（趋势、配置、行业/国家敞口）；
  • 静态分析识别组合潜在风险（集中度等）；
  • 活动导入与导出（CSV/JSON，官方格式同构可回灌）；
  • 暗色模式、Zen Mode；
  • PWA 移动优先（可安装到手机主屏）。

衍生能力（版本演进实查）：多币种与自动汇率、标签与观察名单、分享页（只读分享组合快照）、OIDC/Passkey 登录、访问令牌登录（128 位令牌即密码）、管理面板（Admin Control：市场数据、平台、标签、用户管理）。

五、快速开始（最小可用示例）

官方 README「Run with Docker Compose」路线的最小落地（三行命令级别；逐步展开与数据导入/备份闭环实测见《Ghostfolio 3.90.0 Docker Compose 部署指南》）：

git clone https://github.com/ghostfolio/ghostfolio.git
cd ghostfolio && cp docker/.env.example .env   # 填 POSTGRES_*/JWT_SECRET_KEY/ACCESS_TOKEN_SALT 等
docker compose -f docker/docker-compose.yml up -d

验证与首次使用：浏览器打开 http://<服务器IP>:3333/ 注册（首个用户自动管理员，领取 128 位访问令牌），导入 CSV 交易记录即完成初始化。API 视角的一分钟上手（注册换令牌 → 建自建资产 → 导活动 → 查绩效）逐条实测见《Ghostfolio 3.90.0 API 使用详解》。

非 Docker 路线：Node 22 + PostgreSQL + Redis 依赖链的源码构建与 systemd 托管全流程实测见《Ubuntu 22.04 安装 Ghostfolio 3.90.0 指南》。

六、适用场景与限制

适合：

  • 个人/家庭长期追踪跨券商、跨币种（含加密货币）的投资组合，重视数据自持；
  • buy & hold 长线视角的收益（含分红总回报）、配置与风险分析；
  • 隐私优先：部署在自己的服务器/家庭 NAS，数据不出门；
  • 需要把组合以只读分享页/快照展示给他人的场景。

限制（自托管视角，官方 FAQ/README 实查）：

  • 不做日常记账与预算：无收支流水、复式记账、信封预算——这些需求应选 Firefly III/Actual；
  • 行情源依赖外部：免费层走 Yahoo Finance，受限网络会遇符号解析失败（官方支持源就四种，不计划扩充）；受限网络可用自建资产（MANUAL）兜底；
  • 单机单租户定位：为个人连续运行设计，不是多人 SaaS（可注册多用户但产品语义是个人/家庭）；
  • 无原生移动端：PWA 形态；
  • 升级节奏极快：九天连发五个 minor 版本（3.86→3.90，2026-10-12~21 实查），跟随升级需习惯数据库迁移自动执行，生产要固定版本号并先备份。

七、同类选型对比

7.1 量化对比表

三款均为主流开源自托管财务类应用（数据实查日期 2026-10-23；星数来自 shields.io 实时徽章，版本来自 GitHub Releases）：

维度Ghostfolio 3.90.0Firefly III v6.7.9Actual v26.10.0
定位投资组合/财富管理个人记账（复式流水）个人预算（local-first）
GitHub stars9.6k25k30k
许可证AGPL-3.0AGPL-3.0MIT
技术栈TS：NestJS + AngularPHP：Laravel 13（要求 PHP ≥8.5）TS：React + Node
数据库PostgreSQL + RedisMySQL/MariaDB 或 PostgreSQLSQLite（内嵌）+ 同步服务器
最新版本节奏3.86→3.90（9 天 5 版，2026-10）v6.7.9 稳定维护v26.10.0（按月版本号，2026-10）
运行依赖重量中（3 服务：app+PG+Redis）中（PHP+DB）轻（单服务+SQLite）
核心交付持仓/ROAI/分红/敞口分析银行流水、规则引擎、报表信封预算、零基预算、多端同步

解读：三者数据库与运行依赖差异直接决定部署形态——Ghostfolio 必须带 PostgreSQL+Redis（依赖链最重），Actual 用内嵌 SQLite 最轻。星数差异（30k/25k vs 9.6k）反映记账类工具的大众需求基数更大，投资组合赛道本身较垂直；Ghostfolio 发布节奏（9 天 5 版）是三者中最激进的。

7.2 Firefly III：记账定位差异（同域不同赛道）

Firefly III 是「银行账户流水与复式记账」工具：导入银行对账单、自动分类规则引擎、支出/收入报表、预算额度。它与 Ghostfolio 常被并列提及但几乎不重叠：

  • Firefly III 记「钱花在哪、结余多少」；Ghostfolio 答「资产组合表现如何、该往哪调」；
  • 交易模型不同：Firefly III 是 withdraw/deposit/transfer 流水模型，Ghostfolio 是 buy/sell/dividend 持仓活动模型（含数量、单价、费率）；
  • 两者可并存：日常开支给 Firefly III 或 Actual，投资持仓给 Ghostfolio。

7.3 Actual：预算优先的 local-first 路线

Actual 主打信封式/零基预算与本地优先数据（SQLite 本地存储 + 自托管同步服务器多端同步），强项是「计划花销、约束执行」。它不追踪证券持仓与市场行情，无投资绩效概念；换来的是极轻的部署与离线可用。若诉求是「管住消费」，Actual 最合适；「看清投资」，Ghostfolio 对口。

7.4 Ghostfolio Premium 边界（自托管免费层与付费差异）

官方自托管 FAQ 实查（查询日期 2026-10-23）+ 本批实测：

  • 自托管社区版：全部核心功能可用（组合分析、导入导出、多账户、管理面板），数据源 YAHOO/MANUAL/COINGECKO 免费；
  • Premium（订阅）：提供官方云托管 + 专业数据源 GHOSTFOLIO（凭 API Key 接入，README 原文 "access to a professional data provider (GHOSTFOLIO) is included with a Ghostfolio Premium subscription via an API key"）；
  • 实测佐证：自托管 ADMIN 用户调 POST /api/v1/api-keys 返回 403（createApiKey 权限不含在自托管权限矩阵），见《Ghostfolio 3.90.0 API 使用详解》第八章——API Key 即 Premium 数据源入口；
  • 选型建议：数据自持 + Yahoo 源够用 → 自托管免费层；需要专业级行情质量与官方托管 → Premium；只要预算/记账 → 换 Firefly III/Actual。

7.5 社区与生态活跃度

  • 社区渠道：Slack 官方群、GitHub Issues/PR 活跃（九天五版的迭代速度侧面印证维护强度）；
  • 自托管生态：官方 FAQ 记载社区已适配 CasaOS、Easypanel、Home Assistant、Runtipi、TrueCharts、Umbrel、Unraid 等家庭服务器系统（实查 2026-10-23），Docker Hub 多架构镜像覆盖 NAS 常见架构（amd64/arm64/arm-v7）；
  • 文档质量：README 完整（环境变量表、Compose 步骤、FAQ 内置在仓库），ghostfol.io 有 Demo 环境可在线试用。

八、参考链接