xmrig全静态编译实战指南：从环境搭建到生产部署

xmrig全静态编译实战指南：从环境搭建到生产部署

【免费下载链接】xmrigRandomX, KawPow, CryptoNight and GhostRider unified CPU/GPU miner and RandomX benchmark项目地址: https://gitcode.com/GitHub_Trending/xm/xmrig

准备阶段：为什么要费功夫搞静态编译？ 🤔

你是否遇到过这样的情况：在自己电脑上编译好的程序，复制到服务器上却提示"找不到某某库"？或者在不同Linux发行版之间移植软件时，被各种依赖问题搞得头都大了？静态编译就是解决这些烦恼的终极方案。

静态编译会把所有需要的库都打包到可执行文件中，生成一个独立的程序。这意味着你可以把它复制到任何相同架构的Linux系统上直接运行，不需要安装任何额外的依赖包。对于需要在多台机器上部署的挖矿软件来说，这简直是福音！

开发环境准备

首先，我们需要准备好编译环境。不同的Linux发行版安装命令略有不同：

# Ubuntu/Debian系统 sudo apt update sudo apt install -y build-essential cmake git # 基础编译工具 sudo apt install -y libhwloc-dev libuv1-dev libssl-dev # 依赖库 # CentOS/RHEL系统 sudo yum groupinstall -y "Development Tools" # 开发工具组 sudo yum install -y cmake git hwloc-devel libuv-devel openssl-devel # 依赖包

⚠️ 注意：确保你的系统已安装gcc 7.0或更高版本，否则可能无法编译最新的xmrig代码

获取源代码

接下来，我们需要获取xmrig的源代码：

git clone https://gitcode.com/GitHub_Trending/xm/xmrig cd xmrig

实用技巧：使用特定版本编译

如果你需要编译特定版本而非最新代码，可以使用git checkout命令：

git tag # 列出所有版本标签 git checkout v6.20.0 # 切换到指定版本

核心构建：一步步打造静态可执行文件 🛠️

准备工作完成后，我们进入核心的编译环节。这一步的目标是构建所有依赖库的静态版本，并最终编译出静态链接的xmrig。

构建静态依赖库

xmrig需要几个关键的依赖库，我们需要先编译它们的静态版本：

# 构建libuv静态库 (事件循环库) ./scripts/build_deps.sh uv # 构建hwloc静态库 (硬件拓扑检测) ./scripts/build_deps.sh hwloc # 构建OpenSSL静态库 (加密支持) ./scripts/build_deps.sh openssl

💡 小提示：这些脚本位于项目的scripts目录下，负责自动下载、配置和编译各个依赖库

配置CMake构建选项

创建一个构建目录并配置CMake参数：

mkdir -p build && cd build # 创建并进入构建目录 # 配置CMake，启用静态编译 cmake .. -DBUILD_STATIC=ON \ -DWITH_HWLOC=ON \ -DWITH_OPENSSL=ON \ -DWITH_HTTP=ON \ -DCMAKE_BUILD_TYPE=Release

高级编译选项解析

除了基础选项外，还有一些高级选项可以优化你的编译结果：

• -DCMAKE_CXX_FLAGS="-march=native"：针对当前CPU架构优化，提升性能
• -DWITH_CUDA=OFF：如果不需要NVIDIA GPU支持，可以禁用CUDA
• -DWITH_OPENCL=OFF：如果不需要AMD GPU支持，可以禁用OpenCL
• -DDonateLevel=0：设置捐赠比例为0%（默认是5%）

例如，针对Intel CPU优化的配置：

cmake .. -DBUILD_STATIC=ON \ -DWITH_HWLOC=ON \ -DCMAKE_CXX_FLAGS="-march=skylake -O3" \ -DCMAKE_BUILD_TYPE=Release

执行编译

配置完成后，开始编译：

make -j$(nproc) # 使用所有可用CPU核心加速编译

⏱️ 编译时间取决于你的CPU性能，通常需要5-15分钟

检查点：验证静态编译结果

编译完成后，我们来验证一下是否真的是静态链接：

file xmrig # 查看文件类型信息

如果输出中包含"statically linked"字样，说明静态编译成功！

质量验证：确保你的xmrig可以正常工作 🔧

编译完成并不代表万事大吉，我们需要进行一系列测试来确保软件可以正常工作。

基本功能测试

首先检查版本信息：

./xmrig --version

你应该能看到类似这样的输出：

XMRig 6.20.0 built on Sep 1 2023 with GCC 9.4.0 features: 64-bit AES AVX2

性能基准测试

接下来进行基准测试，评估挖矿性能：

