avalanchego
id:ava-labs/avalanchego ·
· 目录记录
项目概述
AvalancheGo是Avalanche网络的官方节点客户端:可用源码、APT仓库、发行版二进制或Docker安装,默认连接主网,也可用参数加入Fuji测试网,本地网络则建议用独立的avalanche-cli启动。文档给出硬件建议,并说明新主网节点引导可能需要数天。它是协议客户端,不是钱包应用。
原项目介绍
忠实中文 / 作者自述整理
作者称协议很轻量但给出主网节点建议配置(约8个AWS vCPU、16 GiB内存、1 TiB存储、Ubuntu 22.04/24.04或macOS>=12,以及可靠IP与开放端口)。源码构建需要Go>=1.26.10和gcc/g++,使用./scripts/run_task.sh build。也可用APT、GitHub Releases或Docker(映射9650/9651)安装。运行./build/avalanchego连接主网,--network-id=fuji连接Fuji;本地网推荐avalanche network start。引导完成前节点不会报告healthy。版本号跟随网络升级;补丁版本也可能改变导出的Go接口,但运行时API除非宣布弃用否则保持向后兼容。代码默认BSD-3,grafted子仓库可能不同。
短摘 / 原文
To connect to the Avalanche Mainnet, run:
出处:https://github.com/ava-labs/avalanchego/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
AvalancheGo是Avalanche网络的官方节点客户端:可用源码、APT仓库、发行版二进制或Docker安装,默认连接主网,也可用参数加入Fuji测试网,本地网络则建议用独立的avalanche-cli启动。文档给出硬件建议,并说明新主网节点引导可能需要数天。它是协议客户端,不是钱包应用。
谁会用
想运行Avalanche主网、Fuji或本地测试节点的节点运营者与需要对接其API的开发者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
运营者或开发者需要运行Avalanche主网、Fuji或本地测试节点并了解引导与平台限制。
文档化使用场景(编辑归纳)
安装avalanchego后默认连主网,或加--network-id=fuji;本地网用avalanche-cli。新主网节点引导可能耗时数天。
主要能力与用途
提供avalanchego二进制作为网络客户端,安装途径包括源码构建、官方APT、GitHub发行包和Docker镜像。
默认连接主网;使用--network-id=fuji连接测试网;本地测试网文档推荐独立工具avalanche-cli,而不是本二进制的简单单节点开关。
说明新主网节点引导需追上最新状态后才能参与共识和提供API,当前可能耗时数天,瓶颈通常在数据库IO。
平台支持分层:Linux amd64/arm64为Tier 1,Darwin arm64为Tier 2,Windows与Darwin amd64等明确不受支持。
如何使用 / 既有稿流程
文档场景:按平台安装客户端→直接运行连接主网,或加--network-id=fuji加入测试网;本地实验改用avalanche-cli。节点需等待引导结束才会healthy。本研究不编译、不运行节点、不开放端口。
用法证据状态
documented_workflow_only_not_executed
公开限制
硬件与引导耗时是文档建议/经验描述,实际需求随网络变化,本研究未跑节点。
Go模块接口可能在补丁版本变更;完整API与配置项见外部文档,本次未通读。
本地网络依赖另一个仓库avalanche-cli,其用法未在本仓展开。
许可快照为BSD-3-Clause,与README一致,但grafted目录可能有不同许可,全文未读。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
BSD-3-Clause
discussion_zh
README写明除非另有说明为BSD-3,快照为BSD-3-Clause。grafted仓库需另看各自LICENSE。全文未读。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
运营者或开发者需要运行Avalanche主网、Fuji或本地测试节点并了解引导与平台限制。
documented_use_case_zh
安装avalanchego后默认连主网,或加--network-id=fuji;本地网用avalanche-cli。新主网节点引导可能耗时数天。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:58:55.989477+08:00
来源
https://github.com/ava-labs/avalanchego/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/ava-labs/avalanchego/README.md.phase037-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:58:39.554624+08:00", "sha256": "1863a79411a0ea16582659b15887b34b9e4b6435185e05b430bf3178460d1032", "read_scope": "选读README的硬件与安装方式、连接主网/Fuji/本地测试网、引导同步、版本与平台支持及许可;不运行节点,不开放端口", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/ava-labs/avalanchego
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:27:00+08:00", "description": "Go implementation of an Avalanche node.", "topics": [], "record_sha256": "118ac6d2b1017e7ca9bc842d0ee48c8ba642e4cdbffd0b9d4f722d826fb48180", "read_scope": "逐项读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;不是README/源码核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读README的硬件与安装方式、连接主网/Fuji/本地测试网、引导同步、版本与平台支持及许可;不运行节点,不开放端口",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "1e909f144ca861034f8746545977f2d1f5e14d2ef66ccb554c99bc21a61b7563"
}