AzerothCore-WoTLK容器化部署：Docker一键搭建开发环境

你还在为搭建MMO服务器环境而烦恼吗？编译依赖冲突、数据库配置复杂、版本兼容性问题？本文将带你通过Docker容器技术，3步完成AzerothCore-WoTLK开发环境的搭建，即使是新手也能轻松上手。

什么是容器化部署

容器化部署（Container Deployment）是一种轻量级虚拟化技术，通过Docker将应用及其依赖打包成标准化单元，确保在任何环境中都能一致运行。对于AzerothCore-WoTLK这类复杂项目，容器化部署能显著降低环境配置难度，避免"在我电脑上能运行"的困境。

项目的Docker实现位于apps/docker/目录，包含完整的容器化配置文件和构建脚本。

准备工作

环境要求

在开始部署前，请确保你的系统已安装：

• Docker Engine (20.10+)
• Docker Compose (v2+)

Windows和Mac用户推荐安装Docker Desktop，Linux用户可通过系统包管理器安装。

获取项目代码

首先克隆AzerothCore-WoTLK仓库：

git clone https://gitcode.com/GitHub_Trending/az/azerothcore-wotlk
cd azerothcore-wotlk

部署步骤

1. 构建Docker镜像

项目提供了自动化构建脚本，执行以下命令开始构建容器镜像：

docker compose build

首次构建会下载依赖并编译源代码，根据网络环境可能需要30-60分钟。后续构建会利用缓存加速。

构建过程由apps/docker/Dockerfile定义，包含多个构建阶段：

• client-data: 处理游戏客户端数据
• db-import: 初始化数据库结构
• worldserver: 构建游戏服务器
• authserver: 构建认证服务器

2. 启动服务集群

构建完成后，使用docker compose一键启动所有服务：

docker compose up -d

该命令会启动以下服务组件（定义在docker-compose.yml中）：

服务名称	作用	依赖
ac-database	MySQL数据库服务	无
ac-db-import	数据库初始化	依赖ac-database
ac-authserver	账号认证服务器	依赖ac-db-import
ac-worldserver	游戏世界服务器	依赖ac-db-import和客户端数据
ac-client-data-init	客户端数据处理	无

服务启动状态可通过以下命令检查：

docker compose ps

3. 创建管理员账号

服务器启动后，需要创建管理员账号才能登录游戏。执行以下命令连接到worldserver控制台：

docker compose attach ac-worldserver

在控制台中输入账号创建命令（注意替换admin和password为你的账号密码）：

AC> account create admin password 3 -1

参数说明：3表示管理员权限等级，-1表示无过期时间

创建成功后，按Ctrl+P然后Ctrl+Q退出控制台（不要直接按Ctrl+C，会终止服务）。

服务管理

查看日志

各服务日志通过Docker卷挂载到本地，路径为./env/dist/logs，也可通过命令查看：

# 查看worldserver日志
docker compose logs -f ac-worldserver

# 查看authserver日志
docker compose logs -f ac-authserver

停止服务

# 停止所有服务但不删除数据
docker compose down

# 停止并删除数据卷（会清除所有配置和数据库）
docker compose down -v

自定义配置

如需修改服务器配置，不要直接编辑docker-compose.yml，而是创建docker-compose.override.yml文件进行个性化配置，例如修改端口映射：

services:
  ac-worldserver:
    ports:
      - "8086:8085"  # 将默认8085端口映射到主机8086端口

开发环境配置

项目还提供了开发专用配置，通过dev profile启动包含代码热更新的开发环境：

docker compose --profile dev up -d

开发环境会将本地代码目录挂载到容器中，修改代码后执行以下命令重新编译：

docker compose exec ac-dev-server cmake --build /azerothcore/var/build

开发服务器配置详情可参考apps/docker/Dockerfile.dev-server。

常见问题解决

端口冲突

如果启动时报错"address already in use"，说明默认端口被占用。可通过环境变量修改端口：

# 修改数据库端口
DOCKER_DB_EXTERNAL_PORT=3307 docker compose up -d

# 或修改配置文件
echo "DOCKER_DB_EXTERNAL_PORT=3307" > .env
docker compose up -d

数据持久化

数据库数据存储在Docker卷ac-database中，即使删除容器也不会丢失。如需备份数据：

docker compose exec ac-database mysqldump -u root -ppassword acore_world > world_backup.sql

客户端数据

服务器需要WoTLK客户端数据文件。默认配置会自动下载基础数据，如需使用自定义客户端数据，可通过以下方式挂载：

DOCKER_VOL_DATA=/path/to/your/client/Data docker compose up -d

总结

通过Docker容器化部署，我们成功解决了AzerothCore-WoTLK的环境配置难题：

1. 标准化环境：消除"在我电脑上能运行"的兼容性问题
2. 简化部署流程：从"编译-配置-部署"的多步骤变为一键操作
3. 隔离性保障：服务器组件与系统环境完全隔离，避免依赖冲突
4. 快速重置：通过数据卷管理，可随时重置环境而不丢失关键数据

项目的Docker配置遵循最佳实践，将构建和运行过程解耦，既适合新手快速上手，也满足开发者的定制需求。完整文档可参考Docker部署指南。

现在，你可以专注于游戏功能开发而非环境配置，开始打造自己的MMO服务器吧！