创建并连接到 MySQL 数据库

一些插件、模组和应用程序将其数据存储在 MySQL 数据库中，而不是平面文件——它在大规模运行时速度更快，并允许多个服务器共享数据。ServerPrism 为每个服务器提供自己的数据库，只需点击几下即可创建。

创建数据库

1. 打开您的服务器并点击 Databases 选项卡。
2. 点击 Create Database / New Database。
3. （可选）设置一个名称或备注，以便您记住它的用途（例如 luckperms）。
4. 确认。面板会创建数据库和用户，并向您显示连接详细信息。

查找您的连接详细信息

创建后，Databases 选项卡会显示您连接所需的一切：

• Host — 数据库服务器地址。
• Port — 通常是 3306。
• Database name — 通常带前缀，例如 s5_luckperms。
• Username — 自动生成，例如 u5_xxxxxxxx。
• Password — 点击以显示或在需要时轮换它。

请妥善保管这些信息——任何拥有它们的人都可以读取和写入您的数据。

从插件或模组连接

大多数插件在其配置中都有一个 database 或 storage 部分。将详细信息粘贴进去。典型的 LuckPerms config.yml 看起来像这样：

storage-method: mysql
data:
  address: HOST:3306
  database: s5_luckperms
  username: u5_xxxxxxxx
  password: 'your-password'

在 File Manager 中保存配置并重启服务器，以便插件重新连接。字段名称因插件而异——请查阅其自己的文档，但 host/port/database/username/password 值始终是 Databases 选项卡中的值。

从外部工具连接

要自行浏览或编辑数据，请使用 HeidiSQL、DBeaver 或 MySQL Workbench 等客户端。输入相同的 Host、Port、Username、Password 和 Database。如果出于安全原因限制了外部访问，面板的内置数据库管理器允许您从浏览器运行查询。

常见问题

• “Access denied for user”： 用户名或密码错误——从 Databases 选项卡重新复制（注意尾随空格）。
• “Unknown database”： 数据库名称通常带有前缀（例如 s5_）——使用面板中显示的精确名称，而不仅仅是您输入的备注。
• “Communications link failure” / 无法连接： 完全按照显示使用 Host 和 Port；不要替换为 localhost。
• 插件仍使用平面文件： 您没有将其 storage-method 切换到 mysql，或者在编辑配置后没有重启。

提示

• 每个插件一个数据库可以保持整洁，并使备份/恢复更容易理解。
• 如果您曾将密码粘贴到公共场所，请从面板轮换密码。
• 数据库计入每个计划的限制——需要更多或更大的数据库？请提交工单。