1. 为什么用Docker跑WOW服务端把WOW服务端塞进Docker里跑这个念头最早来自我自己的一个痛点每次换机器或者重装系统服务端环境就得从头来一遍MySQL版本不对、依赖库缺失、配置文件路径写死折腾一圈下来半天就没了。后来我把整套东西容器化之后迁移只需要拷贝一个目录docker compose up -d就完事这种体验上的差距是实打实的。WOW服务端本质上是一个C编写的大型网络服务程序它需要数据库支撑通常是MySQL或MariaDB、需要特定的运行库、需要开放多个端口给客户端连接。传统部署方式下这些东西全部耦合在宿主机上一旦某个环节出问题排查起来非常痛苦。Docker的价值就在于把这些组件拆成独立的容器每个容器只负责一件事通过网络互相通信出了问题也能快速定位是哪个环节的毛病。这篇文章适合几类人看一是有一定Linux基础、想自己搭个WOW服务端玩玩的朋友二是已经在用传统方式部署、想迁移到容器化方案的老玩家三是对Docker感兴趣、想拿一个真实项目练手的运维新手。不管你属于哪一类我都会把每一步的操作意图和背后的逻辑讲清楚让你不只是照抄命令而是真正理解自己在做什么。需要提前说明的是WOW服务端有很多分支版本不同版本对数据库结构、配置文件格式的要求差异很大。我这里以最常见的AzerothCore架构为例来展开它的社区活跃度高、文档相对完善、容器化支持也比较好。如果你用的是TrinityCore或其他分支思路是一样的具体配置项需要对照对应版本的文档调整。2. 整体架构设计与组件拆解2.1 容器划分逻辑一套完整的WOW服务端至少需要三个核心组件认证服务、世界服务和数据库。认证服务负责处理客户端登录请求验证账号密码世界服务负责游戏内的所有逻辑包括角色移动、战斗、任务、NPC行为等等数据库则存储账号信息、角色数据、世界数据怪物刷新、物品掉落、任务定义等。在Docker方案下我建议把这三大组件拆成独立的容器。认证服务和世界服务可以共用同一个镜像因为它们来自同一套代码编译产物但运行不同的入口程序。数据库单独使用官方MySQL镜像或MariaDB镜像。这样做的好处是数据库可以独立备份和恢复世界服务崩溃了不影响认证服务升级某个组件时不需要动其他部分。容器之间的通信通过Docker自定义网络实现。创建一个bridge网络把三个容器都接进去它们就可以通过容器名互相访问。比如世界服务的配置文件里写数据库地址时直接写数据库容器的名字就行Docker内置的DNS会自动解析。这比用IP地址靠谱得多因为容器重启后IP可能会变但容器名是固定的。2.2 数据持久化方案容器本身是无状态的删掉重建后里面的数据就没了。但数据库里的账号、角色、世界数据显然不能丢所以必须做持久化。Docker提供了volume和bind mount两种方式我个人更倾向于bind mount也就是把宿主机上的一个目录挂载到容器内部。原因很简单备份的时候直接拷贝宿主机目录就行不需要去记volume的名字也不需要用docker volume inspect去查路径。具体来说我会在宿主机上创建一个目录结构比如/opt/wow/data/mysql用来存数据库文件/opt/wow/data/world用来存世界服务的日志和持久化数据/opt/wow/etc用来存配置文件。然后通过volumes指令把这些目录映射到容器内的对应路径。这样即使把容器全部删掉只要这些目录还在重新up一下就能恢复如初。注意MySQL容器对数据目录的权限有要求如果宿主机目录的属主不对容器启动时会报权限错误。建议先把目录属主改成999MySQL容器内mysql用户的UID或者用chmod 777临时放开权限测试确认没问题后再收紧。2.3 镜像来源选择WOW服务端的镜像有两种获取方式自己编译和用社区现成的。自己编译的好处是可控性强可以针对自己的CPU架构做优化也能确保代码是最新的坏处是编译过程比较耗时而且需要一定的C编译环境知识。社区现成镜像的好处是开箱即用省去了编译环节坏处是版本可能滞后而且你不太清楚里面到底装了什么。我的建议是第一次搭建先用社区镜像跑通流程熟悉整个架构之后再尝试自己编译。AzerothCore官方在Docker Hub上有维护镜像可以直接拉取。如果你用的是ARM架构的设备比如某些开发板需要注意镜像是否支持多架构不支持的话就得自己编译。3. 环境准备与Docker安装要点3.1 操作系统选择与基础配置跑WOW服务端对系统资源有一定要求。内存方面数据库加两个服务进程至少需要4GB可用内存8GB以上会比较从容。CPU方面现代双核处理器就能跑起来但如果要支持较多玩家同时在线核心数越多越好。磁盘方面服务端程序本身不大但数据库和日志会持续增长建议预留至少20GB空间。操作系统我推荐Ubuntu 22.04 LTS或Debian 12这两个发行版的Docker支持最完善社区文档也最丰富。如果你用的是CentOS 7需要注意它的内核版本较老某些Docker新特性可能不支持而且CentOS 7已经停止维护长远来看建议迁移到其他发行版。安装Docker本身不复杂但有几个关键点容易踩坑。首先是安装源的选择官方源速度慢的话可以换国内镜像源但要注意镜像源的可靠性。其次是安装后的权限配置默认情况下只有root用户能执行docker命令普通用户需要加入docker组。执行sudo usermod -aG docker $USER之后需要重新登录才能生效这个步骤经常被忽略。3.2 Docker与Docker Compose安装实操在Ubuntu上安装Docker的完整流程如下。先更新包索引并安装必要的依赖sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release然后添加Docker官方GPG密钥和软件源sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null接下来安装Docker引擎和Compose插件sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin安装完成后验证一下sudo docker run hello-world如果能看到欢迎信息说明Docker安装成功。Compose插件现在通常以docker compose注意中间是空格的形式调用而不是老版本的docker-compose。两者功能基本一致但插件方式更推荐。提示如果你在Windows上想用Docker Desktop来跑需要确保BIOS里开启了虚拟化支持。很多品牌机默认是关闭的开机时按F2或Del进入BIOS设置找到Intel VT-x或AMD-V选项开启即可。开启后Docker Desktop才能正常启动。3.3 目录结构规划在开始写Compose文件之前先把目录结构规划好。我习惯用这样的布局/opt/wow/ ├── docker-compose.yml ├── etc/ │ ├── worldserver.conf │ └── authserver.conf ├── data/ │ ├── mysql/ │ └── world/ └── logs/ ├── worldserver/ └── authserver/这个结构清晰地把配置、数据、日志分开存放。etc目录挂载到容器内对应配置文件的位置data/mysql挂载到数据库容器的数据目录data/world和logs挂载到世界服务容器的相应路径。这样无论是备份还是排查问题都能快速找到需要的东西。创建目录的命令很简单sudo mkdir -p /opt/wow/{etc,data/mysql,data/world,logs/worldserver,logs/authserver}权限方面数据库目录需要特殊处理其他目录保持默认即可。4. 核心配置文件编写与参数详解4.1 Docker Compose编排文件Compose文件是整个方案的核心它定义了所有容器的运行方式、网络关系、挂载点和依赖顺序。下面是我实际使用的一个配置模板你可以根据自己的情况调整version: 3.8 services: mysql: image: mysql:8.0 container_name: wow-mysql restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: your_root_password MYSQL_DATABASE: acore_world MYSQL_USER: acore MYSQL_PASSWORD: your_acore_password volumes: - ./data/mysql:/var/lib/mysql networks: - wow-net command: --default-authentication-pluginmysql_native_password --character-set-serverutf8mb4 --collation-serverutf8mb4_unicode_ci authserver: image: azerothcore/authserver:latest container_name: wow-auth restart: unless-stopped depends_on: - mysql volumes: - ./etc/authserver.conf:/azerothcore/env/dist/etc/authserver.conf - ./logs/authserver:/azerothcore/env/dist/bin/logs ports: - 3724:3724 networks: - wow-net worldserver: image: azerothcore/worldserver:latest container_name: wow-world restart: unless-stopped depends_on: - mysql volumes: - ./etc/worldserver.conf:/azerothcore/env/dist/etc/worldserver.conf - ./data/world:/azerothcore/env/dist/bin/data - ./logs/worldserver:/azerothcore/env/dist/bin/logs ports: - 8085:8085 networks: - wow-net networks: wow-net: driver: bridge这个文件里几个关键点值得展开说。restart: unless-stopped保证容器在意外退出后自动重启除非你手动停了它。depends_on控制启动顺序确保数据库先起来再启动服务端。端口映射方面3724是认证端口8085是世界端口客户端连接时需要用到。4.2 数据库初始化与导入MySQL容器第一次启动时会自动创建MYSQL_DATABASE指定的数据库但WOW服务端需要的表结构和初始数据不会自动导入。你需要手动把服务端的SQL文件导入进去。AzerothCore的SQL文件通常分为三类基础结构、世界数据、更新补丁。导入的方式有几种。一种是在宿主机上安装MySQL客户端通过mysql -h 127.0.0.1 -P 3306 -u root -p连接容器内的数据库然后执行SQL文件。另一种是直接用docker exec进入容器操作docker exec -i wow-mysql mysql -uroot -pyour_root_password acore_world /path/to/world.sql导入之前要确保数据库字符集是utf8mb4否则中文内容会乱码。Compose文件里已经通过command参数设置了但如果你用的是已有的数据库需要手动检查一下。注意导入大型SQL文件时可能会遇到max_allowed_packet限制导致导入中断。可以在MySQL配置里把这个值调大比如设为64M或128M。在Compose的command里加上--max-allowed-packet128M即可。4.3 服务端配置文件关键项worldserver.conf和authserver.conf是服务端的核心配置文件里面有几百个参数但真正需要改的没几个。最关键的是数据库连接信息必须和Compose里定义的一致LoginDatabaseInfo wow-mysql;3306;acore;your_acore_password;acore_auth WorldDatabaseInfo wow-mysql;3306;acore;your_acore_password;acore_world CharacterDatabaseInfo wow-mysql;3306;acore;your_acore_password;acore_characters注意这里的主机名写的是容器名wow-mysql因为它们在同一个Docker网络里DNS可以直接解析。如果你把数据库换成了外部地址这里也要相应修改。另外几个值得关注的参数WorldServerPort默认是8085如果你宿主机上这个端口被占用了需要改掉DataDir指向数据目录确保和volume挂载的路径一致LogsDir指向日志目录。还有AllowPlayerBots之类的玩法参数根据自己需求调整。5. 启动流程与验证方法5.1 分步启动与日志观察一切就绪后在/opt/wow目录下执行docker compose up -d这个命令会按依赖顺序启动所有容器。启动完成后用docker compose ps查看状态正常情况下三个容器的状态都应该是Up。如果某个容器显示Exit或Restarting就需要看日志排查。查看日志的命令是docker compose logs -f 服务名比如docker compose logs -f worldserver。世界服务的启动过程比较长因为它要加载大量的地图数据和AI脚本第一次启动可能需要几分钟。日志里会显示加载进度看到World initialized之类的字样就说明启动成功了。认证服务的启动相对快一些日志里出现Authserver listening on port 3724就表示正常。数据库容器启动最快但要注意它初始化需要一点时间如果服务端启动时数据库还没准备好可能会连接失败。depends_on只能保证启动顺序不能保证数据库已经初始化完成所以第一次启动时如果服务端报连接错误等一会儿重启一下服务端容器就行。5.2 连通性测试服务端跑起来之后先在本机测试一下端口是否可达telnet 127.0.0.1 3724 telnet 127.0.0.1 8085如果连接被拒绝说明端口没有正确映射或者服务没有监听。可以用docker compose port authserver 3724查看实际映射的端口。如果宿主机有防火墙还需要放行这两个端口。数据库连通性可以用docker exec wow-mysql mysql -uacore -p -e SHOW DATABASES;来测试能看到acore_auth、acore_world、acore_characters三个库就说明正常。5.3 客户端连接配置客户端这边需要修改realmlist.wtf文件把地址指向你的服务器IP。如果是局域网内测试填宿主机的局域网IP即可如果是公网访问需要填公网IP并确保端口映射正确。客户端的版本必须和服务端匹配比如服务端是3.3.5a版本客户端也必须是3.3.5a版本不对会卡在登录界面或者直接报错。登录时用服务端数据库里创建的账号。如果还没有账号可以通过世界服务的控制台命令创建或者直接在acore_auth库的account表里插入一条记录。密码字段需要用特定的哈希算法生成不能直接存明文。6. 常见问题排查与避坑经验6.1 容器启动失败类问题数据库容器反复重启最常见的原因是数据目录权限不对。MySQL容器内的mysql用户UID通常是999如果宿主机目录属主不是999容器就无法写入。解决办法是sudo chown -R 999:999 /opt/wow/data/mysql。另一个原因是之前残留的数据文件版本不兼容比如从MySQL 5.7升级到8.0数据格式不兼容。这种情况需要清空数据目录重新初始化。服务端容器启动后立即退出大概率是配置文件有问题。用docker compose logs worldserver看具体报错常见的有数据库连接信息错误、配置文件路径不对、数据目录为空。如果是数据目录为空说明地图数据没有正确挂载或没有导入需要检查volume映射路径。端口被占用导致启动失败用ss -tlnp | grep 3724查看哪个进程占用了端口停掉它或者修改Compose里的端口映射。6.2 运行时报错类问题服务端启动时报数据库连接超时如果数据库容器刚启动不久可能是还没初始化完成。等30秒后重启服务端容器即可。如果一直连不上检查Compose里的网络配置确保两个容器在同一个network下。可以用docker exec wow-world ping wow-mysql测试网络连通性。客户端登录后卡在“正在连接”或“已断开”通常是端口映射或防火墙问题。确认3724和8085端口在宿主机上可达如果是云服务器还需要检查安全组规则。另外服务端配置文件里的RealmIP如果写的是内网地址外网客户端就连不上需要改成公网地址或者用域名。游戏内中文显示乱码说明数据库字符集不对。检查数据库、表和连接三个层面的字符集设置确保都是utf8mb4。已经导入的数据如果乱码了需要重新导入。6.3 性能与稳定性问题服务端运行一段时间后变卡可能是数据库查询变慢或者内存泄漏。先看docker stats确认哪个容器占用资源异常。数据库方面可以开启慢查询日志找出耗时长的SQL。世界服务方面定期重启可以缓解内存泄漏问题用restart: unless-stopped配合定时任务就能实现。玩家数量多时延迟高考虑给世界服务容器分配更多CPU和内存资源。在Compose里可以用deploy.resources限制或预留资源但注意这个配置在非Swarm模式下只有部分生效。更直接的方式是调整宿主机的资源分配或者把数据库迁移到独立的高性能机器上。6.4 常见问题速查表现象可能原因排查方法解决方式数据库容器反复重启数据目录权限错误docker logs wow-mysql修改目录属主为999服务端连不上数据库网络不通或密码错误docker exec wow-world ping wow-mysql检查网络配置和密码客户端卡登录端口未放行telnet IP 3724开放防火墙和安全组中文乱码字符集不统一检查数据库和表字符集统一改为utf8mb4启动时报缺少地图数据数据目录为空ls /opt/wow/data/world导入地图数据文件内存占用持续增长内存泄漏docker stats定期重启或升级版本7. 数据备份与版本升级策略7.1 数据库备份实操数据库是整个服务端最宝贵的资产角色数据丢了就全没了。备份方式我推荐用mysqldump导出SQL文件简单可靠docker exec wow-mysql mysqldump -uroot -pyour_root_password --all-databases /opt/wow/backup/all_$(date %Y%m%d).sql这个命令把所有数据库导出到一个SQL文件里文件名带日期方便管理。恢复的时候用docker exec -i wow-mysql mysql -uroot -p backup.sql即可。建议写个定时任务每天自动备份并且把备份文件同步到另一台机器或对象存储上防止宿主机磁盘故障导致备份一起丢失。提示mysqldump导出时会锁表如果服务端正在运行可能会造成短暂的卡顿。可以在低峰期执行或者加上--single-transaction参数减少锁的影响。7.2 服务端版本升级升级服务端版本时不能直接把新镜像拉下来就重启因为数据库结构可能发生了变化。正确的流程是先备份数据库然后查看新版本的更新说明确认是否有数据库迁移脚本需要执行。执行完迁移脚本后再更新镜像和重启容器。如果升级后出现问题需要回滚把镜像标签改回旧版本恢复数据库备份即可。这也是为什么我强调要用固定版本标签而不是latest因为latest随时可能变出了问题很难定位是哪个版本引入的。7.3 配置文件版本管理配置文件也建议纳入版本管理用Git或者简单的文件备份都行。每次修改配置前先备份一份改完之后记录改了什么、为什么改。这样出问题时可以快速对比和回滚。我自己的习惯是在/opt/wow/etc目录下建一个backup子目录每次改配置前把旧文件复制进去并加上时间戳。8. 我踩过的几个坑和实用技巧第一个坑是数据库字符集。我一开始没注意用默认的latin1建库结果所有中文NPC名字和任务描述全是问号。后来把数据库、表和连接字符集全部改成utf8mb4才解决。这个问题的隐蔽性在于英文内容完全正常只有中文才出问题所以很容易被忽略。第二个坑是容器时间不同步。WOW服务端有些功能依赖系统时间比如日常任务重置、怪物刷新计时等。如果容器时间和宿主机不一致这些功能就会出问题。解决办法是在Compose文件里把宿主机的/etc/localtime挂载到容器内或者设置TZ环境变量。第三个坑是日志文件无限增长。世界服务的日志非常详细运行几天就能涨到几个GB。如果不做日志轮转磁盘很快就会被占满。我现在的做法是在Compose里限制日志大小或者用logrotate定期清理。Docker本身的日志也可以限制在daemon.json里配置max-size和max-file。一个实用技巧是善用docker compose exec进入容器排查问题。比如docker compose exec worldserver bash进去之后可以直接查看文件、测试网络、运行调试命令比在宿主机上猜要高效得多。另一个技巧是把常用命令写成脚本比如启动、停止、备份、查看日志一键执行省去每次敲长命令的麻烦。最后分享一个关于性能调优的经验世界服务的性能瓶颈通常在数据库查询上。如果发现游戏内操作有延迟可以先看数据库的慢查询日志。给常用查询字段加索引、优化复杂的JOIN语句往往能带来明显的提升。另外把数据库的innodb_buffer_pool_size调大让更多数据缓存在内存里对性能也有帮助。这个值一般设为可用内存的50%到70%比较合适。