Boost

Boost 是一个用于 Filecoin 存储提供者管理 Filecoin 上数据存储和检索的工具。

请访问 https://boost.filecoin.io 查看文档以开始使用。

目录

• 构建和安装 Boost
• 在 Docker 中运行 Boost devnet
• 外部贡献指南
• 许可证

构建和安装 Boost

按照文档中"构建和安装"部分的说明进行编译和安装。

在 Docker 中运行 Boost devnet 用于开发

前提条件

• 安装 Docker - https://docs.docker.com/get-docker/

构建 Docker 镜像

1. 在 Boost 仓库的根目录下构建镜像

make clean docker/all

如果需要使用特定版本的 lotus 构建容器，请提供版本参数，例如 make clean docker/all lotus_version=v1.23.3。版本必须是 Lotus git 仓库 的标签或远程分支名称。 如果您请求的分支或标签在我们的 Github 镜像仓库 中不存在，您可以使用 make clean docker/all lotus_version=test/branch1 build_lotus=1 手动构建 lotus 镜像。我们在 Github 镜像仓库 中提供了所有 Lotus 发布版本的镜像。

启动 devnet Docker 堆栈

1. 运行

make devnet/up

这将启动 lotus、lotus-miner、boost、booster-http 和 demo-http-server 容器。所有临时数据将保存在 ./docker/devnet/data 文件夹中。

初始设置可能需要长达 20 分钟或更长时间，因为需要下载 Filecoin 证明参数。在初始设置期间，日志中出现错误消息是正常的。容器正在等待 lotus 就绪。可能会多次超时。预计重启将由 docker 管理。

2. 尝试打开 Boost GUI http://localhost:8080 。当 URL 打开并且在启动页面上没有显示错误时，表示 devnet 已准备就绪。

您可以使用 cd docker/devnet && docker compose logs -f 检查状态。

启动监控 docker 堆栈

docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions

cd docker/monitoring
docker compose up -d

将监控堆栈连接到 devnet 堆栈

docker network connect devnet tempo
docker network connect devnet prometheus

探索 Grafana / Tempo 并搜索跟踪

http://localhost:3333 (用户名: admin ; 密码: admin)

进行交易

boost 容器中打包了 boost 和 lotus 客户端。您可以使用命令 docker compose exec boost /bin/bash 连接到容器，并按照 使用 Boost 存储文件指南 进行操作。但建议先按照半交互式演示进行：

# 连接到正在运行的 boost 容器
make devnet/exec service=boost

# 执行演示脚本 /app/sample/make-a-deal.sh
root@83260455bbd2:/app# ./sample/make-a-deal.sh

您还可以利用 ./docker/devnet/boost/sample/random-deal.sh 脚本生成密集的随机 car 文件并自动进行交易。有关使用详情，请参阅脚本注释。

从本地主机访问 Lotus

默认情况下，docker-compose.yaml 不会暴露 lotus 容器的任何端口。要从本地机器访问 lotus：

1. 您可以在 docker-compose.yaml 中暴露 1234 端口，或使用 docker inspect lotus | grep IPAddress 命令找到 lotus 容器的 IP。
2. 获取 FULLNODE_API_INFO

docker exec -it lotus lotus auth api-info --perm=admin
FULLNODE_API_INFO=eyJ...ms4:/dns/lotus/tcp/1234/http

docker exec -it lotus-miner lotus-miner auth api-info --perm=admin
MINER_API_INFO=eyJ...UlI:/dns/lotus-miner/tcp/2345/http

3. 将 dns/lotus/tcp/1234/http 更改为 ip4/<127.0.0.1 或容器的 IP>/tcp/1234/http，以在 FULLNODE_API_INFO 中使用。

清理

要停止容器并删除所有内容：

make devnet/down

rm -rf ~/.cache/filecoin-proof-parameters

外部贡献指南

如果您想为 Boost 项目做出贡献，请参考这些指南。

许可证

双重许可：MIT + Apache 2.0