# 测试RandomX算法性能 ./xmrig --benchmark --algo=rx/0 --threads=$(nproc)

这个命令会运行基准测试并显示哈希率。测试结果会因CPU性能而异。

连接矿池测试

最后，进行实际挖矿测试（使用测试矿池）：

./xmrig -o gulf.moneroocean.stream:10128 -u 44AFFq5kSiGBoZ4NMDwYtN18obc8AemS33DBLWs3H7otXft3XjrpDtQGv7SqSsaBYBb98uNbr2VBBEt7f2wfn3RVGQBEP3 -p x -k

⚠️ 注意：这只是测试命令，使用的是公开测试钱包地址，挖到的币不会属于你

下图是xmrig运行时的界面示例，可以看到挖矿状态和性能指标：

生产应用：从测试到正式部署 🚀

经过严格测试后，我们的xmrig就可以部署到生产环境了。这一部分将介绍如何优化配置和确保稳定运行。

部署前的最后优化

启用大页面支持

RandomX算法需要大量内存，启用大页面可以显著提高性能：

# 临时设置大页面 sudo sysctl -w vm.nr_hugepages=128 # 永久设置（重启后生效） echo "vm.nr_hugepages=128" | sudo tee -a /etc/sysctl.conf

然后在启动xmrig时添加--huge-pages参数：

./xmrig --huge-pages -o 矿池地址 -u 你的钱包地址 -p 矿工名称

为不同架构优化

如果需要在ARM架构的设备（如树莓派）上运行，可以使用专门的编译选项：

# ARM架构编译配置 cmake .. -DBUILD_STATIC=ON \ -DWITH_HWLOC=ON \ -DCMAKE_CXX_FLAGS="-march=armv8-a+crypto" \ -DCMAKE_BUILD_TYPE=Release

生产环境监控建议

为了确保xmrig在生产环境中稳定运行，建议实施以下监控措施：

1. 进程监控：使用systemd创建服务，确保程序崩溃后自动重启

   [Unit] Description=XMrig Miner After=network.target [Service] User=miner WorkingDirectory=/opt/xmrig ExecStart=/opt/xmrig/xmrig -c config.json Restart=always [Install] WantedBy=multi-user.target

2. 性能监控：使用Prometheus+Grafana监控哈希率和系统资源使用

   • 启用xmrig的API功能：--api-worker-id=my-miner --api-port=4040
   • 使用xmrig-exporter收集指标

3. 日志管理：配置日志轮转，避免磁盘空间被日志占满

   # 安装logrotate sudo apt install logrotate # 创建配置文件 /etc/logrotate.d/xmrig /var/log/xmrig.log { daily rotate 7 compress delaycompress missingok copytruncate }

常见问题解决

编译错误：undefined reference to `SSL_xxx'

这个错误通常是因为OpenSSL静态库没有正确链接。解决方法：

# 清理之前的构建 make clean # 重新配置，明确指定OpenSSL路径 cmake .. -DBUILD_STATIC=ON \ -DOPENSSL_ROOT_DIR=/usr/local/ssl \ -DOPENSSL_LIBRARIES="ssl;crypto;pthread;dl"

运行时错误：cannot allocate huge pages

如果遇到大页面分配失败，尝试：

1. 检查当前大页面设置：cat /proc/meminfo | grep HugePages
2. 减少请求的大页面数量
3. 确保系统有足够的可用内存

跨平台编译技巧

如果需要为不同平台编译xmrig，可以使用Docker：

# 使用Ubuntu容器为旧系统编译 docker run -v $(pwd):/xmrig -it ubuntu:18.04 /bin/bash cd /xmrig # 然后按照前面的步骤编译

总结

通过本指南，你已经掌握了从源代码构建静态链接的xmrig的完整流程。静态编译的xmrig可以在各种Linux系统上无缝运行，大大简化了部署过程。

关键要点：

• 静态编译将所有依赖打包到单个可执行文件中
• 正确配置CMake选项是成功的关键
• 启用大页面和适当的CPU优化可以显著提升性能
• 生产环境中务必实施监控和自动重启机制

希望这篇指南能帮助你顺利构建和部署xmrig挖矿软件。如果遇到问题，可以查阅项目的官方文档或在社区寻求帮助。

编译流程示意图：

源代码 → 构建静态依赖库 → 配置CMake → 编译 → 测试 → 部署 ↑ ↑ ↑ ↑ ↑ ↑ 获取代码 耗时步骤 关键配置 最耗时 验证功能 生产使用

【免费下载链接】xmrigRandomX, KawPow, CryptoNight and GhostRider unified CPU/GPU miner and RandomX benchmark项目地址: https://gitcode.com/GitHub_Trending/xm/xmrig