更新 p2pool 到 4.18.1
CI / validate (push) Successful in 5s
CI / build (amd64) (push) Successful in 3m24s
CI / build (arm64) (push) Successful in 9m51s
Release / build (amd64) (push) Successful in 3m18s
Release / build (arm64) (push) Successful in 9m58s
Release / release (push) Successful in 43s

This commit is contained in:
2026-09-23 09:09:53 +08:00
parent 3e7ec0c654
commit 882c073111
5 changed files with 13 additions and 12 deletions
+4 -4
View File
@@ -11,7 +11,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯一的定制是 **`-DWITH_MERGE_MINING_DONATION=OFF`**(禁用合并挖矿捐赠),不改源码。 p2pool 是 Monero 去中心化矿池的 sidechain 节点。本项目对上游唯一的定制是 **`-DWITH_MERGE_MINING_DONATION=OFF`**(禁用合并挖矿捐赠),不改源码。
> **与同目录 `gitea-xxxig` / `gitea-xxxig-proxy` / `gitea-mond` 的关系**:四者共享同一套 CI / build-deb / debian 打包骨架,且均为 **musl fully-static** 构建。差异:xxxig 系是 XMRig 换名仓库源码;mond 克隆 Monero 官方靠 init.sh 现场换名;p2pool 直接构建官方源码、不换名,版本号纯数字(`4.18`,上游 git tag 带 v、构建时补回)。 > **与同目录 `gitea-xxxig` / `gitea-xxxig-proxy` / `gitea-mond` 的关系**:四者共享同一套 CI / build-deb / debian 打包骨架,且均为 **musl fully-static** 构建。差异:xxxig 系是 XMRig 换名仓库源码;mond 克隆 Monero 官方靠 init.sh 现场换名;p2pool 直接构建官方源码、不换名,版本号纯数字(`4.18.1`,上游 git tag 带 v、构建时补回)。
## 整体架构:单二进制 ## 整体架构:单二进制
@@ -29,10 +29,10 @@ Gitea Actions 拆成两条独立流水线:
- **为何用 musl 而非 glibc**:musl 的 `getaddrinfo` 自带实现,全静态也能解析 DNS;glibc 静态会因 NSS 运行时 `dlopen` 失败。与 `gitea-xxxig`/`gitea-xxxig-proxy`/`gitea-mond` 一致。曾用的 `Dockerfile.ubuntu`(glibc 动态)与 `Dockerfile.alpine`(动态链 system 库)均已删除。 - **为何用 musl 而非 glibc**:musl 的 `getaddrinfo` 自带实现,全静态也能解析 DNS;glibc 静态会因 NSS 运行时 `dlopen` 失败。与 `gitea-xxxig`/`gitea-xxxig-proxy`/`gitea-mond` 一致。曾用的 `Dockerfile.ubuntu`(glibc 动态)与 `Dockerfile.alpine`(动态链 system 库)均已删除。
- **依赖处理(关键,勿乱改)**: - **依赖处理(关键,勿乱改)**:
- external 依赖**子模块自带源码**,逐个编静态(`BUILD_SHARED_LIBS=OFF` 等)。拉 8 个常规子模块 + grpc 及其 **6 个必需 third_party**(`abseil-cpp`/`boringssl-with-bazel`/`cares`/`protobuf`/`re2`/`zlib`);其余 9 个 grpc 子模块(benchmark/googletest/envoy/googleapis/xds 等测试或 xDS 依赖,已 `GRPC_NO_XDS`)**跳过**省体积/时间。 - external 依赖**子模块自带源码**,逐个编静态(`BUILD_SHARED_LIBS=OFF` 等)。拉 8 个常规子模块 + grpc 及其 **6 个必需 third_party**(`abseil-cpp`/`boringssl-with-bazel`/`cares`/`protobuf`/`re2`/`zlib`);其余 9 个 grpc 子模块(benchmark/googletest/envoy/googleapis/xds 等测试或 xDS 依赖,已 `GRPC_NO_XDS`)**跳过**省体积/时间。
- **WITH_GRPC=ON(支持 Tari 合并挖矿,勿改回 OFF)**:上游 CMake 默认即 ON(官方 alpine static job 为省体积改 OFF,本项目恢复 ON)。ON 时 `cmake/grpc.cmake` 用 `add_subdirectory(external/src/grpc)` 自动静态编译 grpc/protobuf/abseil/re2/cares,并 `add_subdirectory(external/src/Tari)` 编 checked-in 的 Tari proto(`.pb.cc`,不需运行时 protoc),链接 `Tari_gRPC grpc grpc++ libprotobuf`。这样 `tari://` 主机走 `MergeMiningClientTari`(gRPC)而非 `MergeMiningClientJSON_RPC`(JSON-RPC,与 Tari 不兼容、报 `empty response`)。代价:二进制 ~5MB→~15MB(`-Wl,-s --gc-sections` 剔除未用 grpc/xDS 代码后远小于全量)、构建 +约 15min/arch。曾为省体积误用 `WITH_GRPC=OFF` 致无法与 Tari 合并挖矿,**已改回 ON,勿回退**。 - **WITH_GRPC=ON(支持 Tari 合并挖矿,勿改回 OFF)**:上游 CMake 默认即 ON(官方 alpine static job 为省体积改 OFF,本项目恢复 ON)。ON 时 `cmake/grpc.cmake` 用 `add_subdirectory(external/src/grpc)` 自动静态编译 grpc/protobuf/abseil/re2/cares,并 `add_subdirectory(external/src/Tari)` 编 checked-in 的 Tari proto(`.pb.cc`,不需运行时 protoc),链接 `Tari_gRPC grpc grpc++ libprotobuf`。这样 `tari://` 主机走 `MergeMiningClientTari`(gRPC)而非 `MergeMiningClientJSON_RPC`(JSON-RPC,与 Tari 不兼容、报 `empty response`)。代价:二进制 ~5MB→~15MB(`-Wl,-s --gc-sections` 剔除未用 grpc/xDS 代码后远小于全量)、构建 +约 15min/arch。曾为省体积误用 `WITH_GRPC=OFF` 致无法与 Tari 合并挖矿,**已改回 ON,勿回退**。上游 v4.18.1 换用新 Tari 数据格式,合并挖矿需 Tari 节点 v6.0.0+。
- **boringssl 来源**:`WITH_GRPC=ON` 时由 grpc 子模块(`third_party/boringssl-with-bazel`)提供,grpc.cmake 走此分支、**不再** `add_subdirectory(cmake/ssl)`(那是 `elseif (WITH_TLS)` 分支);p2pool 主体 TLS 与下方 curl 共用这一份 boringssl。 - **boringssl 来源**:`WITH_GRPC=ON` 时由 grpc 子模块(`third_party/boringssl-with-bazel`)提供,grpc.cmake 走此分支、**不再** `add_subdirectory(cmake/ssl)`(那是 `elseif (WITH_TLS)` 分支);p2pool 主体 TLS 与下方 curl 共用这一份 boringssl。
- **curl 用 boringssl TLS(保留 rpc-ssl,勿改回 no-SSL)**:完整照搬官方 `c-cpp.yml` 的 curl flags——`P2POOL_BORINGSSL=ON`(上游给 curl 的独立 boringssl 后端补丁,与 `CURL_ENABLE_SSL=OFF` 共存、不走 curl 标准 SSL 路径)+ 一整套 `CURL_DISABLE_*`(尤其 `SRP`/`AWS`/`*_AUTH`)。后者跳过会引用 `OpenSSL::SSL` imported target 的 `curl_openssl_check_exists` 符号检测(新版 cmake 在 `try_compile` 阶段校验该 target 必失败,**少一个 disable 都会触发**)。curl 与 p2pool 主体共用同一 boringssl,`json_rpc_request` 的 `CURLOPT_SSL_CTX_FUNCTION` 才能接管证书指纹校验——**`--rpc-ssl`/`--rpc-ssl-fingerprint` 连外部 SSL monerod 的能力得以保留**(已实测连真实 SSL 节点用 `--rpc-ssl` 拿到链上高度)。曾误用 no-SSL curl 会断此能力,勿回退。 - **curl 用 boringssl TLS(保留 rpc-ssl,勿改回 no-SSL)**:完整照搬官方 `c-cpp.yml` 的 curl flags——`P2POOL_BORINGSSL=ON`(上游给 curl 的独立 boringssl 后端补丁,与 `CURL_ENABLE_SSL=OFF` 共存、不走 curl 标准 SSL 路径)+ 一整套 `CURL_DISABLE_*`(尤其 `SRP`/`AWS`/`*_AUTH`)。后者跳过会引用 `OpenSSL::SSL` imported target 的 `curl_openssl_check_exists` 符号检测(新版 cmake 在 `try_compile` 阶段校验该 target 必失败,**少一个 disable 都会触发**)。curl 与 p2pool 主体共用同一 boringssl,`json_rpc_request` 的 `CURLOPT_SSL_CTX_FUNCTION` 才能接管证书指纹校验——**`--rpc-ssl`/`--rpc-ssl-fingerprint` 连外部 SSL monerod 的能力得以保留**(已实测连真实 SSL 节点用 `--rpc-ssl` 拿到链上高度)。曾误用 no-SSL curl 会断此能力,勿回退。
- **版本号约定**:根目录 [VERSION](VERSION) 是唯一版本来源,内容为纯数字、无 `v`(当前 `4.18`,兼容两段或三段版本号)。上游 p2pool git tag 带 `v`,构建时补回后传给 Dockerfile;tar.gz、DEB 和 Registry 路径使用纯数字版本。发布 tag 可带或不带 `v`,归一后必须与 VERSION 完全一致。 - **版本号约定**:根目录 [VERSION](VERSION) 是唯一版本来源,内容为纯数字、无 `v`(当前 `4.18.1`,兼容两段或三段版本号)。上游 p2pool git tag 带 `v`,构建时补回后传给 Dockerfile;tar.gz、DEB 和 Registry 路径使用纯数字版本。发布 tag 可带或不带 `v`,归一后必须与 VERSION 完全一致。
- 架构映射:Dockerfile 内 `arm64→ARCH_ID=aarch64`、`amd64→ARCH_ID=x86_64`(传给 p2pool cmake,控制 RandomX 优化)。 - 架构映射:Dockerfile 内 `arm64→ARCH_ID=aarch64`、`amd64→ARCH_ID=x86_64`(传给 p2pool cmake,控制 RandomX 优化)。
- tar.gz 下载 URL 形如 `https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/{version}/p2pool-{arch}-linux-static-{version}.tar.gz`(version 为纯数字)。 - tar.gz 下载 URL 形如 `https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/{version}/p2pool-{arch}-linux-static-{version}.tar.gz`(version 为纯数字)。
@@ -49,7 +49,7 @@ docker buildx build --platform linux/amd64 \
ldd output/linux_amd64/p2pool ldd output/linux_amd64/p2pool
# 用已有 tar.gz 打 .deb 包(第三个参数是 tar.gz) # 用已有 tar.gz 打 .deb 包(第三个参数是 tar.gz)
./debian/build-deb.sh amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz ./debian/build-deb.sh amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz
``` ```
CI 对二进制执行 `p2pool --version`、`p2pool --help` 和内置 `p2pool --test`,用 `ldd` 校验为纯静态,并检查 DEB 内的二进制、默认配置和 systemd 服务。 CI 对二进制执行 `p2pool --version`、`p2pool --help` 和内置 `p2pool --test`,用 `ldd` 校验为纯静态,并检查 DEB 内的二进制、默认配置和 systemd 服务。
+6 -6
View File
@@ -14,7 +14,7 @@ P2Pool 是 [SChernykh/p2pool](https://github.com/SChernykh/p2pool) 的定制打
支持架构 `amd64` / `arm64`;musl 纯静态,任意 Linux 发行版(Debian/Ubuntu/Alpine/CentOS 等)开箱即跑。静态构建仍保留 `--rpc-ssl`(连外部 SSL monerod 节点)与内置 gRPC(`--merge-mine tari://...` 与 Tari 合并挖矿)。 支持架构 `amd64` / `arm64`;musl 纯静态,任意 Linux 发行版(Debian/Ubuntu/Alpine/CentOS 等)开箱即跑。静态构建仍保留 `--rpc-ssl`(连外部 SSL monerod 节点)与内置 gRPC(`--merge-mine tari://...` 与 Tari 合并挖矿)。
P2Pool v4.18 要求连接 **Monero daemon v0.18.5.1 或更高版本**。 P2Pool v4.18.1 要求连接 **Monero daemon v0.18.5.1 或更高版本**;与 Tari 合并挖矿要求 **Tari 节点 v6.0.0 或更高版本**(v4.18.1 换用新的 Tari 数据格式)。
## 安装 ## 安装
@@ -48,7 +48,7 @@ sudo apt-get update && sudo apt-get install p2pool
```bash ```bash
curl -fSL -o p2pool.tar.gz \ curl -fSL -o p2pool.tar.gz \
https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/4.18/p2pool-amd64-linux-static-4.18.tar.gz https://gitea.bcde.io/api/packages/wangdefa/generic/p2pool/4.18.1/p2pool-amd64-linux-static-4.18.1.tar.gz
tar -xzf p2pool.tar.gz tar -xzf p2pool.tar.gz
./p2pool --params-file params.conf # 配置模板见仓库 conf/params.conf.example ./p2pool --params-file params.conf # 配置模板见仓库 conf/params.conf.example
``` ```
@@ -73,15 +73,15 @@ docker buildx build --platform linux/amd64 \
ldd output/linux_amd64/p2pool ldd output/linux_amd64/p2pool
# 用产物 tar.gz 打 .deb # 用产物 tar.gz 打 .deb
./debian/build-deb.sh amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz ./debian/build-deb.sh amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz
``` ```
## 版本号约定 ## 版本号约定
- 根目录 [VERSION](VERSION) 是唯一版本来源,使用不带 `v` 的版本号。 - 根目录 [VERSION](VERSION) 是唯一版本来源,使用不带 `v` 的版本号。
- **上游源码 git tag** 带 `v`(如 `v4.18`),CI 构建时自动补回。 - **上游源码 git tag** 带 `v`(如 `v4.18.1`),CI 构建时自动补回。
- **包版本**(tar.gz / deb / registry 路径)一律用数字(如 `4.18`),符合 Debian 版本规范。 - **包版本**(tar.gz / deb / registry 路径)一律用数字(如 `4.18.1`),符合 Debian 版本规范。
- 发布 tag 可写成 `4.18` 或 `v4.18`,去掉 `v` 后必须与 VERSION 一致。 - 发布 tag 可写成 `4.18.1` 或 `v4.18.1`,去掉 `v` 后必须与 VERSION 一致。
发版时先更新 VERSION 并提交,再创建同版本 tag。 发版时先更新 VERSION 并提交,再创建同版本 tag。
+1 -1
View File
@@ -1 +1 @@
4.18 4.18.1
+1
View File
@@ -85,6 +85,7 @@ local-api = true
# Merge Mining (Optional) # Merge Mining (Optional)
# ============================================================================= # =============================================================================
# Tari merge mining (this build includes gRPC, so tari:// is supported) # Tari merge mining (this build includes gRPC, so tari:// is supported)
# v4.18.1+: requires Tari node v6.0.0 or newer (new Tari merge mining data format).
# Format: tari://<tari_node_ip>:<port> <tari_wallet_address> # Format: tari://<tari_node_ip>:<port> <tari_wallet_address>
# merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS # merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS
# #
+1 -1
View File
@@ -4,7 +4,7 @@ set -e
# 参数检查 # 参数检查
if [ $# -ne 3 ]; then if [ $# -ne 3 ]; then
echo "Usage: $0 <ARCH> <VERSION> <TARGZ_FILE>" echo "Usage: $0 <ARCH> <VERSION> <TARGZ_FILE>"
echo "Example: $0 amd64 4.18 p2pool-amd64-linux-static-4.18.tar.gz" echo "Example: $0 amd64 4.18.1 p2pool-amd64-linux-static-4.18.1.tar.gz"
exit 1 exit 1
fi fi