Wang Defa
b13d06aae7
- 新增详细配置示例文件（conf/params.example.conf），包含所有配置项的详细中文说明 - 配置文件采用清晰的章节分组和双语注释（英文标题 + 中文说明） - 新增配置项：sync-pruned-blocks、limit-rate-up、limit-rate-down - 默认启用 P2P 网络绑定（0.0.0.0:18080） - 更新项目文档索引并同步配置参考文档
206 lines
5.5 KiB
Markdown
206 lines
5.5 KiB
Markdown
# Mond 配置参考
|
||
|
||
## 配置文件
|
||
|
||
### Debian/Ubuntu 系统包配置文件
|
||
|
||
Debian/Ubuntu 系统包安装后，Mond 使用配置文件方式运行：
|
||
|
||
- **配置文件位置**: `/var/lib/mond/params.conf`
|
||
- **配置文件格式**: INI 格式，每行一个配置项，采用双语注释（英文大写标题 + 中文详细说明）
|
||
- **修改后生效**: 修改配置文件后需要重启服务
|
||
|
||
```bash
|
||
# 编辑配置文件
|
||
sudo nano /var/lib/mond/params.conf
|
||
|
||
# 重启服务使配置生效
|
||
sudo systemctl restart mond.service
|
||
```
|
||
|
||
### 配置文件示例
|
||
|
||
```ini
|
||
# DATA STORAGE
|
||
# ============================================================================
|
||
# data-dir: 区块链数据存储目录
|
||
data-dir=/var/lib/mond/data
|
||
|
||
# BLOCKCHAIN PRUNING
|
||
# ============================================================================
|
||
# prune-blockchain: 启用区块链修剪模式
|
||
prune-blockchain=1
|
||
|
||
# sync-pruned-blocks: 同步已修剪的区块（默认启用）
|
||
sync-pruned-blocks=1
|
||
|
||
# NETWORK PEER SETTINGS
|
||
# ============================================================================
|
||
# out-peers: 主动连接的对等节点数量（出站连接）
|
||
out-peers=32
|
||
|
||
# in-peers: 接受连接的对等节点数量（入站连接）
|
||
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=nodes.hashvault.pro:18080
|
||
|
||
# SECURITY AND NETWORK INTEGRITY
|
||
# ============================================================================
|
||
# enforce-dns-checkpointing: 强制执行 DNS 检查点验证
|
||
enforce-dns-checkpointing=1
|
||
|
||
# enable-dns-blocklist: 启用 DNS 黑名单
|
||
enable-dns-blocklist=1
|
||
|
||
# ZMQ NOTIFICATION SYSTEM
|
||
# ============================================================================
|
||
# 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-port: RPC 接口监听端口
|
||
#rpc-bind-port=18081
|
||
|
||
# confirm-external-bind: 确认外部网络绑定
|
||
#confirm-external-bind=1
|
||
|
||
# RPC AUTHENTICATION
|
||
# ============================================================================
|
||
# rpc-login: RPC 访问认证凭据
|
||
#rpc-login=user:password
|
||
|
||
# RPC SSL/TLS ENCRYPTION
|
||
# ============================================================================
|
||
# rpc-ssl: 启用 RPC 连接的 SSL/TLS 加密（语义更清晰的启用方式）
|
||
rpc-ssl=enabled
|
||
|
||
# rpc-ssl-certificate: SSL 证书文件路径
|
||
#rpc-ssl-certificate=/path/to/your/certificate.pem
|
||
|
||
# rpc-ssl-private-key: SSL 私钥文件路径
|
||
#rpc-ssl-private-key=/path/to/your/private_key.pem
|
||
|
||
# LOGGING SETTINGS
|
||
# ============================================================================
|
||
# log-level: 日志详细程度（调整为详细日志级别）
|
||
log-level=1
|
||
|
||
# log-file: 日志文件保存路径
|
||
log-file=/var/log/mond/mond.log
|
||
```
|
||
|
||
### 配置文件保护
|
||
|
||
配置文件在以下情况下**不会被覆盖**：
|
||
- 执行 `apt upgrade` 升级 mond 包时
|
||
- 重新安装 mond 包时
|
||
|
||
这确保了您的自定义配置不会在更新时丢失。
|
||
|
||
## 命令行选项
|
||
|
||
### 使用配置文件
|
||
|
||
```bash
|
||
--config-file <path> # 指定配置文件路径（推荐）
|
||
```
|
||
|
||
### 数据和日志控制
|
||
|
||
```bash
|
||
--data-dir <path> # 指定数据目录
|
||
--log-file <path> # 指定日志文件路径
|
||
--log-level <level> # 日志级别 (0-4)
|
||
--detach # 后台运行
|
||
```
|
||
|
||
### 网络配置
|
||
|
||
```bash
|
||
--rpc-bind-ip <ip> # RPC 绑定 IP (默认: 127.0.0.1)
|
||
--rpc-bind-port <port> # RPC 绑定端口 (默认: 18081)
|
||
--p2p-bind-ip <ip> # P2P 绑定 IP (默认: 0.0.0.0)
|
||
--p2p-bind-port <port> # P2P 绑定端口 (默认: 18080)
|
||
```
|
||
|
||
**注意**: 命令行参数会覆盖配置文件中的对应设置。
|
||
|
||
## 目录结构
|
||
|
||
### Debian/Ubuntu 系统包
|
||
|
||
```
|
||
/opt/mond/mond # 二进制文件
|
||
/var/lib/mond/params.conf # 配置文件
|
||
/var/lib/mond/data/ # 区块链数据目录
|
||
/var/log/mond/ # 日志目录
|
||
```
|
||
|
||
### 通用二进制包
|
||
|
||
```
|
||
./mond # 二进制文件
|
||
~/.mond/ # 默认数据目录
|
||
```
|
||
|
||
## Systemd 服务配置
|
||
|
||
### 服务文件位置
|
||
|
||
`/lib/systemd/system/mond.service`
|
||
|
||
### 关键配置段
|
||
|
||
```ini
|
||
[Service]
|
||
WorkingDirectory=/opt/mond
|
||
# 使用配置文件启动
|
||
ExecStart=/opt/mond/mond --config-file=/var/lib/mond/params.conf --non-interactive
|
||
User=mond
|
||
Group=mond
|
||
|
||
# 安全设置
|
||
NoNewPrivileges=true
|
||
PrivateTmp=true
|
||
ProtectSystem=strict
|
||
ProtectHome=true
|
||
ReadWritePaths=/var/lib/mond /var/lib/mond/data /var/log/mond
|
||
```
|
||
|
||
### 修改服务配置
|
||
|
||
systemd 服务文件使用 `--config-file` 参数，所有运行时配置都在配置文件中设置。
|
||
|
||
如需修改服务配置：
|
||
1. 编辑配置文件：`sudo nano /var/lib/mond/params.conf`
|
||
2. 重启服务：`sudo systemctl restart mond.service`
|
||
|
||
**不建议**直接修改 systemd 服务文件，因为包更新时可能会被覆盖。
|
||
|
||
## 日志级别
|
||
|
||
- `0`: 仅记录关键错误
|
||
- `1`: 记录错误和警告
|
||
- `2`: 标准日志级别（默认）
|
||
- `3`: 详细日志
|
||
- `4`: 调试级别（最详细） |