ghostfolio下载 - ghostfolio源代码下载

ghostfolio

其他源码

2.130.0

下载

Ghostfolio

开源财富管理软件

ghostfol.io |现场演示| GhostFolio Premium |常见问题解答|博客|松弛| x

GhostFolio是使用Web技术构建的开源财富管理软件。该应用程序使忙碌的人能够跟踪股票，ETF或加密货币，并做出坚实的数据驱动投资决策。该软件设计用于连续操作的个人使用。

Ghostfolio视频预告片的预览图像

GhostFolio Premium

我们官方的GhostFolio Premium Cloud产品是最简单的入门方式。由于节省的时间，对于大多数人来说，这将是最佳选择。收入用于支付托管基础设施的成本并为持续发展提供资金。

如果您希望在自己的基础架构上运行GhostFolio，请在自托管部分中找到更多说明。

为什么是GhostFolio？

如果您是...

多个平台上的交易股票，ETF或加密货币
？追求买卖策略
有兴趣了解您的投资组合组成
？重视隐私和数据所有权
？变成极简主义
？关心您的财务资源多样化
？对财务独立感兴趣
？对电子表格说不
？仍在阅读此列表

特征

✅创建，更新和删除交易
✅多帐户管理
✅投资组合绩效： Today的时间加权率（TWR）， WTD ， MTD ， YTD ， 1Y ， 5Y ， Max
✅各种图表
✅静态分析以确定投资组合中的潜在风险
✅进出口交易
✅黑暗模式
✅禅模式
✅具有移动优先设计的渐进式网络应用程序（PWA）

技术堆栈

GhostFolio是用打字稿编写的现代Web应用程序，并作为NX工作区组织。

后端

后端基于Nestjs使用PostgreSQL作为数据库，以及用于缓存的Prisma和Redis。

前端

前端是用角度构建的，并使用Bootstrap带有实用类别的角材料。

自我托管

我们为linux/amd64 ， linux/arm/v7和linux/arm64提供了托管在Docker Hub上的官方容器图像。

给我买一个咖啡按钮

支持的环境变量

姓名	类型	默认值	描述
`ACCESS_TOKEN_SALT`	`string`		一个随机字符串用作盐的访问令牌
`API_KEY_COINGECKO_DEMO`	`string` （可选）		Coingecko演示API键
`API_KEY_COINGECKO_PRO`	`string` （可选）		Coingecko Pro API密钥
`DATABASE_URL`	`string`		数据库连接URL，例如`postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:5432/${POSTGRES_DB}?sslmode=prefer`
`HOST`	`string` （可选）	`0.0.0.0`	GhostFolio应用程序将在哪里运行的主机
`JWT_SECRET_KEY`	`string`		用于JSON Web令牌（JWT）的随机字符串
`LOG_LEVELS`	`string[]` （可选）		GhostFolio应用程序的日志记录级别，例如`["debug","error","log","warn"]`
`PORT`	`number` （可选）	`3333`	GhostFolio应用程序将在
`POSTGRES_DB`	`string`		PostgreSQL数据库的名称
`POSTGRES_PASSWORD`	`string`		PostgreSQL数据库的密码
`POSTGRES_USER`	`string`		PostgreSQL数据库的用户
`REDIS_DB`	`number` （可选）	`0`	REDIS的数据库索引
`REDIS_HOST`	`string`		REDIS正在运行的主机
`REDIS_PASSWORD`	`string`		REDIS的密码
`REDIS_PORT`	`number`		REDIS正在运行的端口
`REQUEST_TIMEOUT`	`number` （可选）	`2000`	网络请求向数据提供商以毫秒为单位

与Docker合作一起运行

先决条件

Docker的基本知识
Docker的安装
创建此GIT存储库的本地副本（Clone）
将文件.env.example复制到.env并用数据填充（ cp .env.example .env ）

一个。运行环境

运行以下命令从Docker Hub启动Docker Images：

docker compose --env-file ./.env -f docker/docker-compose.yml up -d

b。构建和运行环境

运行以下命令以构建并启动Docker映像：

docker compose --env-file ./.env -f docker/docker-compose.build.yml build
docker compose --env-file ./.env -f docker/docker-compose.build.yml up -d

设置

打开http：// localhost：3333在您的浏览器中
通过启动创建新用户（第一个用户将获得角色ADMIN ）

升级版本

增加docker/docker-compose.yml中ghostfolio/ghostfolio Docker图像的版本
运行以下命令以启动新的docker映像： docker compose --env-file ./.env -f docker/docker-compose.yml up -d
在每个开始时，如果需要，容器将自动应用数据库架构迁移。

家庭服务器系统（社区）

GhostFolio可用于各种家庭服务器系统，包括Casaos，Home Assistant，Runtipi，Truecharts，Umbrel和Unraid。

发展

有关环境设置和开发过程的详细信息，请参阅开发。

公共API

授权：承载令牌

设置每个请求的标题：如下：

 "Authorization": "Bearer eyJh..."

您可以通过POST http://localhost:3333/api/v1/auth/anonymous （正文： { "accessToken": "<INSERT_SECURITY_TOKEN_OF_ACCOUNT>" } ）

已弃用： GET http://localhost:3333/api/v1/auth/anonymous/<INSERT_SECURITY_TOKEN_OF_ACCOUNT>或curl -s http://localhost:3333/api/v1/auth/anonymous/<INSERT_SECURITY_TOKEN_OF_ACCOUNT> 。

健康检查（实验）

要求

GET http://localhost:3333/api/v1/health

信息：健康检查不需要携带者令牌

回复

成功

200 OK

 {
  "status": "OK"
}

进口活动

先决条件

授权的承载令牌

要求

POST http://localhost:3333/api/v1/import

身体

 {
  "activities": [
    {
      "currency": "USD",
      "dataSource": "YAHOO",
      "date": "2021-09-15T00:00:00.000Z",
      "fee": 19,
      "quantity": 5,
      "symbol": "MSFT",
      "type": "BUY",
      "unitPrice": 298.58
    }
  ]
}

场地	类型	描述
`accountId`	`string` （可选）	帐户的ID
`comment`	`string` （可选）	活动评论
`currency`	`string`	`CHF` \| `EUR` \| `USD`等
`dataSource`	`string`	`COINGECKO` \| `MANUAL` （用于类型`ITEM` ）\| `YAHOO`
`date`	`string`	格式`ISO-8601`的日期
`fee`	`number`	活动的费用
`quantity`	`number`	活动数量
`symbol`	`string`	活动的象征（适用于`dataSource` ）
`type`	`string`	`BUY` \| `DIVIDEND` \| `FEE` \| `INTEREST` \| `ITEM` \| `LIABILITY` \| `SELL`
`unitPrice`	`number`	每单位的价格

回复

成功

201 Created

错误

400 Bad Request

 {
  "error": "Bad Request",
  "message": [
    "activities.1 is a duplicate activity"
  ]
}

投资组合（实验）

先决条件

在我的GhostFolio的“访问”选项卡中授予类型公共的访问。

要求

GET http://localhost:3333/api/v1/public/<INSERT_ACCESS_ID>/portfolio

信息：授权不需要携带者令牌

回复

成功

 {
  "performance": {
    "1d": {
      "relativeChange": 0 // normalized from -1 to 1
    };
    "ytd": {
      "relativeChange": 0 // normalized from -1 to 1
    },
    "max": {
      "relativeChange": 0 // normalized from -1 to 1
    }
  }
}