urothis/nwserver

nwserver

镜像概述

nwserver 是 Neverwinter Nights: Enhanced Edition (NWN:EE) 的 Docker 镜像，用于快速部署和运行 NWN:EE 游戏服务器。该镜像支持通过环境变量灵活配置服务器参数，可加载自定义模块、Hak 资源等，适用于搭建私人游戏服务器或公共服务器。

支持的标签

• https://github.com/urothis/nwserver/blob/main/Dockerfile
• https://github.com/urothis/nwserver/blob/main/Dockerfile
• https://github.com/urothis/nwserver/blob/main/Dockerfile

问题反馈地址

https://github.com/urothis/nwserver/issues

支持的架构

• amd64
• arm64v8

运行配置（基础镜像）

通过环境变量配置，可使用 docker -e 或 --env-file 指定。

配置类环境变量

以下环境变量用于配置服务器实例（列出默认值）：

bash
NWN_PORT=5121                  # 服务器端口
NWN_MODULE=DockerDemo          # 加载的模块名称
NWN_SERVERNAME=我太懒了，没配置服务器名称。  # 服务器名称
NWN_PUBLICSERVER=0             # 是否为公共服务器（0=否，1=是）
NWN_MAXCLIENTS=96              # 最大客户端数量
NWN_MINLEVEL=1                 # 最低角色等级
NWN_MAXLEVEL=40                # 最高角色等级
NWN_PAUSEANDPLAY=1             # 暂停与游玩模式（1=启用）
NWN_PVP=2                      # PVP 模式（2=团队PVP）
NWN_SERVERVAULT=1              # 服务器仓库启用状态（1=启用）
NWN_ELC=1                      # 增强角色创建限制（ELC，1=启用）
NWN_ILR=1                      # 物品等级限制（ILR，1=启用）
NWN_GAMETYPE=0                 # 游戏类型（0=默认）
NWN_ONEPARTY=0                 # 是否单团队模式（0=否）
NWN_DIFFICULTY=3               # 难度等级（3=困难）
NWN_AUTOSAVEINTERVAL=0         # 自动保存间隔（0=禁用）
NWN_RELOADWHENEMPTY=0          # 空服时重载模块（0=否）
NWN_PLAYERPASSWORD=            # 玩家密码（留空则无需密码）
NWN_DMPASSWORD=                # DM（地下城主）密码
NWN_ADMINPASSWORD=             # 管理员密码
NWN_NWSYNCURL=                 # NWSync 资源URL
NWN_NWSYNCHASH=                # NWSync 资源哈希值

运行时信息环境变量

以下环境变量用于在运行时获取实例信息（列出示例输出）：

bash
NWN_VERSION=8193.35.36         # 服务器版本
NWN_IMAGE_BUILD_DATE=2023-03-17 # 镜像构建日期

注意：该镜像不包含任何官方战役或 premium 模块，仅包含运行自定义模块所需的基础组件。所有需加载的资源（模块、Hak 等）需放置在服务器目录中。

（已修复 docker-proxy 导致端口随机化的问题，无需再使用 --net=host。但端口转发时仍需通过 NWN_PORT 指定服务器端口。）

创建服务器目录

服务器目录用于存放模块、Hak、Tlk 等资源，运行时临时数据（日志、当前游戏状态等）不会存储在此目录，因此可共享给多个实例。

bash
mkdir server && cd server
mkdir modules/ hak/ tlk/   # 将你的资源放入这些目录

测试运行

在服务器目录中执行以下命令测试服务器：

bash
cd server   # 确保在刚创建的服务器目录中
docker run --rm -it \
    -p 5121:5121/udp -e NWN_PORT=5121 \
    -v $(pwd):/nwn/home \
    -e NWN_MODULE=mymodule \
    -e NWN_PUBLICSERVER=1 \
    urothis/nwserver:8189

测试成功后，按 Ctrl+C 停止服务器，容器会自动删除（--rm 参数）。

注意：命令中通过 -p 映射端口，并通过 -e NWN_PORT=5121 告知服务器实际端口。若使用不同端口转发，需修改该值。

若处于 NAT 环境且未配置端口转发，服务器会尝试通过 NAT 穿透连接客户端，失败时使用中继连接。建议测试完成后配置防火墙规则或端口转发。

正式部署

使用以下命令在后台启动服务器，并配置自动重启：

bash
docker run --restart unless-stopped -dit \
    -p 5121:5121/udp -e NWN_PORT=5121 \
    --name mycoolserver \
    -v $(pwd):/nwn/home \
    -e NWN_MODULE=mymodule \
    -e NWN_PUBLICSERVER=1 \
    urothis/nwserver:8189

• --restart unless-stopped：除非手动停止，否则容器退出时自动重启。
• -dit：后台运行并分配终端。
• --name mycoolserver：为容器命名，便于后续管理。

服务器管理

• 控制台交互：服务器控制台通过 Docker 终端暴露，可使用 docker attach mycoolserver 连接（按 Ctrl+P Ctrl+Q 断开连接，不终止服务器）。
• 查看日志：服务器日志输出到 stdout，可通过以下命令查看：

bash
docker logs -f mycoolserver

升级镜像

由于所有数据存储在服务器目录中，升级时只需停止旧容器，启动新版本镜像即可：

bash
docker stop mycoolserver
docker rm mycoolserver
docker run --restart unless-stopped -dit \
    -p 5121:5121/udp -e NWN_PORT=5121 \
    --name mycoolserver \
    -v $(pwd):/nwn/home \
    -e NWN_MODULE=mymodule \
    -e NWN_PUBLICSERVER=1 \
    urothis/nwserver:8184 # 注意：修改为新版本标签

崩溃处理

服务器崩溃时，崩溃转储文件会导出到服务器目录中，便于排查问题。

多语言支持

将对应语言的 dialog.tlk 文件放入服务器目录（与 modules/、hak/ 同级），即可使服务器支持该语言。