feat: 更新版本号至 v4.14，调整相关文档和配置示例

.gitea/workflows/ci.yaml

@@ -9,7 +9,7 @@ on:
 env:
   DOCKER_BUILDKIT: "1"
   PRODUCT_NAME: "p2pool"
-  PACKAGE_VERSION: "v4.13"
+  PACKAGE_VERSION: "v4.14"
   BUILDX_NO_DEFAULT_ATTESTATIONS: "1"
 
 jobs:

README.md

@@ -50,14 +50,14 @@ sudo systemctl enable --now p2pool.service
 # Alpine 构建（推荐，体积更小）
 docker buildx build --pull \
   --platform linux/amd64 \
-  --build-arg P2POOL_VERSION=v4.13 \
+  --build-arg P2POOL_VERSION=v4.14 \
   --output type=local,dest=./output \
   -f docker/Dockerfile.alpine .
 
 # Ubuntu 构建
 docker buildx build --pull \
   --platform linux/amd64 \
-  --build-arg P2POOL_VERSION=v4.13 \
+  --build-arg P2POOL_VERSION=v4.14 \
   --output type=local,dest=./output \
   -f docker/Dockerfile.ubuntu .
 ```

debian/build-deb.sh

@@ -4,7 +4,7 @@ set -e
 # 参数检查
 if [ $# -ne 3 ]; then
     echo "Usage: $0 <ARCH> <VERSION> <TARGZ_FILE>"
-    echo "Example: $0 amd64 v4.12 p2pool-amd64-ubuntu-v4.12.tar.gz"
+    echo "Example: $0 amd64 v4.14 p2pool-amd64-ubuntu-v4.14.tar.gz"
     exit 1
 fi
 

params.conf.example

@@ -1,5 +1,6 @@
 # P2Pool Configuration File Example
 # Copy this file to /var/lib/p2pool/params.conf and edit as needed
+# Compatible with: p2pool v4.14+
 
 # =============================================================================
 # Monero Node Connection (REQUIRED)
@@ -11,6 +12,7 @@ host = 127.0.0.1
 rpc-port = 18081
 
 # Monero ZMQ port (required for optimal performance)
+# v4.14+: ZMQ connections now support IPv6 addresses
 zmq-port = 18083
 
 # =============================================================================
@@ -29,6 +31,16 @@ p2p = 0.0.0.0:37889
 # Add known peer nodes (optional)
 # addpeers = node1.p2pool.io:37889,node2.p2pool.io:37889
 
+# HAProxy PROXY Protocol v2 for P2P connections (v4.14+)
+# Enable ONLY if p2pool's P2P port is behind a proxy that sends PROXY Protocol
+# v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
+# When enabled, the real client IP is extracted from the PROXY header and used
+# for peer management, ban checks and logging — instead of the proxy's IP.
+# P2P traffic is typically low-volume and usually does NOT need load balancing;
+# leave commented out unless you have a specific reason to proxy P2P.
+# Accepted values: none (default), v2
+# p2p-proxy-protocol = none
+
 # =============================================================================
 # API Settings
 # =============================================================================
@@ -50,15 +62,30 @@ local-api = true
 # =============================================================================
 # Enable stratum server for miners to connect
 # Format: <bind_ip>:<port>
-# Uncomment and configure if you want to connect mining software
 # stratum = 0.0.0.0:3333
 
+# HAProxy PROXY Protocol v2 for Stratum connections (v4.14+)
+# Enable ONLY if p2pool's Stratum port is behind a proxy that sends PROXY
+# Protocol v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
+# When enabled, miners' real IP addresses are correctly extracted and shown
+# in the `workers` command output, and per-IP ban/rate-limiting works properly.
+# This is an open standard also supported by nginx, Traefik, AWS ELB, etc.;
+# it is NOT tied to HAProxy specifically.
+#
+# ⚠️  TLV extensions (send-proxy-v2-ssl, send-proxy-v2-ssl-cn,
+#     unique-id-format, crc32c) are silently ignored — only the address block
+#     is read. Do NOT use exact addr_len checks in custom builds (spec §2.2
+#     allows senders to append TLV vectors, increasing addr_len beyond the
+#     base 12 / 36 bytes).
+#
+# Accepted values: none (default), v2
+# stratum-proxy-protocol = none
+
 # =============================================================================
 # Merge Mining (Optional)
 # =============================================================================
 # Enable Tari merge mining
 # Format: tari://<tari_node_ip>:<port> <tari_wallet_address>
-# Uncomment and configure if you want to merge mine Tari
 # merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS
 
 # =============================================================================
@@ -73,7 +100,6 @@ loglevel = 3
 # =============================================================================
 # Performance Tuning (Advanced)
 # =============================================================================
-# Number of light cache blocks to keep in RAM
 # in-peers = 10
 # out-peers = 10
 
@@ -82,3 +108,13 @@ loglevel = 3
 # =============================================================================
 # SOCKS5 proxy for outgoing connections
 # socks5 = 127.0.0.1:9050
+
+# SOCKS5 proxy type (v4.14+)
+# Controls how p2pool treats the SOCKS5 proxy configured above.
+# Accepted values:
+#   auto  — auto-detect whether it is a plain proxy or Tor (default)
+#   plain — treat as a standard SOCKS5 proxy (no Tor-specific behavior)
+#   tor   — treat as a Tor SOCKS5 proxy (enables onion routing optimizations,
+#            e.g. .onion peer resolution, correct onion connection counters)
+# Only meaningful when `socks5` is set; ignored otherwise.
+# socks5-proxy-type = auto