Skip to content

GameAgent API 配置 ​

API 是角色存档、账号字段、交易、自助服务、聊天与系统运维的受控边界。配置来自服务启动器和环境变量;浏览器不得获得令牌、签名密钥、数据库连接串或 D2GS 管理密码。

自动生成索引

下方环境变量由构建脚本直接扫描仓库源码生成,本次共收录 335 项。新增变量会自动进入索引,关键变量的中文说明在生成器中人工维护。

加载顺序与版本隔离 ​

  1. 服务级环境变量或受保护的 runner。
  2. 主机环境变量。
  3. 仅限本地开发的程序默认值;正式部署值不得依赖源码默认值。

1.09 与 1.13 使用独立源码工作区、API 二进制、地址、签名密钥、CA、角色目录、账号库和索引库。正式环境缺少关键密钥时应启动失败,不能回退到另一版本。

正式配置来源 ​

正式主机拓扑与 GS 放置关系维护在 deploy/realms/catalog.json。109 API、后台和论坛 PHP runner 配置只在 d2109/deploy/runtime.json;113 对应配置只在 d2113/deploy/runtime.json。部署器不得提供跨版本回退值。密码、写令牌和签名密钥由各项目正式 runner 保管。公共 /api 路径固定返回 404。

管理后台与部署 ​

