Skip to content

Latest commit

 

History

History
88 lines (78 loc) · 3.27 KB

07.md

File metadata and controls

88 lines (78 loc) · 3.27 KB

教程：自托管 planet / moon 自动更新

通过研究代码可以看到controller 分发网络变更事件，并且zt内置了 World（planet 或 moon）更新机制。 通过控制器端更新world文件可以实现所有控制器管理的网络一起更新world。

	/**
	 * Check whether a world update should replace this one
	 *
	 * @param update Candidate update
	 * @return True if update is newer than current, matches its ID and type, and is properly signed (or if current is NULL)
	 */
	inline bool shouldBeReplacedBy(const World &update)
	{
		if ((_id == 0)||(_type == TYPE_NULL)) {
			return true;
		}
		if ((_id == update._id)&&(_ts < update._ts)&&(_type == update._type)) {
			Buffer<ZT_WORLD_MAX_SERIALIZED_LENGTH> tmp;
			update.serialize(tmp,true);
			return C25519::verify(_updatesMustBeSignedBy,tmp.data(),tmp.size(),update._signature);
		}
		return false;
	}

从这里看到更新的条件是：id相同，type相同，时间戳ts更大（更新），C25519通过_updatesMustBeSignedBy校验成功

回看 world 创建方法，type不用管，id默认固定 const uint64_t id = ZT_WORLD_ID_EARTH;，key一致即可更新。

	/**
	 * Create a World object signed with a key pair
	 *
	 * @param t World type
	 * @param id World ID
	 * @param ts World timestamp / revision
	 * @param sk Key that must be used to sign the next future update to this world
	 * @param roots Roots and their stable endpoints
	 * @param signWith Key to sign this World with (can have the same public as the next-update signing key, but doesn't have to)
	 * @return Signed World object
	 */

而且代码自带处理函数

			case ZT_STATE_OBJECT_PLANET:
				OSUtils::ztsnprintf(p,sizeof(p),"%s" ZT_PATH_SEPARATOR_S "planet",_homePath.c_str());
				break;
			case ZT_STATE_OBJECT_MOON:
				OSUtils::ztsnprintf(dirname,sizeof(dirname),"%s" ZT_PATH_SEPARATOR_S "moons.d",_homePath.c_str());
				OSUtils::ztsnprintf(p,sizeof(p),"%s" ZT_PATH_SEPARATOR_S "%.16llx.moon",dirname,(unsigned long long)id[0]);
				break;
...
			if (f) {
				if (fwrite(data,len,1,f) != 1)
					fprintf(stderr,"WARNING: unable to write to file: %s (I/O error)" ZT_EOL_S,p);
				fclose(f);
				if (secure)
					OSUtils::lockDownFile(p,false);
			} else {
				fprintf(stderr,"WARNING: unable to write to file: %s (unable to open)" ZT_EOL_S,p);
			}

IncomingPacket 内检测是否可以更新

			// Handle planet or moon updates if present
			if ((ptr + 2) <= size()) {
				const unsigned int worldsLen = at<uint16_t>(ptr);
				ptr += 2;
				if (RR->topology->shouldAcceptWorldUpdateFrom(peer->address())) {
					const unsigned int endOfWorlds = ptr + worldsLen;
					while (ptr < endOfWorlds) {
						World w;
						ptr += w.deserialize(*this,ptr);
						RR->topology->addWorld(tPtr,w,false);
					}
				} else {
					ptr += worldsLen;
				}
			}

签名key通过 https://github.com/zerotier/ZeroTierOne/blob/dev/attic/world/mkworld.cpp 可以看出 current.c25519 就是上面要求的 _updatesMustBeSignedBy。

总结，在更新前mkworld基础之上，ts取当前时间戳，与更新前用的 current.c25519 保持一致，重新生成新world，替换控制器上的文件即可。

控制器重启一下，初始读取world->全网Topology stateObjectGet ->所有客户端 stateObjectPut即可实现全网world更新。