AzerothCore 完整指南：从克隆到开服，10步搞定魔兽3.3.5a私有服务器-平芜编程栈

AzerothCore 完整指南：从克隆到开服，10步搞定魔兽3.3.5a私有服务器

【免费下载链接】azerothcore-wotlkComplete Open Source and Modular solution for MMO项目地址: https://gitcode.com/GitHub_Trending/az/azerothcore-wotlk

想自己搭一台《魔兽世界》怀旧版服务器吗？AzerothCore 就是一个免费开源的 MMORPG 服务器核心，它专门复现 WotLK 3.3.5a 版本的完整玩法，用 C++ 编写，模块化设计，配合 MySQL 数据库就能跑起一套可进可玩的私人服务器。下面这份教程，会像朋友陪你操作一样，带你从零走到服务器启动。

项目背景与定位：它是什么，适合谁

简单来说，AzerothCore 是一个魔兽世界服务器模拟器。原版的服务器端代码暴雪从未公开，而这类"核心"项目的意义就在于：用社区力量把服务器逻辑重写出来，让任何人都能合法地、本地地运行一套游戏服务器。

它主要解决三类人的需求：

想开服带朋友一起玩的"服主"，不用花钱买商业授权；
想研究 MMO 服务端架构（网络协议、数据库设计、战斗系统）的开发者；
想往里加自定义任务、副本、物品内容的创作者。

它的血统比较"豪华"：代码早期源自 MaNGOS、TrinityCore 和 SunwellCore 这几款老牌核心，之后团队又做了大量重写和现代化改造，比如模块化加载体系、现代化的 CMake 构建流程和完整的测试框架。换句话说，它站在一堆前辈的肩膀上，又往前走了很远。

核心亮点速览：为什么选它

全功能复现 3.3.5a：魔兽世界最后的 32 倍经验版本，从日常任务到副本机制基本都能还原，不是玩具级实现。
真正的模块化：扩展功能放在modules/目录下，每个模块独立编译，不需要也不喜欢某个功能时，可以用-DDISABLED_AC_MODULES参数把它关掉，想换血不伤身。
工程化程度高：C++20 标准、CMake 构建、Google Test 单元测试、Go 语言写的端到端测试（在e2e/目录），还自带代码风格检查脚本，是社区项目里少见的"正经工程"。
部署工具链齐全：仓库里的启动脚本、Docker 方案、数据库更新机制都帮你把"装环境"这件最烦的事简化了。

部署前准备：先备齐这几样

动手之前，花十分钟确认下表里的东西，能省掉后面 90% 的报错：

类别	需要版本	白话说明
操作系统	Windows / Linux / macOS 均可	Linux 体验最顺，推荐 Ubuntu
编译工具	CMake + GCC/Clang（需支持 C++20）	负责把源代码变成能跑的程序
数据库	MySQL 或 MariaDB	存角色、物品、任务进度的地方
磁盘空间	建议预留 5GB+	源码和编译产物都不小

两个小提示：

C++20 是硬性要求，太老的编译器会直接拒绝开工；
如果配置项拿不准，去翻配置策略文档和日志文档，仓库自带说明。

从零到启动的完整流程

下面一条线走到底：拿代码 → 编译 → 建库 → 启动。每一步只做一件事。

第一步：把代码拿下来

先克隆仓库（这是全文唯一一次需要用到仓库地址）：

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

第二步：编译项目

AzerothCore 只允许"源码外编译"（就是必须在单独的 build 目录里干活，不能在源码目录里直接编）。进入 build 目录后，先让 CMake 做配置，再让 make 干活：

mkdir build && cd build cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/azeroth-server make -j$(nproc) make install

编译需要一点耐心，-j$(nproc)会用满你的 CPU 核心来加速。完整可用的编译参数清单，仓库的构建文档里有，比如想跑单元测试可以加-DBUILD_TESTING=ON。

第三步：配置数据库

然后到安装目录（上面的例子是$HOME/azeroth-server/bin）执行数据库初始化脚本acore-db-setup。它会依次建好三个库：

db_auth：管账号验证；
db_characters：存角色数据；
db_world：存任务、物品、NPC 等世界内容。

对应关系在数据库脚本目录里一目了然，base/是基础结构，updates/是增量更新，pending_db_*/是待合并的更新。

第四步：启动服务器

最后跑启动脚本acore-server-start。它会拉起两个进程：

authserver：登录验证服务，默认端口 3724；
worldserver：世界服务，真正承载游戏逻辑，默认端口 8085。

两个进程都起来后，用游戏客户端指向你的机器地址，就能登录了。如果嫌手写命令麻烦，启动脚本目录里还有服务化、自动重启的方案可以参考。

真实应用场景：不只是"跑起来"

场景一：开一个朋友局最经典的用法。把服务器架在家宽或租一台云服务器，建几个账号，拉三五好友进去刷北风峡、打英雄本。数据库里的custom/目录（官方说明）专门留给你存放自己的自定义 SQL，改内容不会污染官方数据。

场景二：学习 MMO 服务端架构想搞懂游戏服务器怎么写的？直接读源码比看一百篇文章快。src/server/game/是核心玩法逻辑，脚本目录按地区（如Northrend/）和系统（如Spells/、Pet/）组织，找对应系统的实现一目了然。

场景三：做内容创作与模块开发想加新功能而不想改核心代码？走模块化路线：参考模块开发指南，用仓库自带的create_module.sh生成骨架，在modules/下开发，编译时自动识别加载。

性能与调优要点

服务器跑久了卡、慢，通常不是玄学，先查这几个地方：

数据库索引与查询：db_characters和db_world的数据量最大，慢查询优先怀疑这两张方向的表。写自定义 SQL 前先看看现有更新语句是怎么组织查询的。
配置文件调参：conf/下的配置文件控制世界逻辑的各种参数（游戏线程数、地图更新频率等），按需微调，改法规范见配置策略文档。
编译选项：正式开服建议用带优化选项的构建类型（如RelWithDebInfo），日常开发调试再换其他类型。
善用日志定位问题：日志文档讲了日志级别怎么设，排查线上问题时把级别调高，问题基本都能现形。
监控面板：仓库在 apps/grafana/ 里附带了现成的 Grafana 监控面板 JSON（总览、地图、网络、性能剖析四组），导入即可盯着服务器状态。