安装与部署

环境要求

单服安装

SQLite 是默认存储。安装和升级后请完整重启服务端，不要热加载经济插件。

MySQL 部署

修改 config.yml：

storage:
  type: mysql
  mysql:
    host: 127.0.0.1
    port: 3306
    database: database
    username: rondo
    password: "change-me"
    parameters: "useUnicode=true&characterEncoding=UTF-8&useSSL=false&allowPublicKeyRetrieval=true"
    pool-size: 10

这组默认参数适用于本机或可信内网直连。数据库经过不可信网络时，请配置并验证 TLS 证书，再按主配置中的说明替换 parameters。

跨服部署

1. 所有子服安装相同版本的 Rondo。
2. 全部节点设置 storage.type: mysql，并连接同一数据库。
3. 全部节点连接同一 Redis 逻辑库与 sync-channel。
4. 先启动一个节点并确认建表完成，再启动其余节点。

完整配置见跨服同步。MySQL 或 Redis 连接失败时，跨服模式不会启动。

从 SQLite 切换到 MySQL

当前版本没有自动 SQLite → MySQL 迁移命令。只修改 storage.type 会得到一套新的空数据库，旧余额不会自动转移。

迁移前请停服并备份 data.db，再使用外部脚本转换余额、兑换记录和流水。迁移完成后抽查玩家余额，确认无误再开放服务器。

故障排查

插件未启用

• 确认实际运行时为 Java 17+。
• 检查配置、数据库连接和 Blink 运行库下载错误。

MySQL 连接失败

• 检查数据库名、账号权限、parameters、TLS 与防火墙。

Redis 连接失败

• 检查地址、密码、TLS 与 ACL 权限。