变量中文说明
D2109_ADMIN_PASSWORD1.09 管理后台 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_ADMIN_PORT1.09 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2109_ADMIN_SESSION_SECONDS1.09 管理后台 / 会话 / 秒数。修改后按所属服务的重载方式生效。
D2109_ADMIN_SESSION_SECRET1.09 管理后台 / 会话 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_ADMIN_USER1.09 管理后台 / 用户名。修改后按所属服务的重载方式生效。
D2109_D2GS_ADMIN_PORT1.09 D2GS / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2109_DEPLOY_ADMIN_PORT1.09 部署 / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2109_DEPLOY_ADMIN_ROOT1.09 部署 / 管理后台 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2109_DEPLOY_FORUM_TUNNEL_PORT1.09 部署 / 论坛 / tunnel / 端口。修改后需同步监听、防火墙和反向代理。
D2109_DEPLOY_PROJECT_ROOT1.09 部署 / project / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2109_DEPLOY_PUBLIC_HOST1.09 部署 / 公网 / 主机。修改后按所属服务的重载方式生效。
D2109_DEPLOY_SERVER_ROOT1.09 部署 / server / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2109_DEPLOY_SITE_ROOT1.09 部署 / site / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2109_DEPLOY_VIP_AGENT_PORT1.09 部署 / VIP / agent / 端口。修改后需同步监听、防火墙和反向代理。
D2109_REALM_ADMIN1.09 国度 / 管理后台。修改后按所属服务的重载方式生效。
D2109_VIP_D2GS_ADMIN_PORT1.09 VIP / D2GS / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_ADMIN_PASSWORD1.13/共享 管理后台 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_ADMIN_PORT1.13/共享 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_ADMIN_PROXY_PORT1.13/共享 管理后台 / proxy / 端口。修改后需同步监听、防火墙和反向代理。
D2113_ADMIN_SESSION_SECONDS1.13/共享 管理后台 / 会话 / 秒数。修改后按所属服务的重载方式生效。
D2113_ADMIN_SESSION_SECRET管理后台 HttpOnly 会话签名密钥。
D2113_ADMIN_USER1.13/共享 管理后台 / 用户名。修改后按所属服务的重载方式生效。
D2113_D2GS_ADMIN_HOST1.13/共享 D2GS / 管理后台 / 主机。修改后按所属服务的重载方式生效。
D2113_D2GS_ADMIN_PASSWORD1.13/共享 D2GS / 管理后台 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_D2GS_ADMIN_PORT1.13/共享 D2GS / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2GS_ADMIN_TIMEOUT_MS1.13/共享 D2GS / 管理后台 / 超时 / 毫秒。修改后按所属服务的重载方式生效。
D2113_DEPLOY_109_INGRESS_ROOT1.13/共享 部署 / 109 / ingress / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_ADMIN_PORT1.13/共享 部署 / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_ADMIN_ROOT1.13/共享 部署 / 管理后台 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_API_PORT1.13/共享 部署 / API / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_DATABASE_HOST1.13/共享 部署 / 数据库 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_DATABASE_PORT1.13/共享 部署 / 数据库 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_DOCS_PATH1.13/共享 部署 / docs / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_FORUM_PATH1.13/共享 部署 / 论坛 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_FORUM_PORT1.13/共享 部署 / 论坛 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_FORUM_PUBLIC_HOST1.13/共享 部署 / 论坛 / 公网 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_FORUM_SITE_ROOT1.13/共享 部署 / 论坛 / site / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_HTTPS_PORT1.13/共享 部署 / https / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_LEGACY_HOST1.13/共享 部署 / 旧版兼容 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_LEGACY_ROOT1.13/共享 部署 / 旧版兼容 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_LEGACY_SSH_PORT1.13/共享 部署 / 旧版兼容 / ssh / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_LEGACY_USER1.13/共享 部署 / 旧版兼容 / 用户名。修改后按所属服务的重载方式生效。
D2113_DEPLOY_LOOPBACK_HOST1.13/共享 部署 / loopback / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_PASSWORD1.13/共享 部署 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_DEPLOY_PROJECT_ROOT1.13/共享 部署 / project / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_PUBLIC_HOST1.13/共享 部署 / 公网 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_PUBLIC_LISTEN_HOST1.13/共享 部署 / 公网 / listen / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_PUBLIC_SCHEME1.13/共享 部署 / 公网 / scheme。修改后按所属服务的重载方式生效。
D2113_DEPLOY_SERVER_ROOT1.13/共享 部署 / server / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_SITE_ROOT1.13/共享 部署 / site / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_WEB_HOST1.13/共享 部署 / Web 服务 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_WEB_PORT1.13/共享 部署 / Web 服务 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_WEB_ROOT1.13/共享 部署 / Web 服务 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DEPLOY_WIN109_HOST1.13/共享 部署 / 109 正式主机 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_WIN109_RDP_PORT1.13/共享 部署 / 109 正式主机 / rdp / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_WIN109_SSH_PORT1.13/共享 部署 / 109 正式主机 / ssh / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_WIN109_USER1.13/共享 部署 / 109 正式主机 / 用户名。修改后按所属服务的重载方式生效。
D2113_DEPLOY_WIN113_HOST1.13/共享 部署 / 113 正式主机 / 主机。修改后按所属服务的重载方式生效。
D2113_DEPLOY_WIN113_RDP_PORT1.13/共享 部署 / 113 正式主机 / rdp / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_WIN113_SSH_PORT1.13/共享 部署 / 113 正式主机 / ssh / 端口。修改后需同步监听、防火墙和反向代理。
D2113_DEPLOY_WIN113_USER1.13/共享 部署 / 113 正式主机 / 用户名。修改后按所属服务的重载方式生效。
D2113_REALM_ADMIN1.13/共享 国度 / 管理后台。修改后按所属服务的重载方式生效。
D2113_REALM_ADMIN_PASSWORD1.13/共享 国度 / 管理后台 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_VIP_D2GS_ADMIN_PORT1.13/共享 VIP / D2GS / 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_WIN109_DEPLOY_PASSWORD1.13/共享 109 正式主机 / 部署 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_WIN113_DEPLOY_PASSWORD1.13/共享 113 正式主机 / 部署 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_ADMIN_ALLOW_INSECURE_DEV版本独立后台 管理后台 / 允许 / 不安全模式 / 开发模式。修改后按所属服务的重载方式生效。
D2_ADMIN_BIND版本独立后台 管理后台 / 绑定。修改后按所属服务的重载方式生效。
D2_ADMIN_COOKIE_SECURE版本独立后台 管理后台 / Cookie / 安全 Cookie。修改后按所属服务的重载方式生效。
D2_ADMIN_PASSWORD版本独立后台 管理后台 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_ADMIN_PORT版本独立后台 管理后台 / 端口。修改后需同步监听、防火墙和反向代理。
D2_ADMIN_SESSION_SECONDS版本独立后台 管理后台 / 会话 / 秒数。修改后按所属服务的重载方式生效。
D2_ADMIN_SESSION_SECRET版本独立后台 管理后台 / 会话 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_ADMIN_TOKEN版本独立后台 管理后台 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_ADMIN_USER版本独立后台 管理后台 / 用户名。修改后按所属服务的重载方式生效。
D2_DEPLOY_PACKAGE_ROOT版本独立后台 部署 / 套餐 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_DEPLOY_STAGE版本独立后台 部署 / stage。修改后按所属服务的重载方式生效。
D2_REALM_REGISTRY_KEY版本独立后台 国度 / 注册表 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_REALM_REGISTRY_PATH版本独立后台 国度 / 注册表 / 路径。使用目标主机绝对路径,并保持版本目录隔离。

API、鉴权与 TLS ​

