A compact home server and connected network equipment, editorial illustration
实用指南

Umbrel:运行节点,并把你的钱包连接到它

在家中设置 umbrelOS,运行 Bitcoin Node 应用和一个 Electrum 服务器,并让 Sparrow、Liana 和 BlueWallet 指向你自己的节点。还介绍 Umbrel 会备份什么、不会备份什么,以及你在哪些方面信任它。

开始阅读
11 分钟阅读简体中文
阅读模式

Umbrel 是什么

Umbrel 是一台家用服务器:放在家里的一台小电脑,运行你从它自带的应用商店安装的应用。其中一个应用就是比特币节点。它的操作系统叫 umbrelOS。

umbrelOS 2.0 于 2026 年 9 月 22 日发布。2.0.1 版本是一次安全更新,于 2026 年 11 月 1 日发布,在 2026 年 11 月 17 日是当时的最新版本。任何加入测试计划的人都可以使用 2.1 测试版。

Umbrel 销售两款预装 umbrelOS 的设备:Umbrel Home 和 Umbrel Pro。你也可以免费下载 umbrelOS,安装在 Intel 或 AMD 电脑(迷你主机、笔记本电脑或台式机)、Raspberry Pi 5 或虚拟机上。Umbrel 的下载页面还列出了 Raspberry Pi 4。该项目表示,你自己安装的镜像与它自家设备出厂时的 umbrelOS 相同。它会取代电脑原有的操作系统:不能安装在现有的 Linux 系统之上。

umbrelOS 以 PolyForm Noncommercial License 1.0.0 发布。你可以出于个人和非商业目的阅读、使用、修改和分享代码,商业用途需要获得 Umbrel 的许可。因此它属于“源代码公开”:任何人都可以检查代码,但这份许可证不符合开源定义(Open Source Definition),因为开源定义不允许许可证限制在商业中的使用。

umbrelOS:README ↗ · umbrelOS 2.0.1 版本 ↗ · umbrelOS:许可证 ↗ · 开源定义 ↗

开始之前

  • 一台电脑。Umbrel Home 配备 16 GB 内存,SSD 存储可选 1 TB、2 TB 或 4 TB。如果使用你自己的 Intel 或 AMD 机器,Umbrel 的最低要求是双核 64 位处理器、4 GB 内存(建议 8 GB 或以上)以及供 umbrelOS 使用的 32 GB 空间,另外还需要存放应用和数据的硬盘。机器需要 UEFI 固件,并关闭 Secure Boot(安全启动)。
  • 足够的存储空间。Bitcoin Core 32.1 为主网的区块数据预留 897 GB,另外为未花费币的记录预留 14 GB。Electrum 服务器还会在此之上建立自己的索引。1 TB 的硬盘已经不够同时容纳两者,所以请选择 2 TB 或更大的硬盘,并且使用 SSD。
  • 如果使用 Raspberry Pi 5,microSD 卡放不下区块链。Umbrel 的 Pi 指南目前建议从 32 GB 或更大的 microSD 卡运行 umbrelOS,并连接一块 SSD 作为外部存储。之后 umbrelOS 2.0 可以把应用的存储移到这块 SSD 上,这块 SSD 必须格式化为 ext4。Umbrel Home,或者带 2 TB 内置硬盘的迷你主机,可以省去这一步。
  • 时间。bitcoin.org 的全节点指南说,首次同步至少需要几天,网速慢或电脑慢时还会更久。Umbrel 表示,之后 Electrum 服务器第一次建立索引还需要几个小时。
  • 你的家庭网络。Umbrel 的两份安装指南都要求在设置期间用网线连接到路由器。节点会先下载一次完整的区块链,之后持续与其他节点分享区块。bitcoin.org 指出,网速快的节点每月上传 200 GB 或更多是常见的。如果你的网络有流量上限,Bitcoin Node 应用有一项设置可以限制每日上传量。

