当前位置：首页 > 涨幅榜 > 正文内容

在 Linux 系统下编译莱特币钱包，从源码到运行的完整指南

eeo2026-09-24 02:24:06涨幅榜20

摘要：
莱特币（Litecoin）作为一种流行的加密货币，其钱包软件是用户管理、存储和交易LTC的核心工具，虽然可以从官方渠道下载预编译好的钱包程序，但对于追求更高定制性、安全性，或者希望深入了解其内部原...

欧意交易所

全球三大交易所之一，注册领50 USDT数币盲盒！

莱特币（Litecoin）作为一种流行的加密货币，其钱包软件是用户管理、存储和交易 LTC 的核心工具，虽然可以从官方渠道下载预编译好的钱包程序，但对于追求更高定制性、安全性，或者希望深入了解其内部原理的开发者和高级用户而言，从源码编译莱特币钱包是一个非常有价值的过程，本文将详细介绍在 Linux 系统下如何编译莱特币钱包，涵盖环境准备、依赖安装、源码获取、编译配置、编译安装以及后续验证等关键步骤。

编译前的准备工作：系统与环境要求

在开始编译之前，确保你的 Linux 系统满足以下基本要求：

操作系统：推荐使用主流的 Linux 发行版，如 Ubuntu (18.04/20.04/22.04)、Debian、CentOS/RHEL 等，本文将以 Ubuntu/Debian 为例进行说明,其他发行版可能需要调整包管理器命令。
编译器：需要一个较新的 C++ 编译器，如 GCC 或 Clang，莱特币钱包通常要求 C++17 标准。
构建工具：如 make 或 ninja。
版本控制工具：git，用于从 GitHub 获取莱特币源码。
其他依赖库：包括 Boost、Berkeley DB (BDB)、Qt (用于 GUI 版本)、MiniUPnPc 等,这些是莱特币钱包运行所必需的。

安装必要的依赖库和工具

打开终端，根据你的 Linux 发行版执行以下命令安装所需依赖：

对于 Ubuntu/Debian 系统：

sudo apt-get update
sudo apt-get install -y build-essential autoconf libtool pkg-config libboost-all-dev libssl-dev libdb++-dev libminiupnpc-dev libzmq3-dev libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libqrencode-dev

对于 CentOS/RHEL 系统 (可能需要 EPEL 源)：

sudo yum update -y
sudo yum groupinstall -y "Development Tools"
sudo yum install -y autoconf libtool boost-devel openssl-devel db4-cxx-devel miniupnpc-devel zeromq-devel qt5-qtbase-devel qt5-qttools-devel protobuf-devel libqrencode-devel

说明：

build-essential：包含 GCC, G++, make 等基本构建工具。
libboost-all-dev：Boost C++ 库的完整版本,莱特币依赖其多个模块。
libssl-dev：OpenSSL 开发库,用于加密功能。
libdb++-dev：Berkeley DB 开发库，用于存储区块链数据（注意：莱特币较新版本可能更倾向于使用 libdb5.3++-dev 或类似，请根据源码要求调整）。
libminiupnpc-dev：用于 NAT-PMP 和 IUPnP 端口映射。
libzmq3-dev：ZeroMQ 库，用于 P2P 通信（某些版本或功能可能需要）。
libqt5* 和 qttools5-dev*：用于构建 GUI 版本的莱特币钱包，如果你只需要命令行版本 (litecoind)，可以省略 Qt 相关的依赖。
libprotobuf-dev 和 protobuf-compiler：Protocol Buffers 库,用于数据序列化。
libqrencode-dev：用于生成二维码。

获取莱特币源码

莱特币的源码托管在 GitHub 上，使用 git 克隆最新版本（或你需要的特定版本）：

git clone https://github.com/litecoin-project/litecoin.git
cd litecoin

克隆完成后，你可以查看可用的分支或标签,切换到特定版本：

git tag  # 查看所有可用版本
git checkout v0.21.2.2  # 切换到特定版本，v0.21.2.2

配置编译选项

莱特币使用 autotools 构建系统，通过 ./configure 脚本进行配置，在 litecoin 目录下执行：

./autogen.sh  # 如果是刚克隆的未发布版本，需要先运行此脚本生成 configure
./configure

常用 configure 选项：

--disable-wallet：禁用钱包功能（仅编译 litecoind 守护进程）。
--disable-tests：禁用单元测试,加快编译速度。
--disable-bench：禁用基准测试。
--without-gui：禁用 GUI,仅编译命令行工具。
--with-incompatible-bdb：如果你安装的 Berkeley DB 版本与官方推荐的不完全兼容，可以使用此选项（不推荐，尽量匹配推荐版本）。
--prefix=/usr/local/litecoin：指定安装路径，默认通常为 /usr/local。

如果你想编译一个不带 GUI 的版本,并禁用测试：

./configure --without-gui --disable-tests

配置完成后，你会看到类似 Configured to build Litecoin Core: xxx 的输出,表示配置成功。

编译源码

配置成功后，执行 make 命令开始编译：

make -j$(nproc)

-j$(nproc) 选项会使用所有可用的 CPU 核心进行并行编译，显著加快编译速度，如果你的 make 不支持 -j 或 nproc，可以使用 make -j4 (使用4个核心) 等固定数值。

编译过程可能需要较长时间，从几十分钟到几小时不等，具体取决于你的 CPU 性能和系统负载，编译过程中会输出大量信息，如果出现错误，请仔细检查错误信息,通常是某些依赖库未正确安装或版本不兼容。

安编译好的钱包

编译成功后，使用 make install 命令将安装钱包到系统：

sudo make install

默认情况下，可执行文件（如 litecoind, litecoin-cli, litecoin-qt）会被安装到 /usr/local/bin 目录下，如果你的 PATH 环境变量包含 /usr/local/bin,就可以直接在终端中调用这些命令。

验证安装与后续步骤

检查版本：
```
litecoind --version
```
你应该能看到莱特币的版本信息以及编译时的选项。
初始化钱包（首次运行）：运行 litecoind 时，它会默认在用户主目录下创建 .litecoin 目录来存储配置文件和区块链数据。
```
litecoind
```
首次启动可能会花费一些时间下载和同步区块链数据。
创建配置文件（可选）：你可以创建并编辑 ~/.litecoin/litecoin.conf 文件来配置钱包，例如设置 RPC 用户名、密码、监听端口、节点连接等,一个简单的示例配置：
```
server=1
rpcuser=your_rpc_user
rpcpassword=your_rpc_password
rpcport=8332
testnet=0  # 主网为0，测试网为1
```
使用 GUI 钱包：如果你编译了 GUI 版本，可以直接在终端运行 litecoin-qt 命令启动图形界面钱包。

常见问题与注意事项

编译失败：仔细阅读错误日志，通常是缺少依赖库或依赖库版本过低/过高，可以尝试更新系统、安装缺失的包,或者查找特定版本的依赖库。
Berkeley DB 版本问题：莱特币对 BDB 版本有一定要求，过新或过旧的版本都可能导致问题，Ubuntu 18.04/20.04 自带的 libdb5.3++-dev 通常是可以的。
Qt 版本问题：确保安装的是 Qt5 的开发包，Qt4 可能不兼容。
编译时间过长：确保网络连接正常，因为 make 过程中可能会下载一些依赖。-j 选项合理使用 CPU 核心数。
权限问题：make install 需要 root 权限才能写入系统目录（如 /usr/local/bin）。
安全：从源码编译并自行安装软件，意味着你需要对软件的安全性和完整性负责，确保从官方 GitHub 仓库获取源码。