变量中文说明
D2109_API_BASE1.09 API / 基础地址。修改后按所属服务的重载方式生效。
D2109_API_CA_CERT1.09 API / 内部 CA / 证书。修改后按所属服务的重载方式生效。
D2109_API_PORT1.09 API / 端口。修改后需同步监听、防火墙和反向代理。
D2109_API_SIGNING_KEY1.09 内部 API 的独立 HMAC 签名密钥;不得与 1.13 共用。
D2109_API_SIGNING_KEY_ID1.09 API / 签名 / 密钥 / id。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_API_TLS_VERIFY1.09 API / TLS / verify。修改后按所属服务的重载方式生效。
D2109_API_TOKEN1.09 API / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_API_WRITE_TOKEN1.09 API / 写入 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_INTERNAL_API1.09 内部 / API。修改后按所属服务的重载方式生效。
D2109_INTERNAL_API_BASE1.09 内部 / API / 基础地址。修改后按所属服务的重载方式生效。
D2113_API_ALLOW_LEGACY_BEARER1.13/共享 API / 允许 / 旧版兼容 / Bearer 兼容认证。修改后按所属服务的重载方式生效。
D2113_API_BASE1.13/共享 API / 基础地址。修改后按所属服务的重载方式生效。
D2113_API_CA_CERT1.13/共享 API / 内部 CA / 证书。修改后按所属服务的重载方式生效。
D2113_API_MAX_CLOCK_SKEW_SECONDS1.13/共享 API / 最大 / 时钟 / 允许时钟偏差 / 秒数。修改后按所属服务的重载方式生效。
D2113_API_PORT1.13/共享 API / 端口。修改后需同步监听、防火墙和反向代理。
D2113_API_SIGNING_KEY1.13 内部 API 的 HMAC 签名密钥;调用方与 Agent 一致,禁止发给浏览器。
D2113_API_SIGNING_KEY_ID1.13/共享 API / 签名 / 密钥 / id。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_API_TLS_CERT1.13/共享 API / TLS / 证书。修改后按所属服务的重载方式生效。
D2113_API_TLS_KEY1.13/共享 API / TLS / 密钥。修改后按所属服务的重载方式生效。
D2113_API_TLS_VERIFY1.13/共享 API / TLS / verify。修改后按所属服务的重载方式生效。
D2113_API_TOKEN1.13/共享 API / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_API_WRITE_TOKEN1.13/共享 API / 写入 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_INTERNAL_API1.13/共享 内部 / API。修改后按所属服务的重载方式生效。
D2113_INTERNAL_API_1.13/共享 内部 / API / 。修改后按所属服务的重载方式生效。
D2113_INTERNAL_API_BASE1.13/共享 内部 / API / 基础地址。修改后按所属服务的重载方式生效。
D2113_WECHAT_GATEWAY_TOKEN1.13/共享 微信 / 网关 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_API_BASE版本独立后台 API / 基础地址。修改后按所属服务的重载方式生效。
D2_API_CA_CERT版本独立后台 API / 内部 CA / 证书。修改后按所属服务的重载方式生效。
D2_API_HEALTH_PATH版本独立后台 API / 健康检查 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2_API_SIGNING_KEY版本独立后台 API / 签名 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_API_SIGNING_KEY_ID版本独立后台 API / 签名 / 密钥 / id。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_API_TLS_VERIFY版本独立后台 API / TLS / verify。修改后按所属服务的重载方式生效。
D2_API_WRITE_TOKEN版本独立后台 API / 写入 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_AUX_AGENT_API_BASE版本独立后台 aux / agent / API / 基础地址。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_API_WRITE_TOKEN版本独立后台 aux / agent / API / 写入 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_AUX_AGENT_CA_CERT版本独立后台 aux / agent / 内部 CA / 证书。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_SIGNING_KEY版本独立后台 aux / agent / 签名 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_AUX_AGENT_SIGNING_KEY_ID版本独立后台 aux / agent / 签名 / 密钥 / id。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。

交易、自助与物品 ​

变量中文说明
D2109_AUTH_SHOP_NODE1.09 auth / 商店 / node。修改后按所属服务的重载方式生效。
D2109_GS_SHOP_NODES_FILE1.09 游戏服务器 / 商店 / nodes / 文件。使用目标主机绝对路径,并保持版本目录隔离。
D2113_AUTH_SHOP_NODE1.13/共享 auth / 商店 / node。修改后按所属服务的重载方式生效。
D2113_CARRY_ONE_ITEM_CODES1.13/共享 携带 / 单件 / 物品 / 代码列表。修改后按所属服务的重载方式生效。
D2113_GS_SHOP_NODES_FILE1.13/共享 游戏服务器 / 商店 / nodes / 文件。使用目标主机绝对路径,并保持版本目录隔离。
D2113_ITEMSTATCOST_TXT1.13/共享 ItemStatCost 数据表 / 文本数据表。修改后按所属服务的重载方式生效。
D2113_ITEMTYPES_TXT1.13/共享 ItemTypes 数据表 / 文本数据表。修改后按所属服务的重载方式生效。
D2113_ITEM_IMAGE_DIRS1.13/共享 物品 / 图片 / 目录列表。使用目标主机绝对路径,并保持版本目录隔离。
D2113_ITEM_MPQ_PATHS1.13/共享 物品 / MPQ 资源 / 路径列表。使用目标主机绝对路径,并保持版本目录隔离。
D2113_ITEM_NAME_OVERRIDES1.13/共享 物品 / 名称 / 覆盖项。修改后按所属服务的重载方式生效。
D2113_ITEM_NAME_TABLES1.13/共享 物品 / 名称 / 表目录。修改后按所属服务的重载方式生效。
D2113_TRADE_ESCROW_DIR1.13/共享 交易 / 托管 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_TRADE_RETRY_MAX_SECONDS交易结算重试的最大退避秒数。
D2113_TRADE_RETRY_MIN_SECONDS交易结算重试的最小退避秒数。
D2_TRADE_RESET_BACKUP_DIR版本独立后台 交易 / reset / 备份 / 目录。使用目标主机绝对路径,并保持版本目录隔离。

