【邪修】在绿联NAS上部署魔兽世界服务器-AzerothCore WotLK

曾经跟大家分享交流过传奇3的docker部署流程，评论区有个用户朋友留言问nas能不能部署魔兽世界服务器？现在补上这个坑。

项目资料：开源框架AzerothCore、群晖第三方套件WoWServer_v1.0.52_x64_DMS7.2.spk (WoWServer v1.0.52)。

（AzerothCore 是一个采用 AGPL v3.0 开源协议的游戏服务器框架，由全球开发者社区共同维护。它不包含任何受版权保护的游戏资源（模型、贴图、音乐等），仅实现了网络通信与游戏逻辑模拟的服务器端功能。）

声明： 本文仅用于技术学习与交流。请遵守当地法律法规及游戏用户协议。本文不提供任何游戏客户端资源的获取方式。
一次在家用 NAS 上部署 Docker 容器化游戏服务端的技术记录，涵盖 Compose 编排、数据库管理、网络配置等实战经验。

本文记录我在绿联 NAS 上通过 Docker 部署该框架的技术过程，涉及容器编排、服务依赖管理、数据库迁移等常见 DevOps 场景，适合对 Docker 和家庭服务器感兴趣的读者参考。

我把项目放到了我的仓库：http://github.com/asm0x1/wow-docker，并打包了镜像推送到了hub docker，可直接拉取。

部署方式我写了两种，一种是给本地用户使用命令行学习使用，另一种我适配了绿联nas docker项目部署方式，给绿联的朋友学习使用docker-compose（先写好的上一种，为了绿联nas的docker-compose限制又返回修改适配，真磨人）。

游戏画面

本地部署

本文不做过多介绍，详细文档请查看仓库 README.md。

1. # 1. 克隆项目到本地
   
2. git clone https://github.com/asm0x1/wow-docker.git
   
3. cd wow-docker
   
4. 
   
5. # 2. 复制 .env 模板并编辑
   
6. cp .env.dist .env
   
7. 
   
8. # 3. Apple Silicon Mac 必须设置 (Intel Mac 跳过)
   
9. export DOCKER_DEFAULT_PLATFORM=linux/amd64
   
10. 
    
11. # 4. 启动
    
12. docker compose up -d

复制代码

NAS部署
项目结构

---

采用 Docker Compose 管理多服务依赖，运行时共 4 个容器：

1. ac-database
   
2.     ├─► ac-worldserver (游戏世界)
   
3.     ├─► ac-authserver (认证 + realm初始化 + 账户创建)
   
4.     │     └─► ac-registration (Web 注册)
   
5.     └─► phpmyadmin (可选)

复制代码

技术栈一览：

组件	技术
数据库	MariaDB 10.11
服务器	C++ 编译的 AzerothCore 二进制
Web	Apache 2.4 + PHP 8.2
容器编排	Docker Compose v3
脚本	Bash (entrypoint 自动初始化)

---

部署步骤

---

1. 准备地图数据

