left4devops/l4d2

Left 4 Dead 2 专用服务器 Docker 镜像

"哦，天啊！这简直就像反恐精英！"

https://github.com/Left4DevOps/l4d2-docker

我们还提供 https://hub.docker.com/r/left4devops/l4d - docker pull left4devops/l4d

开始使用

运行一个原版服务器非常简单，命令如下：

shell
docker run --name l4d2 \
    --network host \
left4devops/l4d2

[!IMPORTANT] 上述示例使用主机网络（--network host），这是推荐的网络方式，因为它允许游戏服务器正确识别连接玩家的IP，便于封禁玩家或阻止任何试图强制访问RCON的网络***。在Windows或macOS上使用主机网络，需从Docker 4.29版本的实验性功能中启用主机网络。

桥接网络模式

尽管游戏服务器无法正确识别玩家IP，但你可以使用Docker默认的桥接网络模式。确保同时使用TCP和UDP协议发布游戏端口。

shell
docker run --name l4d2-bridged \
    -p 27015:27015/tcp \
    -p 27015:27015/udp \
left4devops/l4d2

重启行为

"得有人去重启发电机！"

srcds_run 包含看门狗功能，可在服务器进程崩溃时自动重启。此外，你可能需要添加restart参数以确保服务器在系统重启后自动恢复：

shell
docker run --name l4d2-reboot \
    --restart unless-stopped \
left4devops/l4d2

拒绝服务保护

"我需要你们所有人立刻进来！"

此部分仍在完善中，更多详情请参见https://github.com/Left4DevOps/l4d2-docker/issues/6%E3%80%82

加入游戏

有多种方式可以加入服务器：

• 创建大厅后，作为主机将服务器类型设置为最佳可用专用服务器，打开开发者控制台并输入mm_dedicated_force_servers [ip:端口]，游戏将尝试使用你的服务器。
• 设置STEAM_GROUP变量，在大厅中选择从Steam组服务器启动游戏。
• 在游戏中使用服务器浏览器（openserverbrowser命令）将服务器添加为收藏，它将在Steam组服务器列表中显示。
• 通过开发者控制台直接连接服务器：connect [ip:端口]
• 也可从Steam客户端的查看 > 游戏服务器打开服务器浏览器。
• 局域网内的服务器会自动显示为Steam组服务器。

自定义插件

如果想在服务器上运行自定义战役或安装SourceMod，可以将包含自定义内容的目录挂载到/addons/目录。

例如，当前工作目录下有addons文件夹：

shell
docker run --name l4d2-server-addons \
    -v $(pwd)/addons:/addons/
left4devops/l4d2

配置

环境变量

可通过环境变量配置服务器的多项常用设置。

HOSTNAME

服务器名称，将显示在服务器浏览器和Steam组服务器列表中。默认为Left4DevOps。

将主机名改为BILLS HERE：

shell
docker run --name l4d2-hostname \
    -e HOSTNAME="BILLS HERE" \
left4devops/l4d2

REGION

"我需要你们所有人立刻进来！"

设置REGION环境变量可向Steam提示服务器位置，取值为以下数字之一：

若服务器位于欧洲：

shell
docker run --name l4d2-region \
    -e REGION=3 \
left4devops/l4d2

STEAM_GROUP

将服务器关联到Steam组可简化加入流程。Steam组服务器显示在游戏菜单右下角，且在Left 4 Dead 2中可直接选为 hosting 选项。玩家可按h键查看每日消息并加入你的Steam组，以便日后再次找到服务器。Steam组ID可在组管理页面顶部找到。

shell
docker run --name l4d2-group \
    -e STEAM_GROUP=666 \
left4devops/l4d2

STEAM_GROUP_EXCLUSIVE

默认情况下，服务器对使用大厅中最佳可用专用服务器设置的所有玩家开放。设置STEAM_GROUP_EXCLUSIVE为true可限制访问，仅组内成员可作为大厅主机启动游戏。

shell
docker run --name l4d2-group-exclusive \
    -e STEAM_GROUP=666 \
    -e STEAM_GROUP_EXCLUSIVE=true \
left4devops/l4d2

[!NOTE] 非组内成员仍可通过mm_dedicated_force_servers命令选择你的服务器。

PORT

游戏默认会从27015开始查找可用端口。使用桥接网络时，通常会自动选择27015。你可通过此变量硬编码游戏端口，简化端口转发或防火墙配置。游戏流量和RCON使用相同端口。

使用主机网络更改端口：

shell
docker run --name l4d2-port \
    -e PORT=27016 \
    --network host \