论坛、绑定与 VIP ​

变量中文说明
D2109_BIND_COOLDOWN_SECONDS1.09 绑定 / 冷却时间 / 秒数。修改后按所属服务的重载方式生效。
D2109_CREDIT_TYPE1.09 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2109_FORUM_CHAT_PATH1.09 论坛 / 聊天 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2109_FORUM_CREDIT_TYPE1.09 论坛 / 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2109_FORUM_CSRF_SECRET1.09 论坛 / CSRF / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2109_FORUM_HOST1.09 论坛 / 主机。修改后按所属服务的重载方式生效。
D2109_FORUM_INTERNAL_BASE1.09 论坛 / 内部 / 基础地址。修改后按所属服务的重载方式生效。
D2109_FORUM_INTERNAL_TOKEN1.09 服务调用论坛内部接口的独立令牌。
D2109_FORUM_PATH1.09 论坛 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2109_FORUM_PORT1.09 论坛 / 端口。修改后需同步监听、防火墙和反向代理。
D2109_FORUM_TIMEOUT_MS1.09 论坛 / 超时 / 毫秒。修改后按所属服务的重载方式生效。
D2109_VIP_CREDIT_TYPE1.09 VIP / 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2109_VIP_D2GS_PORT1.09 VIP / D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2109_VIP_DAYS1.09 VIP / 天数。修改后按所属服务的重载方式生效。
D2109_VIP_PRICE1.09 VIP / 价格。修改后按所属服务的重载方式生效。
D2113_API_BIND1.13/共享 API / 绑定。修改后按所属服务的重载方式生效。
D2113_API_TLS_BIND1.13/共享 API / TLS / 绑定。修改后按所属服务的重载方式生效。
D2113_BIND_COOLDOWN_SECONDS1.13/共享 绑定 / 冷却时间 / 秒数。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_AUTO_MIGRATE1.13/共享 业务 / 数据库 / 自动 / 迁移。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_HOST1.13/共享 业务 / 数据库 / 主机。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_NAME1.13/共享 业务 / 数据库 / 名称。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_PASSWORD1.13/共享 业务 / 数据库 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_BUSINESS_DB_PORT1.13/共享 业务 / 数据库 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_BUSINESS_DB_REQUIRED1.13/共享 业务 / 数据库 / 必需。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_TLS_CA1.13/共享 业务 / 数据库 / TLS / 内部 CA。修改后按所属服务的重载方式生效。
D2113_BUSINESS_DB_USER1.13/共享 业务 / 数据库 / 用户名。修改后按所属服务的重载方式生效。
D2113_CREDIT_TYPE1.13/共享 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2113_FORUM_1.13/共享 论坛 / 。修改后按所属服务的重载方式生效。
D2113_FORUM_API_HOST1.13/共享 论坛 / API / 主机。修改后按所属服务的重载方式生效。
D2113_FORUM_API_PORT1.13/共享 论坛 / API / 端口。修改后需同步监听、防火墙和反向代理。
D2113_FORUM_CHAT_PATH1.13/共享 论坛 / 聊天 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_FORUM_CREDIT_TYPE1.13/共享 论坛 / 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2113_FORUM_CSRF_SECRET论坛表单 CSRF 独立密钥;不得回退复用 API 令牌。
D2113_FORUM_ENTRY_PATH1.13/共享 论坛 / entry / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_FORUM_HOST1.13/共享 论坛 / 主机。修改后按所属服务的重载方式生效。
D2113_FORUM_HTTPS1.13/共享 论坛 / https。修改后按所属服务的重载方式生效。
D2113_FORUM_INTERNAL_BASE1.13/共享 论坛 / 内部 / 基础地址。修改后按所属服务的重载方式生效。
D2113_FORUM_INTERNAL_TOKENGameAgent/后台调用论坛内部接口的服务令牌,只允许服务端持有。
D2113_FORUM_PATH1.13/共享 论坛 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_FORUM_PORT1.13/共享 论坛 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_FORUM_PROXY_PORT1.13/共享 论坛 / proxy / 端口。修改后需同步监听、防火墙和反向代理。
D2113_FORUM_TIMEOUT_MS1.13/共享 论坛 / 超时 / 毫秒。修改后按所属服务的重载方式生效。
D2113_PROXY_BIND1.13/共享 proxy / 绑定。修改后按所属服务的重载方式生效。
D2113_QA_FORUM_BASE1.13/共享 qa / 论坛 / 基础地址。修改后按所属服务的重载方式生效。
D2113_REQUIRE_VIP_REALM1.13/共享 要求 / VIP / 国度。修改后按所属服务的重载方式生效。
D2113_VIP_ALLOW_LEGACY_SNAPSHOT1.13/共享 VIP / 允许 / 旧版兼容 / 快照。修改后按所属服务的重载方式生效。
D2113_VIP_CREDIT_TYPE1.13/共享 VIP / 论坛积分 / 类型。修改后按所属服务的重载方式生效。
D2113_VIP_D2GS_CLIENT_HOST1.13/共享 VIP / D2GS / 客户端 / 主机。修改后按所属服务的重载方式生效。
D2113_VIP_D2GS_CLIENT_PORT1.13/共享 VIP / D2GS / 客户端 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_VIP_D2GS_HOST1.13/共享 VIP / D2GS / 主机。修改后按所属服务的重载方式生效。
D2113_VIP_D2GS_PORT1.13/共享 VIP / D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_VIP_DAYS默认 VIP 套餐增加的天数;实际发布套餐以论坛数据库活动版本为准。
D2113_VIP_ENTITLEMENTS_FILE1.13/共享 VIP / 权益快照 / 文件。使用目标主机绝对路径,并保持版本目录隔离。
D2113_VIP_GS_LIST1.13/共享 VIP / 游戏服务器 / 列表。修改后按所属服务的重载方式生效。
D2113_VIP_PRICE默认 VIP 套餐论坛积分价格;实际价格以当前发布套餐为准。
D2113_VIP_PUBLIC_D2GS_PORT1.13/共享 VIP / 公网 / D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_VIP_SNAPSHOT_DIR1.13/共享 VIP / 快照 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_DOCS_BIND版本独立后台 docs / 绑定。修改后按所属服务的重载方式生效。
D2_FORUM_DB_HOST版本独立后台 论坛 / 数据库 / 主机。修改后按所属服务的重载方式生效。
D2_FORUM_DB_NAME版本独立后台 论坛 / 数据库 / 名称。修改后按所属服务的重载方式生效。
D2_FORUM_DB_PASSWORD版本独立后台 论坛 / 数据库 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_FORUM_DB_PORT版本独立后台 论坛 / 数据库 / 端口。修改后需同步监听、防火墙和反向代理。
D2_FORUM_DB_USER版本独立后台 论坛 / 数据库 / 用户名。修改后按所属服务的重载方式生效。
D2_FORUM_ENTRY_PATH版本独立后台 论坛 / entry / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2_FORUM_INTERNAL_BASE版本独立后台 论坛 / 内部 / 基础地址。修改后按所属服务的重载方式生效。
D2_FORUM_INTERNAL_TOKEN版本独立后台 论坛 / 内部 / 令牌。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_FORUM_PUBLIC_HOST版本独立后台 论坛 / 公网 / 主机。修改后按所属服务的重载方式生效。
D2_FORUM_PUBLIC_URL版本独立后台 论坛 / 公网 / 地址。修改后按所属服务的重载方式生效。
D2_LOBBY_VIP_GLOW_FLAGS版本独立后台 lobby / VIP / glow / flags。修改后按所属服务的重载方式生效。