Umbrel Home ↗ · Umbrel:在 Intel 或 AMD 上安装 ↗ · Umbrel:在 Raspberry Pi 上安装 ↗ · Bitcoin Core 32.1:链大小数据 ↗ · bitcoin.org:运行全节点 ↗

安装 umbrelOS 和 Bitcoin Node 应用

App Store
Search appsBitcoin Node
Bitcoin NodeRun your personal node powered by Bitcoin CoreInstall
1 / 4
安装节点和 Electrum 服务器的示意图,根据 umbrelOS 2.0 以及 Umbrel 的 Bitcoin Node 和 Electrs 应用中的文字绘制。不是截图;布局和颜色经过简化。
  1. 从 umbrel.com/downloads 下载适合你设备的 umbrelOS。GitHub 上的每个版本都列出了一个 SHA256SUMS 文件,你可以借此确认下载的文件就是 Umbrel 发布的那一个。验证下载文件一文介绍了具体做法。
  2. 把它写入一个驱动器。对于 Raspberry Pi,Umbrel 的指南使用 Raspberry Pi Imager 或 Balena Etcher,以及一张 microSD 卡。对于 Intel 或 AMD 机器,用 Balena Etcher 把磁盘镜像写入一个 32 GB 或更大的 U 盘。之后 umbrelOS 就从这个 U 盘运行,U 盘需要一直插着。Umbrel 还提供一个 USB 安装程序,可以把 umbrelOS 装到机器的内置硬盘上。Umbrel Home 和 Umbrel Pro 跳过这一步。
  3. 接上网线和电源,等待大约五分钟完成首次启动。
  4. 在同一网络中的一台电脑上,用浏览器打开 http://umbrel.local。
  5. 在 Welcome to umbrelOS 页面,点击 Get started。输入你的名字、Password 和 Confirm password,然后点击 Create。Umbrel 在表单下方注明:这个密码无法重置,所以请妥善保存。完成设置即表示接受 umbrelOS 服务条款。在带有额外硬盘的设备上,设置过程还会询问如何使用这些硬盘。
  6. 打开 App Store,搜索 Bitcoin Node,然后点击 Install。它的介绍写着 “Run your personal node powered by Bitcoin Core”(运行由 Bitcoin Core 驱动的个人节点),开发者是 Umbrel。在 Raspberry Pi 上,请趁同步还没进行太多,在应用设置的 App storage 中把应用的存储移到你的 SSD 上。
  7. 打开应用。它会显示 Running,然后显示 Synchronizing 和一个百分比。应用自己的说明指出,这个百分比跟踪的是已验证的链工作量,而不是区块数量,所以它不会均匀上升。显示 Synchronized 并达到 100% 时,同步就完成了。

在应用设置中,你可以选择节点运行哪个版本的 Bitcoin Core,或者让它始终使用最新版本。Bitcoin Core 在 2026 年 10 月 28 日发布安全修复之后,Bitcoin Node 应用随后的更新加入了 32.1、31.2、30.4 和 29.5 版本,并说明 29.x 不再获得安全修复。运行 Bitcoin Core一文介绍节点本身。

Bitcoin Node:应用介绍 ↗ · Bitcoin Node:源代码 ↗ · umbrelOS:界面文字 ↗

添加 Electrum 服务器

大多数钱包查询余额的方式,是向服务器询问你的每一个地址。Electrum 服务器为你的节点保存的区块链建立索引,因此能快速回答关于任何地址的这类查询。Bitcoin Node 应用自己的 Connect 页面把 Electrum 服务器称为 “the most widely supported way to connect a wallet to your own node.”(把钱包连接到自己节点时支持最广泛的方式)。如果你不自己设置一个,钱包就会去问别人的服务器,而那个服务器能看到你的地址。

Umbrel App Store 提供两种:

  • Electrs,Umbrel 的官方应用,基于 Roman Zeyde 开发的 Electrs。它的连接端口是 50001。
  • Fulcrum,由 Calin Culianu 开发,由一位社区贡献者为 Umbrel 打包。它的连接端口是 50002。

