1. 链一财经首页
  2. 资讯

精通IPFS:系统启动之概览

今天,我们开始从源代码来一窥 IPFS 系统,下文我们以 Node.JS 为例来讲解 IPFS 的源码。当我们写下如下代码

const {createNode} = require('ipfs')nconst node = createNode()n

时,虽然只有简简单单的两句代码,可是内部却执行了非常非常多的代码,接下来我们就来看系统是如何执行,如何初始化系统的。

 

当我们执行 createNode 函数时,真正执行的函数处于 ipfs/core/index.js 文件中,代码如下:

module.exports.createNode = (options) => {n  return new IPFS(options)n}n

上面初始化的 IPFS 对象代表了 IPFS 系统,它位于同一文件中,继承自 EventEmitter 对象。当我们初始化 IPFS 对象时,就开始执行它的构造函数,接下来我们分析下这个构造函数。

 

调用父类构造函数。设置系统所使用的环境变量。首先,设置系统默认选项。

const defaults = {n  init: true,n  start: true,n  EXPERIMENTAL: {},n  preload: {n    enabled: true,n    addresses: [n      '/dnsaddr/node0.preload.ipfs.io/https',n      '/dnsaddr/node1.preload.ipfs.io/https'n    ]n  }n}n

其次,验证选项是否有效。

options = config.validate(options || {})n

接下来,调用 mergeOptions 函数,使用用户指定选项参数来合并默认选项。

最后,处理选项的 initstart 两个配置,代码如下:

if (options.init === false) {n  this._options.init = falsen}

if (!(options.start === false)) {n  this._options.start = truen}n

 如果在选项中指定了仓库并且类型为字符串,或者没有指定仓库,那么设置所使用的仓库就是默认仓库,否则,使用用户指定的仓库。

if (typeof options.repo === 'string' ||n    options.repo === undefined) {n  this._repo = defaultRepo(options.repo)n} else {n  this._repo = options.repon}n

默认仓库定义位于 runtime/repo-nodejs.js 文件中,这个文件内容比较简单,具体如下:

'use strict'

const os = require('os')nconst IPFSRepo = require('ipfs-repo')nconst path = require('path')

module.exports = (dir) => {n  const repoPath = dir || path.join(os.homedir(), '.jsipfs')

  return new IPFSRepo(repoPath)n}

因为我们没有指定仓库的位置,所以它默认位于用户的户主目录下的 .jsipfs 目录。下面,我们看下 IPFSRepo 对象,它位于 ipfs-repo 项目的 index.js 文件中,它的构造函数如下:

constructor (repoPath, options) { assert.strictEqual(typeof repoPath, ‘string’, ‘missing repoPath’)

this.options = buildOptions(options)nthis.closed = truenthis.path = repoPath

this._locker = this._getLocker()

this.root = backends.create('root', this.path, this.options)nthis.version = version(this.root)nthis.config = config(this.root)nthis.spec = spec(this.root)nthis.apiAddr = apiAddr(this.root)n

}

在仓库的构造函数中,首先调用 buildOptions 函数来设置仓库的选项。这个函数把用户指定的选项与仓库默认的选项进行合并,同时处理 storageBackendsstorageBackendOptions 两个选项。因为,生成默认仓库时只指定了仓库的目录,而没有指定任务其他选项,所以默认仓库会使用默认选项。默认选项如下,

{n  lock: 'fs',n  storageBackends: {n    root: require('datastore-fs'),n    blocks: require('datastore-fs'),n    keys: require('datastore-fs'),n    datastore: require('datastore-level')n  },n  storageBackendOptions: {n    root: {n      extension: ''n    },n    blocks: {n      sharding: true,n      extension: '.data'n    },n    keys: {n    }n  }n}n

从默认选项中,我们发现锁使用的是文件,根目录、区块目录和 keys 目录使用的是普通文件系统存储,数据存储使用的是 level 数据系统,默认数据文件后缀为 .data

处理完仓库选项之后,接下来就可以处理仓库。调用 backends.js 文件中定义的函数来创建仓库的目录,根据选项配置即创建主目录对象,默认情况下创建主目录位于 ~/.jsipfs,接下来依次创建版本文件、配置文件、存储规定等对象。

注意,这些动作完成之后,仓库对象即初始完成,但此时除了主目录外,别的目录及文件并没有真正创建,它们的真正创建要等到启动初始化时才会进行。

接下来生成内部需要的对象。

this._peerInfoBook = new PeerBook()nthis._peerInfo = undefinednthis._bitswap = undefined

this._blockService = new BlockService(this._repo)nthis._ipld = new Ipld(ipldOptions(this._blockService, this._options.ipld, this.log))nthis._preload = preload(this)

this._mfsPreload = mfsPreload(this)n

_bitswap 对象在 start 阶段才会真正生成,区块服务对象保存仓库对象、bitswap 对象,系统通过调用区块服务对象的 put、get、delete 操作来处理具体的区块,具体区块可以从本地仓库中中处理,也可以通过 bitswap 对象来处理具体的区块。bitswap 对象此时为空,直到系统启动阶段才会生成并进行设置。

 

再接下来扩充系统核心组件,主要用于节点的初始化、启动、终止、关闭等。

this.init = components.init(this)nthis.preStart = components.preStart(this)nthis.start = components.start(this)nthis.stop = components.stop(this)nthis.shutdown = this.stopnthis.isOnline = components.isOnline(this)n

这些命令后面再进行具体讲解,此处略去不讲。

 

再接下来扩充一些交互相关的组件,包括文件相关的操作。

Object.assign(this, components.filesRegular(this))nthis.version = components.version(this)nthis.id = components.id(this)nthis.repo = components.repo(this)nthis.bootstrap = components.bootstrap(this)nthis.config = components.config(this)nthis.block = components.block(this)nthis.object = components.object(this)nthis.dag = components.dag(this)nthis.files = components.filesMFS(this)nthis.libp2p = null // assigned on startnthis.swarm = components.swarm(this)nthis.name = components.name(this)nthis.bitswap = components.bitswap(this)nthis.pin = components.pin(this)nthis.ping = components.ping(this)nthis.pingPullStream = components.pingPullStream(this)nthis.pingReadableStream = components.pingReadableStream(this)nthis.pubsub = components.pubsub(this)nthis.dht = components.dht(this)nthis.dns = components.dns(this)nthis.key = components.key(this)nthis.stats = components.stats(this)nthis.resolve = components.resolve(this)n

上面两步对系统的扩充可以进行直接调用,也可以通过程序来调用。对应于命令行中的相关命令。

 

最后,调用 boot 函数进行系统启动。

到这里,宏观上 IPFS 节点已经启动,可以调用各种命令来把玩系统。

根据国家《关于防范代币发行融资风险的公告》,大家应警惕代币发行融资与交易的风险隐患。

本文来自LIANYI转载,不代表链一财经立场,转载请联系原作者。

发表评论

登录后才能评论