游戏服务与网络 ​

变量中文说明
D2109_BNET_PORT1.09 BNetD / 端口。修改后需同步监听、防火墙和反向代理。
D2109_D2CS_PORT1.09 D2CS / 端口。修改后需同步监听、防火墙和反向代理。
D2109_D2GS_PORT1.09 D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2109_PVPGN_USERS_DIR1.09 PvPGN / users / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_BNETD_CONTROL_HOST1.13/共享 BNetD / 控制 / 主机。修改后按所属服务的重载方式生效。
D2113_BNETD_CONTROL_PASSWORD1.13/共享 BNetD / 控制 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_BNETD_CONTROL_PORT1.13/共享 BNetD / 控制 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_BNETD_CONTROL_USER1.13/共享 BNetD / 控制 / 用户名。修改后按所属服务的重载方式生效。
D2113_BNETD_LOG_PATH1.13/共享 BNetD / 日志 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_BNET_PORT1.13/共享 BNetD / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2CS_HOST1.13/共享 D2CS / 主机。修改后按所属服务的重载方式生效。
D2113_D2CS_LOG_PATH1.13/共享 D2CS / 日志 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2CS_PORT1.13/共享 D2CS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2DBS_HOST1.13/共享 D2DBS / 主机。修改后按所属服务的重载方式生效。
D2113_D2DBS_LOG_PATH1.13/共享 D2DBS / 日志 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2DBS_PORT1.13/共享 D2DBS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2GS_CLIENT_HOST1.13/共享 D2GS / 客户端 / 主机。修改后按所属服务的重载方式生效。
D2113_D2GS_CLIENT_PORT1.13/共享 D2GS / 客户端 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2GS_CONFIG_PATH1.13/共享 D2GS / 配置 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2GS_LIST1.13/共享 D2GS / 列表。修改后按所属服务的重载方式生效。
D2113_D2GS_LOG_PATH1.13/共享 D2GS / 日志 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2GS_MAX_GAMES1.13/共享 D2GS / 最大 / 游戏数。修改后按所属服务的重载方式生效。
D2113_D2GS_PORT1.13/共享 D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_D2GS_REGISTRY_ROOT1.13/共享 D2GS / 注册表 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2GS_ROOT1.13/共享 D2GS / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_D2_INTERNAL_HOST1.13/共享 Diablo II / 内部 / 主机。修改后按所属服务的重载方式生效。
D2113_FORMAL_WEB_HOST1.13/共享 正式环境 / Web 服务 / 主机。修改后按所属服务的重载方式生效。
D2113_FORMAL_WEB_PORT1.13/共享 正式环境 / Web 服务 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_INSTANCE_PORT1.13/共享 实例 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_PUBLIC_D2CS_PORT1.13/共享 公网 / D2CS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_PUBLIC_D2GS_PORT1.13/共享 公网 / D2GS / 端口。修改后需同步监听、防火墙和反向代理。
D2113_PVPGN_CONF_PATH1.13/共享 PvPGN / 配置文件 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_PVPGN_ROOT1.13/共享 PvPGN / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_PVPGN_USERS_DIR1.13/共享 PvPGN / users / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_REALM_HOST1.13/共享 国度 / 主机。修改后按所属服务的重载方式生效。
D2113_REALM_NAME1.13/共享 国度 / 名称。修改后按所属服务的重载方式生效。
D2113_WECHAT_GATEWAY_PORT1.13/共享 微信 / 网关 / 端口。修改后需同步监听、防火墙和反向代理。
D2_DOCS_PORT版本独立后台 docs / 端口。修改后需同步监听、防火墙和反向代理。
D2_INTERNAL_HOST版本独立后台 内部 / 主机。修改后按所属服务的重载方式生效。
D2_LOBBY_PORTRAIT版本独立后台 lobby / portrait。修改后需同步监听、防火墙和反向代理。
D2_PUBLISH_PORT版本独立后台 publish / 端口。修改后需同步监听、防火墙和反向代理。

