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 应用
- 从 umbrel.com/downloads 下载适合你设备的 umbrelOS。GitHub 上的每个版本都列出了一个 SHA256SUMS 文件,你可以借此确认下载的文件就是 Umbrel 发布的那一个。验证下载文件一文介绍了具体做法。
- 把它写入一个驱动器。对于 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 跳过这一步。
- 接上网线和电源,等待大约五分钟完成首次启动。
- 在同一网络中的一台电脑上,用浏览器打开 http://umbrel.local。
- 在 Welcome to umbrelOS 页面,点击 Get started。输入你的名字、Password 和 Confirm password,然后点击 Create。Umbrel 在表单下方注明:这个密码无法重置,所以请妥善保存。完成设置即表示接受 umbrelOS 服务条款。在带有额外硬盘的设备上,设置过程还会询问如何使用这些硬盘。
- 打开 App Store,搜索 Bitcoin Node,然后点击 Install。它的介绍写着 “Run your personal node powered by Bitcoin Core”(运行由 Bitcoin Core 驱动的个人节点),开发者是 Umbrel。在 Raspberry Pi 上,请趁同步还没进行太多,在应用设置的 App storage 中把应用的存储移到你的 SSD 上。
- 打开应用。它会显示 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
- 打开 File > Settings... > Server,选择 Private Electrum。
- 输入地址和端口,保持 Use SSL 关闭。
- 点击 Test Connection。当 Sparrow 连接到私有 Electrum 服务器时,主窗口右下角的开关会变成蓝色。
如果你输入 .onion 地址,Sparrow 会启动自己的 Tor 连接,所以在外面也能使用。Sparrow 指南介绍这个应用的其余部分。
Liana
Liana 的文档说,如果你使用 Bitcoin Core,它必须与 Liana 运行在同一台电脑上。Liana 不能通过网络使用你 Umbrel 上的 Bitcoin Core,但可以使用另一台机器上的 Electrum 服务器。
- 当 Liana 询问如何连接时,选择 I already have a node,并把 Node type: 设为 Electrum。
- 输入包含端口的地址,例如 umbrel.local:50001。Liana 接受可选的 tcp:// 前缀。不要使用 ssl://,因为 Umbrel 的服务器不使用 SSL。
以后你可以在 Settings > Node 中更改。Liana 指南介绍完整的设置。
手机上的 BlueWallet
- 把手机连接到家里的 Wi-Fi。
- 打开 Settings,然后进入 Network,再进入 Electrum Server。
- 输入地址和端口,保持 Use SSL 关闭,然后点按 Save。
- 确认 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日。软件和服务会变化:操作前请查看最新文档。
- umbrelOS: README and supported devices ↗
- umbrelOS: licence (PolyForm Noncommercial 1.0.0) ↗
- umbrelOS 2.0 release ↗
- umbrelOS 2.0.1 release ↗
- umbrelOS 2.1 Beta 1 release ↗
- umbrelOS 1.5 release (Backups) ↗
- umbrelOS: interface wording ↗
- Umbrel: downloads ↗
- Umbrel Home ↗
- Umbrel: installing umbrelOS on Intel or AMD ↗
- Umbrel: installing umbrelOS on Raspberry Pi ↗
- Umbrel App Store repository ↗
- Bitcoin Node: app listing ↗
- Bitcoin Node: source code ↗
- Electrs: app listing ↗
- Electrs app: source code ↗
- Fulcrum: app listing ↗
- Lightning Node: app listing ↗
- Lightning Node: automatic encrypted backups ↗
- Bitcoin Core 32.1: chain size figures ↗
- bitcoin.org: running a full node ↗
- The Open Source Definition ↗
- Sparrow: FAQ ↗
- Liana: usage documentation ↗
- Liana 16.0: the app's own wording ↗
- BlueWallet 8.0.2: the app's own wording ↗
运行一个真正用起来的节点 → · Sparrow:建立一个能仔细检查的钱包 → · Liana:内置恢复计划的钱包 → · BlueWallet:更清楚地管理日常钱包 → · 选择你能维护的 Lightning 配置 → · 你的余额包含多段资金历史 →
