victorbjelkholm/js-ipfs

js-ipfs Docker镜像

镜像概述

本镜像基于victorbjelkholm/js-ipfs，是IPFS（InterPlanetary File System）协议的JavaScript实现。IPFS是一种点对点的分布式文件系统，旨在实现数据的去中心化存储与传输。该镜像可快速部署JS版IPFS节点，支持在Node.js和浏览器环境中使用。

核心功能

• 文件操作：添加、获取、查看分布式文件（如ipfs.files.add、ipfs.files.cat）。
• DAG操作：处理IPLD有向无环图数据（如ipfs.dag.put、ipfs.dag.get）。
• PubSub通信：点对点发布订阅消息机制。
• Swarm连接：管理节点对等连接（添加、断开节点）。
• CLI工具：提供jsipfs命令行工具，兼容Go-IPFS接口。

使用场景

1. 开发去中心化应用（DApp），存储静态资源或数据。
2. 构建分布式存储服务，替代中心化存储方案。
3. 实现点对点数据传输与共享，无需中间服务器。
4. 学习IPFS协议及JS版实现的开发与使用。

配置说明

• 默认端口：Swarm端口4002、API端口5002。
• Repo路径：默认~/.jsipfs，可通过IPFS_PATH环境变量修改。
• 实验性功能：支持PubSub、DHT等，需启动时配置启用。

Docker部署示例

启动IPFS守护进程

bash
docker run -d \
  -p 4002:4002 \
  -p 5002:5002 \
  -v ~/.jsipfs:/root/.jsipfs \
  docker.xuanyuan.run/victorbjelkholm/js-ipfs \
  jsipfs daemon

执行CLI命令

bash
docker exec -it <container_id> jsipfs id  # 查看节点ID
docker exec -it <container_id> jsipfs files add /path/to/file  # 添加文件

注意事项

• 镜像处于Alpha阶段，API可能变化。
• 启用Bootstrap节点需设置IPFS_BOOTSTRAP=1环境变量。
• 浏览器环境使用需参考官方文档进行打包配置。