角色、存档与索引 ​

变量中文说明
D2109_CHARINFO_DIR1.09 角色信息 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_BACKUP_DIR1.13/共享 备份 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_CHARACTER_BLOB_REVISIONS角色索引数据库保留的完整存档历史版本数量。
D2113_CHARACTER_DETAIL_CACHE_ENTRIES1.13/共享 角色 / 详细信息 / 缓存 / 条目数。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DATABASE_URL1.13/共享 角色 / 索引 / 数据库 / 地址。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DB_DRIVER1.13/共享 角色 / 索引 / 数据库 / 驱动。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DB_HOST1.13/共享 角色 / 索引 / 数据库 / 主机。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DB_NAME1.13/共享 角色 / 索引 / 数据库 / 名称。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DB_PASSWORD1.13/共享 角色 / 索引 / 数据库 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_CHARACTER_INDEX_DB_PORT1.13/共享 角色 / 索引 / 数据库 / 端口。修改后需同步监听、防火墙和反向代理。
D2113_CHARACTER_INDEX_DB_USER1.13/共享 角色 / 索引 / 数据库 / 用户名。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_DEBOUNCE_MS1.13/共享 角色 / 索引 / 防抖 / 毫秒。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_RECONCILE_BATCH_PAUSE_MS1.13/共享 角色 / 索引 / 对账 / 批次 / 批次暂停 / 毫秒。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_RECONCILE_BATCH_SIZE1.13/共享 角色 / 索引 / 对账 / 批次 / 大小。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_RECONCILE_START_DELAY_SECONDS1.13/共享 角色 / 索引 / 对账 / 启动 / 延迟 / 秒数。修改后按所属服务的重载方式生效。
D2113_CHARACTER_INDEX_SQLITE_PATH1.13/共享 角色 / 索引 / SQLite / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_CHARACTER_RECONCILE_SECONDS角色索引全量对账间隔秒数。
D2113_CHARINFO_DIR1.13/共享 角色信息 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_EXPECTED_SAVE_VERSION允许读取和写入的 D2S 存档版本;1.09 系列为 92,1.13c 为 96,配置错误时必须拒绝写盘。
D2113_RECENT_SAVE_GUARD_SECONDS角色最近保存后的写入保护秒数,避免退出过程与自助服务同时改档。
D2113_SAVE_DIR1.13/共享 存档 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_SOCKET_SAVE_FIXTURE版本独立后台 socket / 存档 / fixture。修改后按所属服务的重载方式生效。

