雨云面板服RCON项目实现远程命令

往期回顾:给腐竹爽到了?多功能MC服务器宣传网站还带后台!
视乎很多人不知道RCON或从来没有接触过

本教程适用于已部署 MCSManager(MCSM)面板或雨云MCSM面板服!

为了防止我写累死了!文章部分内容为DeepSeekV4生成,看前请注意辨别


前置条件

  • 已安装并运行 MCSManager(MCSM) 面板
  • 面板内托管的 Minecraft Java 版服务器正在运行
  • 拥有白名单管理系统的管理员权限
  • 服务器所在主机可被白名单系统的网络访问(公网 IP 或内网互通)

第一步:服务器开启 RCON

RCON(Remote Console)是 Minecraft 服务器内置的远程控制协议,需要在服务器配置文件中手动启用。

1.1 找到 server.properties

在 MCSM 面板中,进入对应服务器实例 → 文件管理,找到根目录下的 server.properties 文件并编辑。

1.2 修改以下三项配置

enable-rcon=true
rcon.port=25575
rcon.password=你自己设置的强密码

:warning: 注意事项:

  • rcon.port 默认为 25575,可自定义,但需确保该端口未被占用。
  • rcon.password 请设置为复杂密码,避免使用弱密码,防止未授权访问。
  • RCON 端口与游戏端口(默认 25565)相互独立,需分别放行。

1.3 保存并重启服务器

在 MCSM 面板中点击 重启 服务器,使配置生效。


第二步:MCSM 防火墙 / 网络确认

RCON 端口默认不对外暴露,需要确认以下网络设置:

2.1 云服务器安全组(如有)

若服务器部署在雨云等云平台,还需在云控制台的安全组中添加规则,放行 TCP 25575 端口。
如果是NAT类型服务器需要转发25575端口来实现通讯!但通讯端口为实际转发端口

:light_bulb: 建议: 推荐购买雨云服务器选购独立IP,效果最佳且不用转发端口!


第三步:在白名单系统中配置 RCON 连接

进入白名单管理系统的 白名单自动同步向导 页面,找到右侧 “审核后自动执行命令” 模块。

3.1 填写连接信息

字段 填写内容 示例
服务器地址 MCSM 所在服务器的 IP 或域名 123.45.67.89mc.example.com
端口 RCON 端口,与 server.properties 一致 25575
密码 RCON 密码,与 rcon.password 一致 WCNM114514

3.2 界面示意

┌─────────────────────────────────────────────────────┐
│  审核后自动执行命令                                    │
│                                                     │
│  服务器地址          端口      密码                    │
│  [ xxx.xx.xx.xx ]  [25575]  [**********]  [测试]     │
│                                                     │
│  不开自动同步也能用,审核后仍可一键复制命令。              │
└─────────────────────────────────────────────────────┘

第四步:配置自定义命令模板

“自定义命令模板” 区域,根据服务器所安装的白名单插件填写对应的命令格式。

4.1 常用命令模板示例

插件 / 场景 通过时执行 拒绝时执行
原版白名单 /whitelist add {mc_name} /whitelist remove {mc_name}
EasyWhitelist /easywl approve {mc_name} /easywl deny {mc_name}
ViaVersion / LuckPerms /lp user {mc_name} parent add default /lp user {mc_name} parent remove default
VMC 插件 /vmc approve {mc_name} /vmc reject {mc_name} {reason}

4.2 可用占位符说明

占位符 含义
{mc_name} 申请人的游戏 ID(Minecraft 用户名)
{reason} 审核备注(通过或拒绝时填写的原因)
{username} 网站用户名
{email} 用户邮箱
{app_id} 申请 ID
{user_id} 用户 ID
{source} 申请来源
{age_range} 年龄段

4.3 超时秒数

超时秒数 建议保持默认的 5 秒。若服务器网络延迟较高,可适当调大(如 114514)。

4.4 填写示例(以原版白名单为例)

通过时执行:/whitelist add {mc_name}
拒绝时执行:/whitelist remove {mc_name}
超时秒数:5

填写完成后,底部 实时预览 区域会用示例数据替换占位符,显示实际执行的命令:

通过时:/whitelist add xiaohu_sever
拒绝时:/whitelist remove xiaohu_sever

第五步:测试连接与验证

5.1 点击"测试"按钮

填写好服务器地址、端口和密码后,点击右侧的 [测试] 按钮。

  • :white_check_mark: 连接成功:提示连接成功,说明 RCON 配置正确,可以正常下发命令。
  • :cross_mark: 连接失败:那就受着吧

5.2 提交一条测试申请

  1. 用测试账号提交一条白名单申请。
  2. 管理员进行审核通过操作。
  3. 进入 MCSM 面板服务器控制台,确认是否收到并执行了对应命令
  4. 在游戏中用该账号尝试加入服务器,确认白名单生效。

常见问题排查

:cross_mark: 提示"连接超时"或"连接被拒绝"

可能原因及解决方法:

  1. RCON 未启用:检查 server.propertiesenable-rcon=true 是否已保存,服务器是否已重启。
  2. 端口未放行:检查服务器本机防火墙及云平台安全组是否放行了 RCON 端口(默认 25575)。
  3. IP/端口填写错误:确认填写的是服务器公网 IP,端口与 rcon.port 一致。
  4. 服务器未运行:确认 MCSM 中服务器实例处于运行中状态。

:cross_mark: 提示"密码错误"

检查白名单系统中填写的 RCON 密码与 server.properties 中的 rcon.password 是否完全一致(注意区分大小写)。

:cross_mark: 命令发送成功但白名单未生效

  1. 确认服务器 server.propertieswhite-list=true 已开启(原版白名单需要此项)。
  2. 确认命令模板中使用的命令与服务器安装的插件匹配。
  3. 在 MCSM 控制台手动执行一次命令,确认插件是否正常工作。

:cross_mark: 不想开自动同步,能否手动复制命令?

可以、即使不配置 RCON,审核时系统会生成好对应命令,管理员可手动复制


安全建议

  1. 使用强密码:RCON 密码应包含大小写字母、数字和特殊字符,长度不少于 16 位。
  2. 限制访问来源:如条件允许,建议通过防火墙规则限制 RCON 端口仅允许白名单系统所在 IP 访问。
  3. 内网优先:若白名单系统与 MCSM 在同一服务器或内网,使用 127.0.0.1 或内网 IP,避免 RCON 端口暴露到公网。
  4. 定期更换密码:定期修改 RCON 密码,修改后同步更新白名单系统中的配置。
  5. 不与游戏端口使用同一密码:避免密码复用带来的安全风险。

:pushpin: 文章部分内容为AI生成!大致教程基本一样