feat: 优化配置文件格式并完善文档系统
- 新增详细配置示例文件(conf/params.example.conf),包含所有配置项的详细中文说明 - 配置文件采用清晰的章节分组和双语注释(英文标题 + 中文说明) - 新增配置项:sync-pruned-blocks、limit-rate-up、limit-rate-down - 默认启用 P2P 网络绑定(0.0.0.0:18080) - 更新项目文档索引并同步配置参考文档
This commit is contained in:
388
conf/params.example.conf
Normal file
388
conf/params.example.conf
Normal file
@@ -0,0 +1,388 @@
|
|||||||
|
# Mond Configuration File
|
||||||
|
# ============================================================================
|
||||||
|
# This file is automatically created during installation
|
||||||
|
# Edit this file to customize your Mond daemon settings
|
||||||
|
# After modifying, restart the service: sudo systemctl restart mond.service
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
# DATA STORAGE
|
||||||
|
# ============================================================================
|
||||||
|
# data-dir: 区块链数据存储目录
|
||||||
|
# - 包含完整的区块链数据、交易池和节点状态
|
||||||
|
# - 确保该目录所在磁盘有足够空间(完整节点需要 150GB+,修剪节点需要 50GB+)
|
||||||
|
# - 默认位置: ~/.bitmonero (用户安装) 或 /var/lib/mond (系统服务)
|
||||||
|
data-dir=/var/lib/mond/data
|
||||||
|
|
||||||
|
# BLOCKCHAIN PRUNING
|
||||||
|
# ============================================================================
|
||||||
|
# prune-blockchain: 启用区块链修剪模式
|
||||||
|
# - 1 = 启用修剪,只保留最近的区块数据和必要的历史信息
|
||||||
|
# - 0 = 禁用修剪,保留完整的区块链历史(默认)
|
||||||
|
# - 优点: 大幅减少磁盘使用(从 150GB+ 降至 50GB 左右)
|
||||||
|
# - 缺点: 无法向其他节点提供完整的历史区块数据
|
||||||
|
# - 注意: 修剪节点仍然可以完全验证区块链,只是不存储所有旧数据
|
||||||
|
prune-blockchain=1
|
||||||
|
|
||||||
|
# sync-pruned-blocks: 同步修剪后的区块
|
||||||
|
# - 1 = 允许从其他修剪节点同步数据(推荐)
|
||||||
|
# - 0 = 仅从完整节点同步
|
||||||
|
# - 建议与 prune-blockchain=1 一起使用,加速初始同步
|
||||||
|
sync-pruned-blocks=1
|
||||||
|
|
||||||
|
# ZMQ NOTIFICATION SYSTEM
|
||||||
|
# ============================================================================
|
||||||
|
# zmq-pub: ZeroMQ 发布接口,用于实时广播区块链事件
|
||||||
|
# - tcp://IP:PORT 格式指定绑定地址和端口
|
||||||
|
# - 127.0.0.1 = 仅本地访问(推荐,除非需要远程订阅)
|
||||||
|
# - 18083 = 默认 ZMQ 端口(可修改)
|
||||||
|
# - 用途: P2Pool 挖矿、实时监控工具、区块浏览器等
|
||||||
|
# - 发布的事件类型:
|
||||||
|
# * json-full-chain_main: 新区块添加到主链
|
||||||
|
# * json-full-txpool_add: 新交易进入交易池
|
||||||
|
# * json-minimal-chain_main: 简化的新区块信息
|
||||||
|
# * json-minimal-txpool_add: 简化的新交易信息
|
||||||
|
# - 如需外部访问,改为 tcp://0.0.0.0:18083 并添加 confirm-external-bind=1
|
||||||
|
zmq-pub=tcp://127.0.0.1:18083
|
||||||
|
|
||||||
|
# NETWORK PEER SETTINGS
|
||||||
|
# ============================================================================
|
||||||
|
# out-peers: 主动连接的对等节点数量(出站连接)
|
||||||
|
# - 默认: 8,这里设置为 32 可提高网络连接性和同步速度
|
||||||
|
# - 范围: 0-1000,推荐值: 8-64
|
||||||
|
# - 更多出站连接 = 更快的区块传播,但消耗更多带宽和资源
|
||||||
|
out-peers=32
|
||||||
|
|
||||||
|
# in-peers: 接受连接的对等节点数量(入站连接)
|
||||||
|
# - 默认: 无限制,这里设置为 64 可平衡网络贡献和资源消耗
|
||||||
|
# - 范围: 0-无限,推荐值: 32-128
|
||||||
|
# - 入站连接有助于网络去中心化,但需要开放 P2P 端口(18080)
|
||||||
|
in-peers=64
|
||||||
|
|
||||||
|
# limit-rate-up: 上传速率限制(kB/s,千字节/秒)
|
||||||
|
# - 1024 kB/s = 1 MB/s = 8 Mbps
|
||||||
|
# - 默认: 8192 kB/s = 8 MB/s = 64 Mbps
|
||||||
|
# - -1 = 无限制(不推荐,可能耗尽带宽)
|
||||||
|
# - 根据网络带宽调整,建议保留部分带宽给其他应用
|
||||||
|
# - 计算公式: (总上传带宽 Mbps * 1024) / 8 = kB/s
|
||||||
|
# - 示例:
|
||||||
|
# * 10 Mbps 上传 → limit-rate-up=1280 (10 * 1024 / 8)
|
||||||
|
# * 50 Mbps 上传 → limit-rate-up=6400 (50 * 1024 / 8)
|
||||||
|
# * 100 Mbps 上传 → limit-rate-up=12800 (100 * 1024 / 8)
|
||||||
|
limit-rate-up=1048576
|
||||||
|
|
||||||
|
# limit-rate-down: 下载速率限制(kB/s,千字节/秒)
|
||||||
|
# - 1024 kB/s = 1 MB/s = 8 Mbps
|
||||||
|
# - 默认: 32768 kB/s = 32 MB/s = 256 Mbps
|
||||||
|
# - -1 = 无限制(初始同步时推荐)
|
||||||
|
# - 同步完成后可设置限制,节省带宽
|
||||||
|
# - 注意: 限制过低会影响区块同步速度
|
||||||
|
# - 示例:
|
||||||
|
# * 50 Mbps 下载 → limit-rate-down=6400 (50 * 1024 / 8)
|
||||||
|
# * 100 Mbps 下载 → limit-rate-down=12800 (100 * 1024 / 8)
|
||||||
|
# * 无限制(推荐初始同步)→ limit-rate-down=-1
|
||||||
|
limit-rate-down=1048576
|
||||||
|
|
||||||
|
# PRIORITY NODES
|
||||||
|
# ============================================================================
|
||||||
|
# add-priority-node: 优先连接的可信节点
|
||||||
|
# - 格式: 域名:端口 或 IP:端口
|
||||||
|
# - 节点会优先与这些节点建立连接并保持连接
|
||||||
|
# - 用途:
|
||||||
|
# * 加速初始同步(连接到高速节点)
|
||||||
|
# * 提高网络可靠性(连接到稳定节点)
|
||||||
|
# * 优先从可信来源获取区块
|
||||||
|
# - 可以添加多个优先节点(重复使用此选项)
|
||||||
|
# - 这些节点必须开放 P2P 端口(通常是 18080)
|
||||||
|
add-priority-node=p2pmd.xmrvsbeast.com:18080
|
||||||
|
add-priority-node=nodes.hashvault.pro:18080
|
||||||
|
|
||||||
|
# 可以添加更多优先节点:
|
||||||
|
# add-priority-node=node.supportxmr.com:18080
|
||||||
|
# add-priority-node=node.moneroworld.com:18080
|
||||||
|
# add-priority-node=opennode.xmr-tw.org:18080
|
||||||
|
|
||||||
|
# SECURITY AND NETWORK INTEGRITY
|
||||||
|
# ============================================================================
|
||||||
|
# enforce-dns-checkpointing: 强制执行 DNS 检查点验证
|
||||||
|
# - 1 = 启用(推荐),通过 DNS TXT 记录验证区块链检查点
|
||||||
|
# - 0 = 禁用
|
||||||
|
# - 作用: 防止长期离线后被恶意分叉欺骗
|
||||||
|
# - DNS 检查点由 Monero 核心开发者维护
|
||||||
|
# - 安全增强措施,几乎没有缺点
|
||||||
|
enforce-dns-checkpointing=1
|
||||||
|
|
||||||
|
# enable-dns-blocklist: 启用 DNS 黑名单
|
||||||
|
# - 1 = 启用(推荐),阻止连接到已知的恶意节点
|
||||||
|
# - 0 = 禁用
|
||||||
|
# - 黑名单通过 DNS 记录维护,包含:
|
||||||
|
# * Sybil 攻击节点
|
||||||
|
# * 已知的恶意节点
|
||||||
|
# * 降低网络性能的节点
|
||||||
|
# - 提高网络安全性和连接质量
|
||||||
|
enable-dns-blocklist=1
|
||||||
|
|
||||||
|
# P2P AND RPC NETWORK BINDING
|
||||||
|
# ============================================================================
|
||||||
|
# 以下配置控制节点的网络接口绑定
|
||||||
|
# 默认全部注释掉(使用内置默认值)
|
||||||
|
# 根据使用场景取消注释并修改
|
||||||
|
|
||||||
|
# --- P2P 绑定设置 ---
|
||||||
|
# p2p-bind-ip: P2P 网络监听地址
|
||||||
|
# - 0.0.0.0 = 监听所有网络接口(公网+内网+本地)
|
||||||
|
# - 127.0.0.1 = 仅本地访问(不接受外部节点连接)
|
||||||
|
# - 192.168.x.x = 仅内网访问
|
||||||
|
# - 默认: 0.0.0.0(接受所有连接)
|
||||||
|
# 使用场景:
|
||||||
|
# * 公共节点: 0.0.0.0(贡献网络,需开放防火墙 18080 端口)
|
||||||
|
# * 私有节点: 127.0.0.1(不接受入站连接,仅主动连接其他节点)
|
||||||
|
#p2p-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# p2p-bind-port: P2P 网络监听端口
|
||||||
|
# - 18080 = 主网默认端口
|
||||||
|
# - 28080 = 测试网 (testnet) 端口
|
||||||
|
# - 38080 = 预发布网 (stagenet) 端口
|
||||||
|
# - 使用非标准端口可以减少扫描攻击,但会降低网络发现性
|
||||||
|
#p2p-bind-port=18080
|
||||||
|
|
||||||
|
# --- RPC 绑定设置 ---
|
||||||
|
# rpc-bind-ip: RPC 接口监听地址
|
||||||
|
# - 0.0.0.0 = 监听所有网络接口(危险!需要配合认证和 SSL)
|
||||||
|
# - 127.0.0.1 = 仅本地访问(推荐,安全)
|
||||||
|
# - 192.168.x.x = 仅内网访问
|
||||||
|
# - 默认: 127.0.0.1(仅本地)
|
||||||
|
# ⚠️ 安全警告:
|
||||||
|
# * RPC 端口有完整控制权限,暴露到公网极度危险!
|
||||||
|
# * 如果必须远程访问,必须配置:
|
||||||
|
# 1. rpc-login (用户名密码)
|
||||||
|
# 2. rpc-ssl (SSL/TLS 加密)
|
||||||
|
# 3. 防火墙规则(限制访问 IP)
|
||||||
|
# * 推荐使用 SSH 隧道代替直接暴露
|
||||||
|
#rpc-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# rpc-bind-port: RPC 接口监听端口
|
||||||
|
# - 18081 = 主网默认 RPC 端口
|
||||||
|
# - 28081 = 测试网 RPC 端口
|
||||||
|
# - 38081 = 预发布网 RPC 端口
|
||||||
|
# - 用于本地钱包、P2Pool、管理工具连接
|
||||||
|
#rpc-bind-port=18081
|
||||||
|
|
||||||
|
# --- 公共受限 RPC (推荐用于公共服务) ---
|
||||||
|
# rpc-restricted-bind-ip: 受限 RPC 监听地址
|
||||||
|
# - 仅提供只读 API,不能发送交易或控制节点
|
||||||
|
# - 可以安全绑定到 0.0.0.0 提供公共查询服务
|
||||||
|
# - 不返回隐私敏感数据
|
||||||
|
# 使用场景: 公共区块浏览器、轻钱包后端、查询服务
|
||||||
|
#rpc-restricted-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# rpc-restricted-bind-port: 受限 RPC 监听端口
|
||||||
|
# - 推荐使用与标准 RPC 不同的端口(如 18089)
|
||||||
|
# - 可以与标准 RPC 同时运行
|
||||||
|
#rpc-restricted-bind-port=18089
|
||||||
|
|
||||||
|
# --- 启用受限 RPC 模式 ---
|
||||||
|
# restricted-rpc: 将绑定的 RPC 端口设为受限模式
|
||||||
|
# - 必须与 rpc-restricted-bind-port 配合使用
|
||||||
|
# - 限制可用的 RPC 方法,禁止敏感操作
|
||||||
|
#restricted-rpc=1
|
||||||
|
|
||||||
|
# confirm-external-bind: 确认外部网络绑定
|
||||||
|
# - 1 = 明确确认将服务绑定到非本地地址
|
||||||
|
# - 安全措施: 防止误将服务暴露到公网
|
||||||
|
# - 当使用 0.0.0.0 或非 127.0.0.1 地址时必须添加此选项
|
||||||
|
# - 适用于: p2p-bind-ip, rpc-bind-ip, rpc-restricted-bind-ip, zmq-pub
|
||||||
|
#confirm-external-bind=1
|
||||||
|
|
||||||
|
# RPC AUTHENTICATION
|
||||||
|
# ============================================================================
|
||||||
|
# rpc-login: RPC 访问认证凭据
|
||||||
|
# - 格式: username:password
|
||||||
|
# - ⚠️ 强制要求: 当 rpc-bind-ip 不是 127.0.0.1 时必须配置
|
||||||
|
# - 密码要求:
|
||||||
|
# * 至少 16 字符
|
||||||
|
# * 包含大小写字母、数字、特殊字符
|
||||||
|
# * 避免使用字典词汇
|
||||||
|
# - 生成强密码命令:
|
||||||
|
# openssl rand -base64 32
|
||||||
|
# pwgen -s 32 1
|
||||||
|
# - 示例: rpc-login=admin:xK9mP2vL8qR5nW7jT3hY6fB4sD1gA0cE
|
||||||
|
# - 客户端连接示例:
|
||||||
|
# curl -u admin:password http://127.0.0.1:18081/json_rpc
|
||||||
|
# mond-wallet-cli --daemon-address admin:password@node.example.com:18081
|
||||||
|
#rpc-login=user:password
|
||||||
|
|
||||||
|
# RPC SSL/TLS ENCRYPTION
|
||||||
|
# ============================================================================
|
||||||
|
# rpc-ssl: 启用 RPC 连接的 SSL/TLS 加密
|
||||||
|
# - enabled = 强制使用 SSL(推荐用于远程访问)
|
||||||
|
# - disabled = 禁用 SSL(仅本地访问时可用)
|
||||||
|
# - autodetect = 自动检测客户端支持情况(默认)
|
||||||
|
# - ⚠️ 远程访问必须启用 SSL,否则密码明文传输!
|
||||||
|
# - 需要配合 rpc-ssl-certificate 和 rpc-ssl-private-key
|
||||||
|
#rpc-ssl=enabled
|
||||||
|
|
||||||
|
# rpc-ssl-certificate: SSL 证书文件路径
|
||||||
|
# - PEM 格式的 SSL/TLS 证书
|
||||||
|
# - 可以使用自签名证书或由 CA 签发的证书
|
||||||
|
# - 生成自签名证书(仅用于测试):
|
||||||
|
# openssl req -newkey rsa:4096 -nodes -keyout key.pem \
|
||||||
|
# -x509 -days 365 -out cert.pem
|
||||||
|
# - 生产环境推荐使用 Let's Encrypt 免费证书:
|
||||||
|
# certbot certonly --standalone -d your-node.example.com
|
||||||
|
# - Let's Encrypt 证书路径:
|
||||||
|
# /etc/letsencrypt/live/your-domain/fullchain.pem
|
||||||
|
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
||||||
|
|
||||||
|
# rpc-ssl-private-key: SSL 私钥文件路径
|
||||||
|
# - PEM 格式的私钥文件
|
||||||
|
# - ⚠️ 安全要求:
|
||||||
|
# * 文件权限必须是 600 (chmod 600 key.pem)
|
||||||
|
# * 所有者必须是运行 mond 的用户
|
||||||
|
# * 不要将私钥文件暴露到公共位置
|
||||||
|
# - Let's Encrypt 私钥路径:
|
||||||
|
# /etc/letsencrypt/live/your-domain/privkey.pem
|
||||||
|
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
||||||
|
|
||||||
|
# rpc-ssl-ca-certificates: CA 证书路径(可选)
|
||||||
|
# - 用于验证客户端证书(双向 SSL)
|
||||||
|
# - 大多数情况下不需要
|
||||||
|
#rpc-ssl-ca-certificates=/path/to/ca-bundle.pem
|
||||||
|
|
||||||
|
# rpc-ssl-allow-any-cert: 允许任何证书(不推荐)
|
||||||
|
# - 1 = 禁用客户端证书验证
|
||||||
|
# - 0 = 验证客户端证书(默认)
|
||||||
|
# - ⚠️ 仅用于测试,生产环境不要启用
|
||||||
|
#rpc-ssl-allow-any-cert=0
|
||||||
|
|
||||||
|
# rpc-access-control-origins: CORS 跨域访问控制(可选)
|
||||||
|
# - 允许从特定域名的 Web 应用访问 RPC
|
||||||
|
# - 格式: http://domain.com 或多个域名用逗号分隔
|
||||||
|
# - 用于 Web 钱包、区块浏览器等前端应用
|
||||||
|
# - 示例: https://wallet.example.com,https://explorer.example.com
|
||||||
|
# - 使用 * 允许所有域名(不推荐)
|
||||||
|
#rpc-access-control-origins=https://your-domain.com
|
||||||
|
|
||||||
|
# LOGGING SETTINGS
|
||||||
|
# ============================================================================
|
||||||
|
# log-level: 日志详细程度
|
||||||
|
# - 0 = 最小化日志(仅关键错误)
|
||||||
|
# - 1 = 错误级别(推荐用于生产环境)
|
||||||
|
# - 2 = 警告级别(包含潜在问题)
|
||||||
|
# - 3 = 信息级别(当前设置,常规操作信息)
|
||||||
|
# - 4 = 调试级别(详细的调试信息,仅用于故障排查)
|
||||||
|
# - 更高级别 = 更多日志输出,但也消耗更多磁盘 I/O
|
||||||
|
# - 建议:
|
||||||
|
# * 生产环境: 1 或 2
|
||||||
|
# * 开发/调试: 3 或 4
|
||||||
|
# * 初始同步: 3(监控同步进度)
|
||||||
|
log-level=3
|
||||||
|
|
||||||
|
# log-file: 日志文件保存路径
|
||||||
|
# - 所有日志输出将写入此文件
|
||||||
|
# - 确保目录存在且有写入权限
|
||||||
|
# - 文件会自动轮转(达到一定大小后创建新文件)
|
||||||
|
# - 查看日志命令:
|
||||||
|
# tail -f /var/log/mond/mond.log (实时查看)
|
||||||
|
# grep ERROR /var/log/mond/mond.log (搜索错误)
|
||||||
|
# - 日志管理:
|
||||||
|
# * 定期清理旧日志释放磁盘空间
|
||||||
|
# * 可配合 logrotate 自动管理
|
||||||
|
# * 推荐保留最近 7-30 天的日志
|
||||||
|
log-file=/var/log/mond/mond.log
|
||||||
|
|
||||||
|
# max-log-file-size: 单个日志文件最大大小(字节)
|
||||||
|
# - 达到此大小后自动创建新日志文件
|
||||||
|
# - 默认: 104850000 (约 100 MB)
|
||||||
|
# - 推荐值: 10485760 (10 MB) 到 104857600 (100 MB)
|
||||||
|
# - 示例: max-log-file-size=52428800 # 50 MB
|
||||||
|
#max-log-file-size=104850000
|
||||||
|
|
||||||
|
# max-log-files: 保留的日志文件数量
|
||||||
|
# - 超过此数量后删除最旧的日志文件
|
||||||
|
# - 默认: 50
|
||||||
|
# - 计算存储空间: max-log-file-size * max-log-files
|
||||||
|
# - 示例: 如果单文件 50MB,保留 20 个文件 = 1GB 空间
|
||||||
|
#max-log-files=50
|
||||||
|
|
||||||
|
# ADVANCED OPTIONS (COMMENTED OUT)
|
||||||
|
# ============================================================================
|
||||||
|
# 以下是一些高级选项,默认不启用,根据需求取消注释
|
||||||
|
|
||||||
|
# --- 数据库设置 ---
|
||||||
|
# db-sync-mode: 数据库同步模式
|
||||||
|
# - fast:async:250000000bytes = 快速异步模式(默认,推荐)
|
||||||
|
# - fast:sync = 快速同步模式(更安全但稍慢)
|
||||||
|
# - fastest:async:250000000bytes = 最快模式(性能优先)
|
||||||
|
# - safe = 最安全模式(每次写入都刷盘,非常慢)
|
||||||
|
# 影响: 同步速度 vs 断电时的数据完整性
|
||||||
|
#db-sync-mode=fast:async:250000000bytes
|
||||||
|
|
||||||
|
# --- 区块同步设置 ---
|
||||||
|
# block-sync-size: 每次同步请求的区块数量
|
||||||
|
# - 默认: 20
|
||||||
|
# - 范围: 1-100,更大的值可能加快同步但消耗更多内存
|
||||||
|
#block-sync-size=20
|
||||||
|
|
||||||
|
# prep-blocks-threads: 预处理区块的线程数
|
||||||
|
# - 默认: 4
|
||||||
|
# - 根据 CPU 核心数调整,建议为核心数的 50-100%
|
||||||
|
#prep-blocks-threads=4
|
||||||
|
|
||||||
|
# --- 带宽和连接设置 ---
|
||||||
|
# max-txpool-weight: 交易池最大权重(字节)
|
||||||
|
# - 默认: 648000000 (约 618 MB)
|
||||||
|
# - 限制内存中未确认交易的总大小
|
||||||
|
#max-txpool-weight=648000000
|
||||||
|
|
||||||
|
# pad-transactions: 填充交易大小(隐私增强)
|
||||||
|
# - 1 = 启用,将交易填充到标准大小
|
||||||
|
# - 0 = 禁用(默认)
|
||||||
|
# - 增强隐私但增加交易费用
|
||||||
|
#pad-transactions=0
|
||||||
|
|
||||||
|
# --- 挖矿设置 ---
|
||||||
|
# start-mining: 启动时开始挖矿
|
||||||
|
# - 格式: 钱包地址
|
||||||
|
# - 不推荐在 mond 直接挖矿,应使用专用挖矿软件或 P2Pool
|
||||||
|
#start-mining=YOUR_WALLET_ADDRESS
|
||||||
|
|
||||||
|
# mining-threads: 挖矿线程数
|
||||||
|
# - 仅在 start-mining 启用时有效
|
||||||
|
# - 推荐: CPU 核心数的 50-75%
|
||||||
|
#mining-threads=2
|
||||||
|
|
||||||
|
# --- 匿名网络支持 ---
|
||||||
|
# tx-proxy: 通过代理发送交易(增强隐私)
|
||||||
|
# - 格式: socks4a://IP:PORT 或 i2p://address
|
||||||
|
# - 用于通过 Tor/I2P 广播交易
|
||||||
|
# - 示例(Tor): tx-proxy=socks4a://127.0.0.1:9050
|
||||||
|
#tx-proxy=socks4a://127.0.0.1:9050
|
||||||
|
|
||||||
|
# anonymous-inbound: 匿名网络入站地址
|
||||||
|
# - 格式: address,port[,max_connections]
|
||||||
|
# - 允许通过 Tor/I2P 接收连接
|
||||||
|
# - 示例: anonymous-inbound=your_onion_address.onion:18083,127.0.0.1:18083,25
|
||||||
|
#anonymous-inbound=your_address.onion:18083,127.0.0.1:18083
|
||||||
|
|
||||||
|
# --- 性能优化 ---
|
||||||
|
# max-concurrency: 最大并发线程数
|
||||||
|
# - 默认: 0(自动检测 CPU 核心数)
|
||||||
|
# - 手动设置可限制 CPU 使用
|
||||||
|
#max-concurrency=0
|
||||||
|
|
||||||
|
# db-salvage: 尝试修复损坏的数据库
|
||||||
|
# - 1 = 启动时检查并修复
|
||||||
|
# - 0 = 不自动修复(默认)
|
||||||
|
# - 仅在数据库损坏时使用
|
||||||
|
#db-salvage=0
|
||||||
|
|
||||||
|
# --- 网络类型 ---
|
||||||
|
# testnet: 使用测试网络
|
||||||
|
# - 1 = 启用测试网(用于开发测试)
|
||||||
|
# - 0 = 使用主网(默认)
|
||||||
|
#testnet=0
|
||||||
|
|
||||||
|
# stagenet: 使用预发布网络
|
||||||
|
# - 1 = 启用预发布网(开发者测试环境)
|
||||||
|
# - 0 = 使用主网(默认)
|
||||||
|
#stagenet=0
|
||||||
78
debian/postinst
vendored
78
debian/postinst
vendored
@@ -30,45 +30,91 @@ if [ ! -f /var/lib/mond/params.conf ]; then
|
|||||||
# Edit this file to customize your Mond daemon settings
|
# Edit this file to customize your Mond daemon settings
|
||||||
# After modifying, restart the service: sudo systemctl restart mond.service
|
# After modifying, restart the service: sudo systemctl restart mond.service
|
||||||
|
|
||||||
# Data directory - where blockchain data is stored
|
# DATA STORAGE
|
||||||
|
# ============================================================================
|
||||||
|
# data-dir: 区块链数据存储目录
|
||||||
data-dir=/var/lib/mond/data
|
data-dir=/var/lib/mond/data
|
||||||
|
|
||||||
# Blockchain pruning - reduces disk usage by pruning old blockchain data
|
# BLOCKCHAIN PRUNING
|
||||||
|
# ============================================================================
|
||||||
|
# prune-blockchain: 启用区块链修剪模式
|
||||||
prune-blockchain=1
|
prune-blockchain=1
|
||||||
|
|
||||||
# ZMQ pub socket for notifications
|
# sync-pruned-blocks: 同步已修剪的区块(默认启用)
|
||||||
zmq-pub=tcp://127.0.0.1:18083
|
sync-pruned-blocks=1
|
||||||
|
|
||||||
# Network peer settings
|
# NETWORK PEER SETTINGS
|
||||||
|
# ============================================================================
|
||||||
|
# out-peers: 主动连接的对等节点数量(出站连接)
|
||||||
out-peers=32
|
out-peers=32
|
||||||
|
|
||||||
|
# in-peers: 接受连接的对等节点数量(入站连接)
|
||||||
in-peers=64
|
in-peers=64
|
||||||
|
|
||||||
# Priority nodes - trusted nodes to connect to
|
# limit-rate-up: 上传速率限制(kB/s)
|
||||||
|
limit-rate-up=1048576
|
||||||
|
|
||||||
|
# limit-rate-down: 下载速率限制(kB/s)
|
||||||
|
limit-rate-down=1048576
|
||||||
|
|
||||||
|
# PRIORITY NODES
|
||||||
|
# ============================================================================
|
||||||
|
# add-priority-node: 优先连接的可信节点
|
||||||
add-priority-node=p2pmd.xmrvsbeast.com:18080
|
add-priority-node=p2pmd.xmrvsbeast.com:18080
|
||||||
add-priority-node=nodes.hashvault.pro:18080
|
add-priority-node=nodes.hashvault.pro:18080
|
||||||
|
|
||||||
# DNS checkpointing and blocklist
|
# SECURITY AND NETWORK INTEGRITY
|
||||||
|
# ============================================================================
|
||||||
|
# enforce-dns-checkpointing: 强制执行 DNS 检查点验证
|
||||||
enforce-dns-checkpointing=1
|
enforce-dns-checkpointing=1
|
||||||
|
|
||||||
|
# enable-dns-blocklist: 启用 DNS 黑名单
|
||||||
enable-dns-blocklist=1
|
enable-dns-blocklist=1
|
||||||
|
|
||||||
# P2P and RPC bind settings
|
# ZMQ NOTIFICATION SYSTEM
|
||||||
#p2p-bind-ip=0.0.0.0
|
# ============================================================================
|
||||||
#p2p-bind-port=18080
|
# zmq-pub: ZeroMQ 发布接口,用于实时广播区块链事件
|
||||||
|
zmq-pub=tcp://127.0.0.1:18083
|
||||||
|
|
||||||
|
# P2P AND RPC NETWORK BINDING
|
||||||
|
# ============================================================================
|
||||||
|
# p2p-bind-ip: P2P 网络监听地址(默认启用,绑定所有网络接口)
|
||||||
|
p2p-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# p2p-bind-port: P2P 网络监听端口
|
||||||
|
p2p-bind-port=18080
|
||||||
|
|
||||||
|
# rpc-bind-ip: RPC 接口监听地址
|
||||||
#rpc-bind-ip=0.0.0.0
|
#rpc-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# rpc-bind-port: RPC 接口监听端口
|
||||||
#rpc-bind-port=18081
|
#rpc-bind-port=18081
|
||||||
|
|
||||||
|
# confirm-external-bind: 确认外部网络绑定
|
||||||
#confirm-external-bind=1
|
#confirm-external-bind=1
|
||||||
|
|
||||||
# RPC login credentials
|
# RPC AUTHENTICATION
|
||||||
|
# ============================================================================
|
||||||
|
# rpc-login: RPC 访问认证凭据
|
||||||
#rpc-login=user:password
|
#rpc-login=user:password
|
||||||
|
|
||||||
# Enable SSL for RPC connections
|
# RPC SSL/TLS ENCRYPTION
|
||||||
#rpc-ssl=1
|
# ============================================================================
|
||||||
|
# rpc-ssl: 启用 RPC 连接的 SSL/TLS 加密(语义更清晰的启用方式)
|
||||||
|
#rpc-ssl=enabled
|
||||||
|
|
||||||
|
# rpc-ssl-certificate: SSL 证书文件路径
|
||||||
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
||||||
|
|
||||||
|
# rpc-ssl-private-key: SSL 私钥文件路径
|
||||||
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
||||||
|
|
||||||
# Logging settings
|
# LOGGING SETTINGS
|
||||||
# Log levels: 0=minimal, 1=errors, 2=warnings, 3=info, 4=debug
|
# ============================================================================
|
||||||
log-level=3
|
# log-level: 日志详细程度(调整为详细日志级别)
|
||||||
|
log-level=1
|
||||||
|
|
||||||
|
# log-file: 日志文件保存路径
|
||||||
log-file=/var/log/mond/mond.log
|
log-file=/var/log/mond/mond.log
|
||||||
EOF
|
EOF
|
||||||
chown mond:mond /var/lib/mond/params.conf
|
chown mond:mond /var/lib/mond/params.conf
|
||||||
|
|||||||
@@ -7,6 +7,7 @@ Mond 是一个基于 Monero 的区块链项目,专注于隐私和去中心化
|
|||||||
|
|
||||||
### 项目概览
|
### 项目概览
|
||||||
- [项目背景](/overview/project-overview.md)
|
- [项目背景](/overview/project-overview.md)
|
||||||
|
- [系统配置参考](/reference/configuration.md)
|
||||||
|
|
||||||
### 构建指南
|
### 构建指南
|
||||||
- [如何构建项目](/guides/how-to-build.md)
|
- [如何构建项目](/guides/how-to-build.md)
|
||||||
@@ -16,3 +17,4 @@ Mond 是一个基于 Monero 的区块链项目,专注于隐私和去中心化
|
|||||||
|
|
||||||
### 参考
|
### 参考
|
||||||
- [常见问题](/reference/faq.md)
|
- [常见问题](/reference/faq.md)
|
||||||
|
- [配置文件详解](/reference/configuration.md)
|
||||||
@@ -7,7 +7,7 @@
|
|||||||
Debian/Ubuntu 系统包安装后,Mond 使用配置文件方式运行:
|
Debian/Ubuntu 系统包安装后,Mond 使用配置文件方式运行:
|
||||||
|
|
||||||
- **配置文件位置**: `/var/lib/mond/params.conf`
|
- **配置文件位置**: `/var/lib/mond/params.conf`
|
||||||
- **配置文件格式**: INI 格式,每行一个配置项
|
- **配置文件格式**: INI 格式,每行一个配置项,采用双语注释(英文大写标题 + 中文详细说明)
|
||||||
- **修改后生效**: 修改配置文件后需要重启服务
|
- **修改后生效**: 修改配置文件后需要重启服务
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -21,44 +21,91 @@ sudo systemctl restart mond.service
|
|||||||
### 配置文件示例
|
### 配置文件示例
|
||||||
|
|
||||||
```ini
|
```ini
|
||||||
# 数据目录
|
# DATA STORAGE
|
||||||
|
# ============================================================================
|
||||||
|
# data-dir: 区块链数据存储目录
|
||||||
data-dir=/var/lib/mond/data
|
data-dir=/var/lib/mond/data
|
||||||
|
|
||||||
# 区块链修剪
|
# BLOCKCHAIN PRUNING
|
||||||
|
# ============================================================================
|
||||||
|
# prune-blockchain: 启用区块链修剪模式
|
||||||
prune-blockchain=1
|
prune-blockchain=1
|
||||||
|
|
||||||
# ZMQ 发布端口
|
# sync-pruned-blocks: 同步已修剪的区块(默认启用)
|
||||||
zmq-pub=tcp://127.0.0.1:18083
|
sync-pruned-blocks=1
|
||||||
|
|
||||||
# 网络对等节点设置
|
# NETWORK PEER SETTINGS
|
||||||
|
# ============================================================================
|
||||||
|
# out-peers: 主动连接的对等节点数量(出站连接)
|
||||||
out-peers=32
|
out-peers=32
|
||||||
|
|
||||||
|
# in-peers: 接受连接的对等节点数量(入站连接)
|
||||||
in-peers=64
|
in-peers=64
|
||||||
|
|
||||||
# 优先节点
|
# limit-rate-up: 上传速率限制(kB/s)
|
||||||
|
limit-rate-up=1048576
|
||||||
|
|
||||||
|
# limit-rate-down: 下载速率限制(kB/s)
|
||||||
|
limit-rate-down=1048576
|
||||||
|
|
||||||
|
# PRIORITY NODES
|
||||||
|
# ============================================================================
|
||||||
|
# add-priority-node: 优先连接的可信节点
|
||||||
add-priority-node=p2pmd.xmrvsbeast.com:18080
|
add-priority-node=p2pmd.xmrvsbeast.com:18080
|
||||||
add-priority-node=nodes.hashvault.pro:18080
|
add-priority-node=nodes.hashvault.pro:18080
|
||||||
|
|
||||||
# DNS 检查点和黑名单
|
# SECURITY AND NETWORK INTEGRITY
|
||||||
|
# ============================================================================
|
||||||
|
# enforce-dns-checkpointing: 强制执行 DNS 检查点验证
|
||||||
enforce-dns-checkpointing=1
|
enforce-dns-checkpointing=1
|
||||||
|
|
||||||
|
# enable-dns-blocklist: 启用 DNS 黑名单
|
||||||
enable-dns-blocklist=1
|
enable-dns-blocklist=1
|
||||||
|
|
||||||
# P2P 和 RPC 绑定设置
|
# ZMQ NOTIFICATION SYSTEM
|
||||||
#p2p-bind-ip=0.0.0.0
|
# ============================================================================
|
||||||
#p2p-bind-port=18080
|
# zmq-pub: ZeroMQ 发布接口,用于实时广播区块链事件
|
||||||
|
zmq-pub=tcp://127.0.0.1:18083
|
||||||
|
|
||||||
|
# P2P AND RPC NETWORK BINDING
|
||||||
|
# ============================================================================
|
||||||
|
# p2p-bind-ip: P2P 网络监听地址(默认启用,绑定所有网络接口)
|
||||||
|
p2p-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# p2p-bind-port: P2P 网络监听端口
|
||||||
|
p2p-bind-port=18080
|
||||||
|
|
||||||
|
# rpc-bind-ip: RPC 接口监听地址
|
||||||
#rpc-bind-ip=0.0.0.0
|
#rpc-bind-ip=0.0.0.0
|
||||||
|
|
||||||
|
# rpc-bind-port: RPC 接口监听端口
|
||||||
#rpc-bind-port=18081
|
#rpc-bind-port=18081
|
||||||
|
|
||||||
|
# confirm-external-bind: 确认外部网络绑定
|
||||||
#confirm-external-bind=1
|
#confirm-external-bind=1
|
||||||
|
|
||||||
# RPC 认证
|
# RPC AUTHENTICATION
|
||||||
|
# ============================================================================
|
||||||
|
# rpc-login: RPC 访问认证凭据
|
||||||
#rpc-login=user:password
|
#rpc-login=user:password
|
||||||
|
|
||||||
# 启用 RPC SSL
|
# RPC SSL/TLS ENCRYPTION
|
||||||
#rpc-ssl=1
|
# ============================================================================
|
||||||
|
# rpc-ssl: 启用 RPC 连接的 SSL/TLS 加密(语义更清晰的启用方式)
|
||||||
|
rpc-ssl=enabled
|
||||||
|
|
||||||
|
# rpc-ssl-certificate: SSL 证书文件路径
|
||||||
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
||||||
|
|
||||||
|
# rpc-ssl-private-key: SSL 私钥文件路径
|
||||||
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
||||||
|
|
||||||
# 日志设置
|
# LOGGING SETTINGS
|
||||||
|
# ============================================================================
|
||||||
|
# log-level: 日志详细程度(调整为详细日志级别)
|
||||||
log-level=1
|
log-level=1
|
||||||
|
|
||||||
|
# log-file: 日志文件保存路径
|
||||||
log-file=/var/log/mond/mond.log
|
log-file=/var/log/mond/mond.log
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user