运行策略与兼容性 ​

变量中文说明
D2109_FORCED_PROFILE1.09 强制 / 版本配置。使用目标主机绝对路径,并保持版本目录隔离。
D2109_GAME_PROFILE1.09 游戏 / 版本配置。使用目标主机绝对路径,并保持版本目录隔离。
D2109_GS_AUTO1.09 游戏服务器 / 自动。修改后按所属服务的重载方式生效。
D2109_NOTIFICATION_CONFIG1.09 notification / 配置。修改后按所属服务的重载方式生效。
D2109_PUBLIC_DB_ERRORS_DISABLED1.09 公网 / 数据库 / 错误数 / 禁用。修改后按所属服务的重载方式生效。
D2109_SYSTEM_AGENT_ONLY1.09 系统 / agent / only。修改后按所属服务的重载方式生效。
D2113_ACCOUNT_PROTECTION_ENABLED1.13/共享 账号 / protection / 启用。修改后按所属服务的重载方式生效。
D2113_ACT1_PALETTE_PATH1.13/共享 第一幕 / 调色板 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_AGENT_SERVICE_NAME1.13/共享 agent / 服务 / 名称。修改后按所属服务的重载方式生效。
D2113_CLIENT_DIR1.13/共享 客户端 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_CLIENT_ROOT1.13/共享 客户端 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_DOCS_BASE1.13/共享 docs / 基础地址。修改后按所属服务的重载方式生效。
D2113_DOCS_REQUIRE_PUBLIC1.13/共享 docs / 要求 / 公网。修改后按所属服务的重载方式生效。
D2113_DOCS_SITE_URL1.13/共享 docs / site / 地址。修改后按所属服务的重载方式生效。
D2113_DOCS_VALIDATION_URL1.13/共享 docs / validation / 地址。修改后按所属服务的重载方式生效。
D2113_ENABLE_109B_PUBLIC1.13/共享 启用 / 1.09b / 公网。修改后按所属服务的重载方式生效。
D2113_EXCEL_FALLBACK_DIR1.13/共享 数据表 / 兼容回退 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_FORCED_PROFILE1.13/共享 强制 / 版本配置。使用目标主机绝对路径,并保持版本目录隔离。
D2113_GAME_DATA_DIR1.13/共享 游戏 / 数据 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_GAME_DATA_MODE1.13/共享 游戏 / 数据 / 模式。修改后按所属服务的重载方式生效。
D2113_GAME_PROFILE当前服务所属版本标识,使用 109b 或 113c。
D2113_GS_AUTO_ENABLED1.13/共享 游戏服务器 / 自动 / 启用。修改后按所属服务的重载方式生效。
D2113_GS_CONFIG_OWNER1.13/共享 游戏服务器 / 配置 / owner。修改后按所属服务的重载方式生效。
D2113_GS_NODES_FILE1.13/共享 游戏服务器 / nodes / 文件。使用目标主机绝对路径,并保持版本目录隔离。
D2113_HEALTH_INCLUDE_PATHS1.13/共享 健康检查 / 包含 / 路径列表。使用目标主机绝对路径,并保持版本目录隔离。
D2113_LEGACY_WINDOWS1.13/共享 旧版兼容 / windows。修改后按所属服务的重载方式生效。
D2113_LINUX_WEB_PASSWORD1.13/共享 linux / Web 服务 / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_LINUX_WEB_SSH_KEY1.13/共享 linux / Web 服务 / ssh / 密钥。修改后按所属服务的重载方式生效。
D2113_MYSQL_CLIENT_PATH1.13/共享 MySQL / 客户端 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_MYSQL_DUMP_PATH1.13/共享 MySQL / dump / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_NOTIFICATION_CONFIG1.13/共享 notification / 配置。修改后按所属服务的重载方式生效。
D2113_PROPERTIES_TXT1.13/共享 属性定义 / 文本数据表。修改后按所属服务的重载方式生效。
D2113_PUBLIC_DB_ERRORS_DISABLED1.13/共享 公网 / 数据库 / 错误数 / 禁用。修改后按所属服务的重载方式生效。
D2113_ROOT1.13/共享 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_SERVICE_CONTROL_COMMAND1.13/共享 服务 / 控制 / command。修改后按所属服务的重载方式生效。
D2113_SERVICE_CONTROL_SOCKET1.13/共享 服务 / 控制 / socket。修改后按所属服务的重载方式生效。
D2113_UID1.13/共享 论坛用户编号。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_HEALTH_PATH版本独立后台 aux / agent / 健康检查 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2_AUX_AGENT_ID版本独立后台 aux / agent / id。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_NAME版本独立后台 aux / agent / 名称。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_SYSTEM_ONLY版本独立后台 aux / agent / 系统 / only。修改后按所属服务的重载方式生效。
D2_AUX_AGENT_TIER版本独立后台 aux / agent / tier。修改后按所属服务的重载方式生效。
D2_CN_CODEPAGE版本独立后台 cn / codepage。修改后按所属服务的重载方式生效。
D2_DISPLAY_FIXTURE_DIR版本独立后台 display / fixture / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_DOCS_ROOT版本独立后台 docs / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_GAME_NETWORK版本独立后台 游戏 / network。修改后按所属服务的重载方式生效。
D2_GAME_ROOT版本独立后台 游戏 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_NODE_RUNTIME_URL版本独立后台 node / runtime / 地址。修改后按所属服务的重载方式生效。
D2_PROJECT版本独立后台 project。修改后按所属服务的重载方式生效。
D2_PUBLISH_IP版本独立后台 publish / ip。修改后按所属服务的重载方式生效。
D2_RUNTIME_ROOT版本独立后台 runtime / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_SMOKE_PASSWORD版本独立后台 smoke / 密码。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2_SOCKET_FIXTURE_DIR版本独立后台 socket / fixture / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_WEB_ARCHIVE版本独立后台 Web 服务 / archive。修改后按所属服务的重载方式生效。
D2_WEB_SHA256版本独立后台 Web 服务 / sha256。修改后按所属服务的重载方式生效。

