Sparrow：安全隐私优先的比特币钱包

项目简介

Sparrow 是一款面向桌面的比特币钱包应用，使用 Java 开发，支持大多数硬件钱包，并建立在 PSBT 等通用标准之上，强调透明度和易用性。项目免费开源，采用 Apache-2.0 许可证。

主要功能

• 支持大多数硬件钱包，基于 PSBT 等通用标准构建
• 注重透明度与易用性，同时强调安全和隐私
• 支持多种网络：mainnet、testnet（当前指 testnet3）、testnet4、regtest、signet
• 提供命令行参数，可自定义主目录、日志级别和所用网络
• 在 macOS 与 Linux 上可选遵循 XDG Base Directory 规范，分别存放配置、数据、状态和缓存
• Tor 相关工作文件和缓存分别位于 tor/work、tor/cache 目录
• 发布二进制自 v1.5.0 起可复现构建

安装与使用

发布二进制可从官网 https://sparrowwallet.com 或 GitHub Releases 获取，当前版本 2.5.6。

若直接从源码运行，需要安装 Java 25 或更高版本，然后在项目目录中执行：

./sparrow

命令行选项（./sparrow -h 可查看完整用法）：

Usage: sparrow [options]
  --dir, -d       指定 Sparrow 主目录路径
  --level, -l     设置日志级别 [ERROR, WARN, INFO, DEBUG, TRACE]
  --network, -n   使用的网络 [mainnet, testnet, regtest, signet, testnet4]

网络也可通过环境变量设置，例如 export SPARROW_NETWORK=testnet；还可在主目录中放置名为 network-testnet 的文件作为备用方式。

从源码构建安装包：

git clone --recursive https://github.com/sparrowwallet/sparrow.git
./gradlew jpackage

Linux 上若没装 deb 或 rpm 打包工具（如 Arch），可加 -PskipInstallers=true 跳过安装包构建；构建 Windows 安装包需要安装 WiX。

默认主目录：macOS 与 Linux 为 ~/.sparrow，Windows 为 %APPDATA%/Sparrow。testnet3、testnet4、regtest 和 signet 的配置与钱包存放在子文件夹中，便于切换网络。

注意事项

• 构建要求 Java 25 或以上；Debian/Ubuntu 上还需执行 sudo apt install -y rpm fakeroot binutils
• 使用 testnet 时，所连接的 Electrum 服务器也必须运行在 testnet 配置上
• 在 macOS 和 Linux 上，XDG 目录解析是可选开启的：只有对应目录已存在时才会使用；用 -d 指定主目录会完全禁用 XDG 解析
• 发布二进制使用 craigraw 的 GPG 密钥签名，指纹为 D4D0D3202FC06849A257B38DE94618334C674B40
• 遇到问题可在 GitHub Issues 反馈，并查看配置目录下的 sparrow.log 获取调试信息

本作品整理自 GitHub 开源项目 sparrowwallet/sparrow，原作者 @sparrowwallet，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。