配置项说明
管理器主要通过环境变量配置。Docker 部署写在 docker-compose.yaml 或 docker run -e 中，Windows 部署写在 start_manager.bat 中。
管理器变量
| 变量名 | 说明 | 默认值 |
|---|---|---|
L4D2_MANAGER_PASSWORD | Web 管理后台管理员密码。生产环境必须设置强密码。 | laoyutangnb |
L4D2_MANAGER_PORT | 管理器监听端口。 | 27020 |
L4D2_GAME_PATH | L4D2 的 left4dead2 游戏目录。 | /left4dead2 |
L4D2_RCON_URL | RCON 地址，格式为 IP:端口 或 容器名:端口。 | 空 |
L4D2_RCON_PASSWORD | RCON 密码，需要和 server.cfg 一致。 | 空 |
L4D2_RESTART_BY_RCON | 重启服务器时是否优先使用 RCON。推荐设为 true。 | false |
L4D2_RESTART_CMD | 不使用 RCON 重启时执行的自定义命令。 | 空 |
L4D2_CONTAINER_NAME | 未配置重启命令时用于重启的 Docker 容器名。 | l4d2 |
L4D2_PLUGIN_STORE_PATH | 插件库数据目录。 | ./plugins |
STEAM_API_KEY | 首页玩家列表中查询 Steam 账号的 L4D2 游戏时长。 | 空 |
游戏服镜像变量
| 变量名 | 说明 | 默认值 |
|---|---|---|
L4D2_TICK | 游戏服 Tickrate，支持 30、60、100、128。 | 30 |
L4D2_VAC | 是否启用 VAC。false 会添加 -insecure。 | false |
L4D2_PORT | 游戏服监听端口。 | 27015 |
L4D2_RCON_PASSWORD | 写入游戏服 server.cfg 的 RCON 密码。 | laoyutangnb! |
数据目录
管理器默认把运行数据放在 ./data，Docker 部署中通常映射为 /data 卷。该目录包含：
private.key：临时授权码和自助授权码的签名密钥。manager_config.json：自助授权、玩家统计、监控历史、地图精简等开关。access_control.json：面板黑白名单和可信代理配置。monitor.db：性能监控历史数据。player_stats.db：玩家在线统计数据。
这些数据不属于游戏目录。迁移管理器时，如果希望保留统计、授权码状态和历史监控，请保留该目录。
权限模式
后台有三类登录身份：
| 身份 | 来源 | 权限 |
|---|---|---|
| 管理员 | L4D2_MANAGER_PASSWORD | 可进行上传、删除、启停、保存配置、生成授权码等写操作。 |
| 访客 | 临时授权码或自助授权码 | 以查看为主，部分敏感页面和写操作会被隐藏或禁用。 |
| 地图上传者 | 管理员生成的“仅地图上传”授权码 | 只能分片上传地图、查询上传状态、取消上传和执行地图热重载。 |
临时授权码由管理员在“系统管理”中生成，并可选择普通临时权限或仅地图上传。自助授权码需要管理员先开启自助服务，开启后访客可按冷却限制自行申请短期访问码；自助授权始终使用普通临时权限。
面板访问控制
面板访问控制不使用环境变量，仅管理员可以在“访问控制”页面配置。页面包含“面板黑白名单”“可信代理”和“游戏黑名单”三个 Tab：前两个分别保存并立即生效，游戏黑名单通过 RCON 实时读取和修改游戏服务端原生封禁。
面板规则支持地区关键字、单 IP 和 CIDR；地区规则依赖后端随包提供的 ip2region_*.xdb 数据文件。首次没有页面配置时，面板黑白名单默认关闭，可信代理默认为 127.0.0.0/8 和 ::1/128。
可信代理决定管理器是否接受 X-Forwarded-For 和 X-Real-IP。只应填写自己实际控制、会直接连接管理器的反向代理地址；配置不正确会导致管理器把代理地址当作客户端地址。完整的启用步骤、判断顺序和反向代理配置见面板访问控制。