聊天、日志与审计 ​

变量中文说明
D2113_AUDIT_DIR1.13/共享 审计 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_CHAT_BRIDGE_CONFIG1.13/共享 聊天 / 桥接 / 配置。修改后按所属服务的重载方式生效。
D2113_CHAT_BRIDGE_ENABLED1.13/共享 聊天 / 桥接 / 启用。修改后按所属服务的重载方式生效。
D2113_CHAT_BRIDGE_SPOOL_DIR1.13/共享 聊天 / 桥接 / 队列目录 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_LOG_ARCHIVE_ENABLED1.13/共享 日志 / archive / 启用。修改后按所属服务的重载方式生效。
D2113_LOG_DIR1.13/共享 日志 / 目录。使用目标主机绝对路径,并保持版本目录隔离。
D2113_LOG_PREFIX1.13/共享 日志 / 前缀。修改后按所属服务的重载方式生效。
D2113_LOG_RETENTION_DAYS1.13/共享 日志 / 保留期 / 天数。修改后按所属服务的重载方式生效。
D2113_SYSTEM_TOPOLOGY_EXCLUSIVE1.13/共享 系统 / 运行拓扑 / exclusive。修改后按所属服务的重载方式生效。
D2113_SYSTEM_TOPOLOGY_PATH1.13/共享 系统 / 运行拓扑 / 路径。使用目标主机绝对路径,并保持版本目录隔离。
D2113_WECHAT_BRIDGE_SECRET1.13/共享 微信 / 桥接 / 密钥。属于敏感配置,只能通过环境变量或受保护的服务启动器注入。
D2113_WECHAT_BRIDGE_WEBHOOK1.13/共享 微信 / 桥接 / 回调地址。修改后按所属服务的重载方式生效。
D2_CHAT_BRIDGE_ROOT版本独立后台 聊天 / 桥接 / 根目录。使用目标主机绝对路径,并保持版本目录隔离。
D2_CN_PATCH_LOG版本独立后台 cn / patch / 日志。修改后按所属服务的重载方式生效。
D2_CONTAINER_LOG版本独立后台 container / 日志。修改后按所属服务的重载方式生效。
D2_SOCKET_AUDIT_OUTPUT版本独立后台 socket / 审计 / output。修改后按所属服务的重载方式生效。

修改与验收 ​

  • API 地址、端口或证书变更:只同步对应版本后台、论坛 runner 和防火墙,再通过私有 /health 验证;公共 /api/health 必须保持 404。
  • 存档、账号库或版本变更:先执行只读预检,确认 save version 和目录隔离,再允许写接口。
  • 密钥轮换:先部署 Agent 新密钥,再更新调用方并彻底结束旧进程;验证旧密钥、跨版本密钥和重放请求均返回 401。
  • 正式日志只保留运营要求的 D2CS 操作日志;临时 API 调试日志在验收后关闭。

生成器:docs-site\scripts\generate-api-reference.mjs。

仅供 CNBN D2 服务管理与开发人员使用