装一个就够了。两者都需要 Bitcoin Node 应用,并会等它完成同步后再建立索引。在本地网络上,两者都接受不使用 SSL 的普通连接。Electrs 准备好后,会显示 Address、Port 和 SSL,并有一个在 Local Network 和 Tor 之间切换的开关。Tor 会显示一个 .onion 地址,你在外出时也能使用。本地地址是 umbrel.local,除非你给设备改过名字。如果钱包找不到 umbrel.local,请使用 umbrelOS 在设置中显示的 Local IP。

Bitcoin Node 的 Connect 页面还有 RPC Details 和 P2P Details 两个标签页。Umbrel 提醒,本地网络的 RPC 选项会以未加密的方式发送你的用户名和密码,而且你必须在节点设置中允许你钱包的 IP 地址。Electrum 方式不需要密码。

Electrs:应用介绍 ↗ · Fulcrum:应用介绍 ↗ · Electrs 应用:源代码 ↗

连接你的钱包

使用以下信息:地址 umbrel.local(或 Tor 标签页中的 .onion 地址),Electrs 使用端口 50001,Fulcrum 使用端口 50002,关闭 SSL。

Sparrow

  1. 打开 File > Settings... > Server,选择 Private Electrum。
  2. 输入地址和端口,保持 Use SSL 关闭。
  3. 点击 Test Connection。当 Sparrow 连接到私有 Electrum 服务器时,主窗口右下角的开关会变成蓝色。

如果你输入 .onion 地址,Sparrow 会启动自己的 Tor 连接,所以在外面也能使用。Sparrow 指南介绍这个应用的其余部分。

Liana

Liana 的文档说,如果你使用 Bitcoin Core,它必须与 Liana 运行在同一台电脑上。Liana 不能通过网络使用你 Umbrel 上的 Bitcoin Core,但可以使用另一台机器上的 Electrum 服务器。

  1. 当 Liana 询问如何连接时,选择 I already have a node,并把 Node type: 设为 Electrum。
  2. 输入包含端口的地址,例如 umbrel.local:50001。Liana 接受可选的 tcp:// 前缀。不要使用 ssl://,因为 Umbrel 的服务器不使用 SSL。

以后你可以在 Settings > Node 中更改。Liana 指南介绍完整的设置。

手机上的 BlueWallet

  1. 把手机连接到家里的 Wi-Fi。
  2. 打开 Settings,然后进入 Network,再进入 Electrum Server。
  3. 输入地址和端口,保持 Use SSL 关闭,然后点按 Save。
  4. 确认 Status 显示 Connected。

BlueWallet 已不再内置 Tor。要在外出时使用 .onion 地址,请同时运行一个 Tor 应用,例如 Orbot。BlueWallet 指南有详细说明,隐私指南解释了服务器能知道些什么。

Sparrow:常见问题 ↗ · Liana:使用说明 ↗ · BlueWallet 8.0.2:应用自身的文字 ↗

Umbrel 上的 Lightning

App Store 有两个 Lightning 节点:Lightning Node,即 Umbrel 由 LND 驱动的官方应用,以及 Core Lightning。它还有用于管理节点的控制面板,包括 Ride The Lightning、ThunderHub 和 Lightning Terminal。

Lightning 节点把资金存放在 Umbrel 本身上,恢复这些资金既需要它的恢复助记词,也需要一份最新的通道备份。Lightning Node 应用会自动备份通道备份文件:先在你的 Umbrel 上加密,然后默认通过 Tor 发送到 Umbrel 运营的备份服务器。它的菜单中还有 Download channel backup file。如果你关闭自动备份,Umbrel 建议每次通道发生变化时都下载一份新文件。

Lightning 钱包地图和了解 Lightning,减少意外可以帮你决定是否运行自己的节点。ZEUS 可以在手机上控制 Lightning Node 应用。

Lightning Node:应用介绍 ↗ · Lightning Node:自动加密备份 ↗