left4devops/l4d2

使用桥接网络时需暴露新端口：

shell
docker run --name l4d2-port-bridged \
    -e PORT=27016 \
    -p 27016:27016/tcp \
    -p 27016:27016/udp \
left4devops/l4d2

为简化端口修改，可使用变量：

shell
PORT=27017
docker run --name l4d2-port-var \
    -e PORT=$PORT \
    -p $PORT:$PORT/tcp \
    -p $PORT:$PORT/udp \
left4devops/l4d2

[!WARNING] 使用桥接网络发布端口时，确保容器端口与主机端口相同。否则匹配系统会广播错误端口，导致新玩家无法连接。

DEFAULT_MAP

设置服务器首次加载时的地图。默认为各游戏的最新地图。不同游戏的地图名称不同，可在开发者控制台输入maps获取完整地图列表。启动L4D2服务器时加载"死亡中心"：

shell
docker run --name l4d2-map \
    -e DEFAULT_MAP=c1m1_hotel \
left4devops/l4d2

DEFAULT_MODE

设置服务器首次加载时的游戏模式。默认为合作模式（coop），但可从大厅更改。

shell
docker run --name l4d2-mode \
    -e DEFAULT_MODE=versus \
left4devops/l4d2

GAME_TYPES

限制服务器允许的游戏模式。不设置则允许所有模式。可选值包括coop,realism,survival,versus,scavenge,dash,holdout,shootzones

shell
docker run --name l4d2-modes \
    -e GAME_TYPES="versus,mutation19" \
left4devops/l4d2

FORK

在同一容器中运行多个游戏实例，端口自动分配（忽略PORT变量）。可通过挂载多个server##.cfg文件自定义不同实例的行为。

shell
docker run --name l4d2-forked \
    --network host \
    -e FORK=2
    -v $pwd/server01.cfg:/cfg/server01.cfg
    -v $pwd/server02.cfg:/cfg/server02.cfg
left4devops/l4d2

LAN

以局域网模式运行服务器，无需连接Steam，但玩家需通过本地IP连接。

shell
docker run --name l4d2-lan \
    --network host \
    -e LAN=true \
left4devops/l4d2

RCON_PASSWORD

"孩子，我们是免疫者，我们很累，树林里有感染者。别废话，让我们进去！"

设置RCON密码可在游戏中向服务器发送命令。登录RCON还可获得投票踢人免疫权限。设置密码：

shell
docker run --name l4d2-rcon \
    --network host \
    -e RCON_PASSWORD=cuttheshitandletusin \
left4devops/l4d2

加入服务器后，打开开发者控制台输入：

rcon_password cuttheshitandletusin
rcon

[!NOTE] 密码需设置为唯一值，因为***者常尝试字典。srcds_run会在多次失败尝试后封禁IP，使用桥接网络时可能导致所有玩家被封禁。

NET_CON_PORT

与RCON类似，网络控制台允许通过telnet客户端管理服务器。若未设置密码，强烈建议通过防火墙阻止公网访问该端口。启动监听端口***：

shell
docker run --name l4d2-netcon \
    --network host \
    -e NET_CON_PORT=17017 \
left4devops/l4d2

使用telnet客户端连接：

shell
telnet localhost 17015

NET_CON_PASSWORD

设置网络控制台密码：

shell
docker run --name l4d2-netcon-password \
    --network host \
    -e NET_CON_PORT=17015 \
    -e NET_CON_PASSWORD=cuttheshitandletusin \
left4devops/l4d2

通过telnet客户端连接后，输入PASS和密码：

shell
telnet localhost 17015
PASS cuttheshitandletusin

镜像中包含telnet客户端，可通过docker exec连接：

shell
docker exec -it l4d2 telnet localhost 17015

EXTRA_ARGS

添加其他少量设置。例如增加大型尸潮的生成频率：

shell
docker run --name l4d2-args \
    -e EXTRA_ARGS="+z_mega_mob_size 100 +z_mega_mob_spawn_min_interval 180 +z_mega_mob_spawn_max_interval 600" \
left4devops/l4d2

server.cfg

srcds_run会查找server.cfg文件。若有大量配置，可将其保存到文件并挂载到/cfg/server.cfg。

shell
docker run --name l4d2-server-cfg \
    -v $(pwd)/server.cfg:/cfg/server.cfg
left4devops/l4d2

命令行替换

可通过启动容器时提供参数完全替换环境变量配置：

shell
docker run --name l4d2-command-line \
left4devops/l4d2 +hostname "Vannah Hotel"