首先需要客户端地图数据（服务端加载世界场景用）。这部分需要自行查阅 AzerothCore 社区文档(AAzerothCore 官方 wiki 的提取教程：https://www.azerothcore.org/wiki/client-setup)，使用地图提取工具从游戏客户端(3.3.5a (build 12340))导出。

将提取的数据放入项目目录：

1. docker/wow/
   
2.            └── data/
   
3.                       ├── maps/
   
4.                       ├── dbc/
   
5.                       ├── vmaps/
   
6.                       ├── mmaps/
   
7.                       └── cameras/

复制代码

地图数据约 2-3GB，不包含在项目仓库中。

2. 复制 docker-compose
将我写好的内容复制到剪贴板

1. # ============================================
   
2. # AzerothCore WotLK 3.3.5a - 绿联 NAS Docker Compose
   
3. # 适配: DXP4800 Plus (Intel 8505 x86_64) 及其他绿联 x86 NAS
   
4. # Author: asm0x1
   
5. # ============================================
   
6. #
   
7. # 部署方式 (绿联 Docker 管理界面):
   
8. #   1. 将此文件内容粘贴到 Docker → 项目 → 新建项目 → Compose 编辑器
   
9. #   2. 修改下面「部署配置」中的 REALM_IP 和 DB_ROOT_PASS（各一处）
   
10. #   3. 点击「部署」
    
11. #
    
12. #   所有镜像从 Docker Hub 自动拉取，无需构建。
    
13. #   Realm 初始化和账户创建已内置在 authserver 中，不再有一次性容器。
    
14. # ============================================
    
15. 
    
16. # ============================================
    
17. # 部署配置 —— 只需改这里！
    
18. # ============================================
    
19. x-deploy-config:
    
20.   REALM_IP:      &REALM_IP      192.168.1.100   # ← 必改：NAS 的局域网 IP
    
21.   DB_ROOT_PASS:  &DB_ROOT_PASS  wow@asm0x1       # 数据库密码（按需修改）
    
22. 
    
23. # 以下通常无需修改
    
24. x-port-config:
    
25.   REALM_PORT:    &REALM_PORT    8085
    
26.   DB_EXT_PORT:   &DB_EXT_PORT   63306
    
27.   AUTH_PORT:     &AUTH_PORT     3724
    
28.   REG_PORT:      &REG_PORT      8765
    
29.   SOAP_PORT:     &SOAP_PORT     7878
    
30. 
    
31. x-bot-config:
    
32.   BOT_MIN_COUNT:     &BOT_MIN_COUNT     15
    
33.   BOT_MAX_COUNT:     &BOT_MAX_COUNT     20
    
34.   BOT_MIN_LEVEL:     &BOT_MIN_LEVEL     1
    
35.   BOT_MAX_LEVEL:     &BOT_MAX_LEVEL     80
    
36.   BOT_ALLIANCE_RATIO: &BOT_ALLIANCE_RATIO 50
    
37.   BOT_HORDE_RATIO:   &BOT_HORDE_RATIO   50
    
38. 
    
39. services:
    
40.   # ============================================
    
41.   # MariaDB 10.11 数据库
    
42.   # ============================================
    
43.   ac-database:
    
44.     image: mariadb:10.11
    
45.     container_name: acore-database
    
46.     restart: unless-stopped
    
47.     cap_add:
    
48.       - SYS_NICE
    
49.     ports:
    
50.       - "63306:3306"
    
51.     environment:
    
52.       MARIADB_ROOT_PASSWORD: *DB_ROOT_PASS
    
53.       DB_EXT_PORT: *DB_EXT_PORT
    
54.     volumes:
    
55.       - ac-database-data:/var/lib/mysql
    
56.     healthcheck:
    
57.       test: '/usr/bin/mariadb --user=root --password=$$MARIADB_ROOT_PASSWORD --execute "SHOW DATABASES;"'
    
58.       interval: 5s
    
59.       timeout: 40s
    
60.       retries: 20
    
61.     networks:
    
62.       - ac-network
    
63. 
    
64.   # ============================================
    
65.   # 世界服务器 (从 Docker Hub 拉取)
    
66.   # ============================================
    
67.   ac-worldserver:
    
68.     image: asm0x1/wow-worldserver:latest
    
69.     container_name: acore-worldserver
    
70.     restart: unless-stopped
    
71.     stdin_open: true
    
72.     tty: true
    
73.     cap_add:
    
74.       - SYS_NICE
    
75.     ports:
    
76.       - "8085:8085"
    
77.       - "7878:7878"
    
78.     environment:
    
79.       DB_PASSWORD: *DB_ROOT_PASS
    
80.       REALM_PORT: *REALM_PORT
    
81.       SOAP_PORT: *SOAP_PORT
    
82.       BOT_MIN_COUNT: *BOT_MIN_COUNT
    
83.       BOT_MAX_COUNT: *BOT_MAX_COUNT
    
84.       BOT_MIN_LEVEL: *BOT_MIN_LEVEL
    
85.       BOT_MAX_LEVEL: *BOT_MAX_LEVEL
    
86.       BOT_ALLIANCE_RATIO: *BOT_ALLIANCE_RATIO
    
87.       BOT_HORDE_RATIO: *BOT_HORDE_RATIO
    
88.     volumes:
    
89.       - acore-logs:/opt/wow/logs
    
90.       - ./data:/opt/wow/data:ro
    
91.     depends_on:
    
92.       ac-database:
    
93.         condition: service_healthy
    
94.     networks:
    
95.       - ac-network
    
96. 
    
97.   # ============================================
    
98.   # 认证服务器 (从 Docker Hub 拉取)
    
99.   # 启动时自动完成：Realm IP 初始化 + 默认账户创建
    
100.   # ============================================
     
101.   ac-authserver:
     
102.     image: asm0x1/wow-authserver:latest
     
103.     container_name: acore-authserver
     
104.     restart: unless-stopped
     
105.     stdin_open: true
     
106.     tty: true
     
107.     ports:
     
108.       - "3724:3724"
     
109.     environment:
     
110.       DB_HOST: ac-database
     
111.       DB_USER: root
     
112.       DB_PASSWORD: *DB_ROOT_PASS
     
113.       REALM_IP: *REALM_IP
     
114.       REALM_PORT: *REALM_PORT
     
115.       AUTH_PORT: *AUTH_PORT
     
116.       DEFAULT_ACCOUNT_USER: ""
     
117.       DEFAULT_ACCOUNT_PASS: ""
     
118.       DEFAULT_ACCOUNT_GMLEVEL: 3
     
119.       DEFAULT_ACCOUNT_EXPANSION: 2
     
120.     volumes:
     
121.       - acore-logs:/opt/wow/logs
     
122.     depends_on:
     
123.       ac-database:
     
124.         condition: service_healthy
     
125.       ac-worldserver:
     
126.         condition: service_started
     
127.     networks:
     
128.       - ac-network
     
129. 
     
130.   # ============================================
     
131.   # Web 注册页面 (从 Docker Hub 拉取)
     
132.   # ============================================
     
133.   ac-registration:
     
134.     image: asm0x1/wow-registration:latest
     
135.     container_name: acore-registration
     
136.     restart: unless-stopped
     
137.     ports:
     
138.       - "8765:80"
     
139.     environment:
     
140.       REALM_IP: *REALM_IP
     
141.       REG_PORT: *REG_PORT
     
142.     depends_on:
     
143.       ac-authserver:
     
144.         condition: service_started
     
145.     command: >
     
146.       sh -c "
     
147.       envsubst '$$REALM_IP' < /var/www/html/application/config/config.php > /tmp/config.php && mv /tmp/config.php /var/www/html/application/config/config.php;
     
148.       apache2-foreground
     
149.       "
     
150.     networks:
     
151.       - ac-network
     
152. 
     
153.   # ============================================
     
154.   # phpMyAdmin (可选管理工具)
     
155.   # 取消下面注释即可启用
     
156.   # ============================================
     
157.   # phpmyadmin:
     
158.   #   image: phpmyadmin
     
159.   #   ports:
     
160.   #     - "8081:80"
     
161.   #   environment:
     
162.   #     - PMA_ARBITRARY=1
     
163.   #     - PMA_HOST=ac-database
     
164.   #     - PMA_USER=root
     
165.   #     - PMA_PASSWORD=*DB_ROOT_PASS
     
166.   #   depends_on:
     
167.   #     ac-database:
     
168.   #       condition: service_healthy
     
169.   #   networks:
     
170.   #     - ac-network
     
171. 
     
172. networks:
     
173.   ac-network:
     
174.     driver: bridge
     
175. 
     
176. volumes:
     
177.   ac-database-data:
     
178.   acore-logs:
     

复制代码

3. 修改并部署

绿联 NAS（Docker → 项目 → 新建项目）：

  - 项目名称：wow

  - 项目文件夹：选择步骤 1 创建的目录

  - 将剪贴板内容粘贴到编辑器，修改编辑器顶部修改两个值

1. x-deploy-config:
   
2.   REALM_IP:              &REALM_IP              192.168.1.100         # ← 改成 NAS 的局域网 IP
   
3.   DB_ROOT_PASS:     &DB_ROOT_PASS     wow@asm0x1        # 数据库密码，按需修改

复制代码

  项目使用 YAML 锚点（&name / *name）实现配置集中管理——顶部定义一次，下方所有服务自动引用，告别"一处改、处处改"的维护噩梦。

  - 点击「部署」

其他支持 Docker Compose 的环境（命令行）：

1. docker compose -f nas/docker-compose.yml up -d

复制代码

---

关键技术细节

---

容器启动顺序与依赖管理

服务间有严格的启动顺序依赖，通过 depends_on + healthcheck 实现：

1. ac-worldserver:
   
2.    depends_on:
   
3.       ac-database:
   
4.          condition: service_healthy  # 等待数据库健康检查通过

复制代码

入口脚本 entrypoint-worldserver.sh 在启动时自动完成：

• 数据库创建（CREATE DATABASE IF NOT EXISTS）
• 配置文件模板渲染（sed 替换占位符）
• 数据完整性修复（如缺失路径点的生物自动修正）
• 模块配置生成
  
  

这种 "entrypoint 自动化" 模式避免了手动执行 SQL 脚本的繁琐操作。

NAS 环境的特殊处理

部分 NAS 的 Docker UI 不支持 Compose 的 ${VAR:-default} 变量替换语法。项目采用了锚点 + 直接值的方案，彻底规避此问题：

1. # ❌ 不可靠的写法（依赖 Compose 解析 .env）
   
2. environment:
   
3.    REALM_IP: ${REALM_IP:-127.0.0.1}
   
4. ​
   
5. # ✅ 可靠的写法（锚点引用 + 直接值）
   
6. x-deploy-config:
   
7.    REALM_IP: &REALM_IP 192.168.1.100
   
8. ​
   
9. environment:
   
10.    REALM_IP: *REALM_IP

复制代码

数据持久化

所有持久数据存储在 Docker 命名卷 ac-database-data 中，包括账户、角色、世界状态等。容器删除后数据依然保留，重新部署自动恢复。

如需完全重置，删除项目时勾选「同时删除卷」。

---

防火墙配置

---

确保 NAS 防火墙放行以下端口：

端口	协议	用途
3724	TCP	游戏登录认证
8085	TCP	游戏世界通信
8765	TCP	Web 注册页面

常见问题：1.开启了防火墙，禁止了对应IP段连接导致连接服务器失败。2.只放了 3724 而忽略 8085，导致能登录但进不去游戏世界。

---

日常运维

---

调整服务参数

编辑 YAML 中 x-bot-config 部分，修改后重新部署：

1. x-bot-config:
   
2.    BOT_MIN_COUNT:     10   # AI 玩家最小在线数
   
3.    BOT_MAX_COUNT:     30   # AI 玩家最大在线数查看日志

复制代码

查看日志

命令行环境下：

1. docker compose -f nas/docker-compose.yml logs -f ac-worldserver

复制代码

绿联 Docker UI：点击容器 → 日志。

更新镜像

• 删除旧容器和镜像
• 重新部署，自动拉取最新 asm0x1/wow-* 镜像
  
  

---

踩坑记录

---

• Apple Silicon Mac 本地开发：需要 export DOCKER_DEFAULT_PLATFORM=linux/amd64，因为二进制是 x86_64 编译的
• NAS 上 realmlist 地址错误：客户端能登录但进不去世界——排查发现 REALM_IP 配错了，改对后问题消失
• 端口没放全：NAS 防火墙容易只放 3724 忽略 8085，导致"能选服不能进"的尴尬
  
  

---

总结

---

通过这个项目，可以实践以下 Docker/DevOps 技能：

• 多容器编排：服务依赖、健康检查、启动顺序
• 配置管理：YAML 锚点、模板渲染、环境变量注入
• 数据持久化：Docker 卷、数据库备份
• 网络调试：端口映射、防火墙规则、客户端-服务端通信
  
  

对于一个家庭 NAS 来说，这也是检验其性能的好机会——2-3GB 地图数据加载、数百 MB 内存占用、多客户端并发连接，对 CPU 和磁盘 I/O 都是不小的考验。

---

关于 AzerothCore： 这是一个采用 AGPL v3.0 协议的开源项目，源代码完全公开，不含任何受版权保护的游戏素材。所有代码由社区贡献者出于技术研究目的编写。本项目仅涉及服务端框架的技术部署，使用前请确保你了解并遵守适用的法律、法规及用户协议。

这能干啥用？

云深不知处 发表于 2026-6-11 09:52
这能干啥用？

00后可能觉得毫无用处，但在80后眼里，构建的不是代码，是情怀，是回不去的青春。

兽人永不为奴😎

0001 发表于 2026-6-11 11:26
00后可能觉得毫无用处，但在80后眼里，构建的不是代码，是情怀，是回不去的青春。 ...

我也玩了几年魔兽世界，不过后来被剑侠三挖走了

绿联NAS私有云 发表于 2026-6-11 11:38
兽人永不为奴😎

你竟然还知道这个口号

云深不知处 发表于 2026-6-11 13:18
我也玩了几年魔兽世界，不过后来被剑侠三挖走了

那你的网龄比我大，我只会上窝窝吧聊天

很棒诶，有没有其他版本，想尝试其他的版本