AzerothCore私服搭建中无法进入角色创建界面的问题排查

问题现象描述

在基于AzerothCore搭建魔兽世界私服的过程中，用户遇到了一个典型问题：成功登录服务器后，无法进入角色创建界面，而是在选择服务器界面陷入循环。这种情况通常发生在Docker容器化部署环境下，特别是在修改了默认端口配置后。

环境配置

用户使用的是以下技术栈：

• 服务器系统：unRAID 7.0.1
• AzerothCore版本：master分支最新提交(094c15a)
• 部署方式：Docker Compose
• 客户端版本：3.3.5a(WOTLK)

问题排查过程

初步检查

首先需要确认的是网络连通性。用户已经确认以下几点：

1. 客户端与服务器处于同一局域网
2. 客户端realmlist已正确指向服务器LAN IP
3. 基础端口(3724)可以正常通信

端口配置问题

用户修改了默认的SOAP端口(7878改为7880)，这需要特别注意：

1. 修改了docker-compose文件中的端口映射配置
2. 但不确定是否同步修改了worldserver.conf配置文件

关键发现

经过深入排查，发现问题核心在于数据库中的realmlist表配置。虽然服务器在本地运行，但当客户端通过局域网连接时，realmlist表中的address字段不能设置为127.0.0.1，而应该设置为服务器的实际局域网IP地址。

解决方案

1. 修改realmlist表：

   • 登录MySQL数据库
   • 执行：UPDATE realmlist SET address='服务器局域网IP' WHERE id=1;

2. 端口配置验证：

   • 确保所有服务端口配置一致
   • 主端口：3724(authserver)
   • 世界服务器端口：8085(worldserver)
   • SOAP端口：7878(或自定义端口)

3. 防火墙设置：

   • 确认所有相关端口已在防火墙放行
   • 包括TCP和UDP协议

技术原理分析

魔兽世界客户端与服务器的连接流程分为两个阶段：

1. 认证阶段：通过3724端口与authserver通信
2. 世界服务器连接：通过realmlist表中配置的地址和端口连接worldserver

当realmlist表中配置为127.0.0.1时，客户端会尝试连接自己本地的8085端口，而不是实际的服务器地址，导致连接失败并陷入循环。

最佳实践建议

1. 生产环境部署：

   • 建议使用固定IP而非DHCP分配地址
   • 考虑使用域名而非IP，便于后期维护

2. Docker网络配置：

   • 使用host网络模式可简化端口配置
   • 或确保所有容器间网络互通

3. 日志分析：

   • 检查authserver和worldserver日志
   • 关注连接建立和认证过程

总结

这个案例展示了魔兽世界私服搭建中一个常见但容易被忽视的问题。关键在于理解客户端连接服务器的完整流程，以及各组件间的交互方式。通过正确配置realmlist表和使用一致的端口设置，可以解决大多数连接问题。对于Docker部署环境，还需要特别注意容器网络和端口映射的配置。