更新、备份和信任

更新

在 Settings > Software update 中更新 umbrelOS,有新版本时点击 Install now。应用更新显示在 App Store 中,可以用 Update 更新单个应用,或用 Update all 全部更新。更新 Bitcoin Node 应用之前,请先阅读版本说明:如果它设置为使用最新版本,一次应用更新就可能把你的节点切换到新的 Bitcoin Core 版本。

备份

umbrelOS 的备份功能(Backups)位于 Settings > Backups,会自动把你的文件、应用和数据复制到另一台 Umbrel、你网络中的 NAS 或外接 USB 硬盘。备份使用你设置的密码加密,恢复时需要这个密码。Rewind 可以从较早的备份中恢复单个文件和文件夹,新的 Umbrel 也可以在设置过程中从备份恢复。

有些内容不在备份范围内:

  • Bitcoin Node 应用不备份它的区块数据、链状态和索引,Electrs 和 Fulcrum 不备份它们的索引。恢复后的节点必须重新下载并检查区块链。
  • 外接硬盘和网络共享不包括在内,被移到外接硬盘上的应用也不再由 umbrelOS 备份。
  • 你钱包的密钥不在节点上。Sparrow、Liana 和 BlueWallet 把密钥保存在钱包里或你的签名设备上,它们的恢复助记词以及 Liana 的描述符需要另外备份。节点只回答关于区块链的查询。Lightning 节点是例外:它的密钥确实存放在 Umbrel 上。

你在哪些方面信任 Umbrel

  • App Store。umbrelOS 从 Umbrel 自己在 GitHub 上的应用仓库安装应用。有些应用由 Umbrel 开发,其他的来自外部开发者和贡献者。每个应用页面都会显示 Developer(开发者)、Submitted by(提交者),以及指向其 Source code 的链接。应用更新也通过同一个商店提供。
  • umbrelOS 本身。它运行这些应用,保存你的账户,并安装你批准的更新。代码按照上文提到的非商业许可证公开,任何人都可以阅读。2.1 测试版加入了可复现构建,因此每个版本都可以从源代码重新构建,并与 Umbrel 发布的版本进行比较。
  • Bitcoin Core。无论由谁打包,你的节点都会自己检查每一个区块。Umbrel 决定应用提供哪些 Bitcoin Core 版本,以及它的默认设置。
  • Lightning 备份:如果你使用它,备份会发送到 Umbrel 运营的服务器。备份在离开你的设备之前就已加密。

umbrelOS 1.5:备份 ↗ · umbrelOS 2.1 Beta 1 ↗ · Umbrel App Store 仓库 ↗

在依赖它之前

  • Bitcoin Node 显示 Synchronized 并达到 100%,你的 Electrum 服务器显示 100% Synchronized。
  • 每个钱包都显示已连接到你的服务器,余额与你的预期一致。
  • 你的 Umbrel 密码已妥善保存。它无法重置。
  • umbrelOS 备份已设置好,其加密密码与设备分开保存。
  • 你钱包的恢复助记词,以及任何描述符,都备份在节点之外的地方。
  • 如果你运行 Lightning,你有它的恢复助记词和一份最近的通道备份。
  • 你知道自己的节点运行哪个 Bitcoin Core 版本,并会检查更新。

想用其他节点系统?Start9 指南介绍主要的替代方案。

资料与延伸阅读

研究日期:2026年11月17日。软件和服务会变化:操作前请查看最新文档。

运行一个真正用起来的节点 → · Sparrow:建立一个能仔细检查的钱包 → · Liana:内置恢复计划的钱包 → · BlueWallet:更清楚地管理日常钱包 → · 选择你能维护的 Lightning 配置 → · 你的余额包含多段资金历史 →

继续学习路径

一个问题引出另一个问题。

01运行一个真正用起来的节点02Start9:运行节点,并把你的钱包连接到它

Find your next answer.

Search the complete field guide · Esc to close