配置参考#
mudud 从 TOML 配置文件读取配置。该文件控制监听端口、执行模式、存储路径与 io_uring 行为。
文件位置#
显式指定 --cfg / -c 时只读取该路径;文件缺失或无效会报错,不会回退查找其他配置。未指定时依次查找 ./mudud.cfg、~/.mududb/mudud.cfg;都不存在则返回 NotFound。相对存储路径以服务端进程的工作目录为基准。
生成默认配置#
mudud init-cfg
配置字段#
下表列出生成配置的取值及可选字段默认值。手写 TOML 必须包含 mpk_path、db_path、listen_ip、http_listen_port、pg_listen_port 和 enable_async,解析器不会为它们补默认值。mudud init-cfg 写入 ./mudud.cfg,并会覆盖已有文件。
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
string |
|
应用包目录路径。 |
|
string |
|
数据库文件目录路径。 |
|
string |
|
监听 IP 地址。 |
|
u16 |
|
HTTP 管理 API 端口。 |
|
usize |
|
HTTP worker 线程数。 |
|
u16 |
|
PostgreSQL wire protocol 端口(仅 Legacy)。 |
|
string |
|
Wasm 组件 ABI 目标。允许值: |
|
boolean |
|
是否启用 WASI 组件运行时。 |
|
string |
|
|
|
u16 |
|
TCP 定帧协议端口。 |
|
boolean |
|
每个 worker 一个 TCP 监听器。 |
|
usize |
|
Worker 线程数。 |
|
u32 |
|
io_uring 完成队列深度。 |
|
boolean |
|
启用 io_uring accept multishot。 |
|
boolean |
|
启用 io_uring recv multishot。 |
|
boolean |
|
启用 io_uring fixed buffers。 |
|
boolean |
|
启用 io_uring fixed files。 |
|
string |
|
|
|
u64 |
|
io_uring 日志 chunk 大小,单位字节。 |
|
usize |
|
数据库页大小,单位字节。持久化配置;已有数据库变更该值需要迁移或重新初始化。 |
|
u64 |
|
组提交攒批窗口,单位微秒:排队中的 WAL 提交批在被 flush 驱动冲刷前可等待的时长。 |
|
string |
|
WAL 持久化模式: |
|
u64 |
|
|
服务端与路由模式#
server_mode:控制后端 I/O/运行时路径。Legacy:传统阻塞 I/O 路径,兼容性最好。IOUring:基于 Linux io_uring 的高性能异步 I/O。Tokio:基于 Tokio 的异步运行时。
routing_mode:控制请求如何路由到工作线程。ConnectionId(默认):基于连接标识符路由。PlayerId:基于应用层玩家/用户标识符路由。RemoteHash:基于远程地址或哈希键路由。
过程资源限制#
可选的 [invocation_limits] 表限制 WASM 过程执行。省略的字段使用下列默认值;修改后需要重启。所有取值必须大于零,memory_bytes 不能超过 total_memory_bytes,max_concurrent_per_app 不能超过 max_concurrent。该表中的未知字段会被拒绝。
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
usize |
|
单次调用中所有内存实例的线性内存总字节数。 |
|
u64 |
|
Wasm 指令燃料,含组件初始化。 |
|
u64 |
|
墙钟执行预算,单位毫秒,含事务建立。 |
|
usize |
|
编码后的过程或 host 调用输入大小上限。 |
|
usize |
|
编码后的过程或 host 调用输出大小上限。 |
|
u64 |
|
host 调用次数上限,含打开资源的调用。 |
|
usize |
|
同时打开的 worker 会话与文件句柄上限。 |
|
usize |
|
单次调用中表元素总数上限。 |
|
usize |
|
进程级获准并发过程调用数上限。 |
|
usize |
|
同名应用的获准并发调用数上限。 |
|
usize |
|
进程级预留 guest 线性内存预算。 |
复制#
可选的 [replication] 表配置主从流复制或 Raft 容错。缺省时服务器以单机运行。复制目前要求 server_mode = "Tokio";Legacy 和 IOUring 均会拒绝启动。[replication.stream] 与 [replication.raft] 子段必须且只能存在一个——存在的子段即模式。
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
u64 |
必填 |
本节点标识。首次启动时持久化到 |
|
u16 |
必填 |
复制与 Raft 通道监听端口;不得与 |
|
u64 |
|
复制流的流控窗口,单位为段。 |
|
u64 |
|
距上次快照后已提交 WAL 字节数超过该值时触发下一次按 worker 快照。必须大于零。 |
|
u64 |
|
WAL/暂存 GC 水位评估间隔,单位秒。必须大于零。 |
[replication.stream] —— 主从流复制(无 Raft):
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
boolean |
必填 |
本节点是否为配置的 primary;集群中恰好一个成员设为 |
|
boolean |
必填 |
primary 是否等待某个副本的持久化确认后再应答提交。 |
|
u64 |
|
同步复制等待超时,单位毫秒。 |
[replication.raft] —— Raft 共识容错:
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
u64 |
|
Raft 状态机 tick 间隔,单位毫秒。 |
|
u64 |
|
Raft 选举超时,单位为 tick。 |
集群成员以 [[replication.peers]] 条目列出,含 node_id、host、port。peer 列表必须非空、节点 ID 与地址不重复,且包含本节点的 node_id。流复制模式要求至少两个 peer。
备份#
可选的 [backup] 表配置基础备份与 WAL 归档。缺省时服务器以无备份方式运行:WAL 前缀 GC 直接回收 chunk,不做归档。备份工作流程见备份与恢复。
字段 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
string |
未设置 |
基础备份的写入目录; |
|
string |
未设置 |
已封口 WAL chunk 持续归档到的目录。 |
|
string |
|
|
示例 mudud.cfg#
mpk_path = "./mpk"
db_path = "./data"
listen_ip = "127.0.0.1"
http_listen_port = 8300
http_worker_threads = 1
pg_listen_port = 5432
tcp_listen_port = 9527
server_mode = "Tokio"
worker_threads = 0
io_uring_ring_entries = 1024
io_uring_accept_multishot = true
io_uring_recv_multishot = true
io_uring_enable_fixed_buffers = false
io_uring_enable_fixed_files = false
routing_mode = "ConnectionId"
enable_async = true
tcp_multi_port = false
log_chunk_size = 67108864
page_size = 4096
兼容性与升级规则请参见服务端配置契约。
[backup] 的 WAL 归档配置接入了 Tokio 后端的 worker 配置。当前 IOUring 启动路径没有将该配置传给 worker;其基础备份和逻辑导出管理端点不代表持续 WAL 归档已启用。本文的归档/PITR 流程应使用 Tokio。archive_mode = "always" 当前尚未将归档持久化接入提交确认门控。
完整集群示例见复制与 Raft 容错,各模式的监听端点见服务端管理。