oksii/etlegacy

ET:Legacy 匹配服务器 Docker 镜像

镜像概述和主要用途

该Docker镜像用于部署ET:Legacy游戏服务器，可自动从指定URL下载地图（通过MAPS环境变量指定），并使用最新快照版本启动服务器。配置可通过环境变量定义或使用默认值，支持挂载地图卷以避免HTTP下载，日志输出到STDOUT便于通过docker logs查看。

核心功能和特性

• 自动地图管理：根据MAPS环境变量从REDIRECTURL下载所需地图，支持挂载/maps卷优先使用本地地图
• 灵活配置：通过环境变量自定义服务器参数，如主机名、密码、最大玩家数等
• 日志管理：所有日志输出到STDOUT，支持docker logs查看
• 自动配置更新：容器启动时从SETTINGSURL拉取最新配置（默认使用https://github.com/Oksii/legacy-configs%EF%BC%89
• 性能维护：包含autorestart.sh脚本，可在检查无活跃玩家后重启服务器
• 稳定标签：stable标签推荐用于竞技游戏，积极维护并随ET:Legacy快照自动构建

使用场景和适用范围

适用于需要快速部署ET:Legacy游戏服务器的场景，如游戏社区服务器、比赛服务器、私人游戏房间等。支持单实例或多实例部署，适合各类规模的游戏服务需求。

使用方法和配置说明

docker-compose（推荐）

yaml
services:
  etl-server:
    container_name: etl-server
    image: oksii/etlegacy:stable
    environment:
      - 'HOSTNAME=ET Legacy Docker' 
      - 'MAPS=adlernest:braundorf_b4:supply:sw_goldrush_te'
      - 'PASSWORD=etlserver'
    volumes:
      - ./maps:/maps
    ports:
      - '27960:27960/udp'
    stdin_open: true
    tty: true
    restart: unless-stopped

docker cli

bash
docker run -d \
  -p "27960:27960/udp" \
  -e "MAPS=adlernest:te_escape2:frostbite" \
  -e "PASSWORD=war" \
  -e "REFEREEPASSWORD=pass123" \
  oksii/etlegacy:stable

引导安装脚本

https://github.com/Oksii/etlegacy/blob/main/example/docker-install-script.sh%E8%84%9A%E6%9C%AC%E5%8F%AF%E5%AE%89%E8%A3%85%E6%89%80%E9%9C%80%E4%BE%9D%E8%B5%96%E5%92%8CDocker%EF%BC%8C%E5%B9%B6%E5%BC%95%E5%AF%BC%E5%AE%8C%E6%88%90%E9%85%8D%E7%BD%AE%E3%80%82%E6%94%AF%E6%8C%81%E4%BB%A5%E4%B8%8B%E5%8A%9F%E8%83%BD%EF%BC%9A

• watchtower自动更新
• 用于REDIRECTURL和wwwDownloads的极简Web服务器
• 定时自动重启避免性能下降
• etl-server辅助脚本便于服务器管理

支持单实例或多实例配置，使用docker-compose方法，配置可通过settings.env文件修改。

安装命令：

bash
cd ~ && \
    curl -sSL https://raw.githubusercontent.com/Oksii/etlegacy/main/example/docker-install-script.sh \
        -o docker-install-script.sh && \
    chmod +x docker-install-script.sh && \
    sudo ./docker-install-script.sh

配置说明

基础环境变量

默认SETTINGSURL的配置参数

注意：可通过挂载配置到/legacy/server/extra.cfg来添加额外配置，但建议优先使用上述环境变量或自定义SETTINGSURL。

进一步示例

watchtower集成

通过watchtower实现自动更新和重启，确保仅在无玩家时重启。需启用watchtower的--enable-lifecycle-hooks并添加以下标签：

yaml
  labels:
    - "com.centurylinklabs.watchtower.enable=true"
    - "com.centurylinklabs.watchtower.lifecycle.pre-update=/legacy/server/autorestart"

  watchtower:
    container_name: watchtower
    image: containrrr/watchtower
    command: --enable-lifecycle-hooks
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    labels:
      - "com.centurylinklabs.watchtower.enable=false"
      - "com.watchtower=watchtower"

ETL-Server 辅助脚本

etl-server辅助脚本提供简单命令管理ET:Legacy服务器实例，使用引导安装脚本时自动安装。

用法

bash
etl-server [start|stop|restart|status|logs|rcon|update] [instance_number] [command]

可用命令

状态信息

状态命令显示详细信息：容器状态和运行时间、服务器名称和当前地图、活跃玩家、端口配置、密码设置。

更新安全特性

更新命令包含安全检查：更新前检查活跃玩家、有玩家时发出警告、提供--force选项强制更新、更新前显示详细服务器状态。

示例

bash
etl-server start            # 启动所有服务器实例
etl-server stop 2           # 停止特定实例
etl-server status           # 查看所有服务器状态
etl-server update 2         # 更新特定实例（先检查玩家）
etl-server update 2 --force # 强制更新即使有活跃玩家
etl-server rcon 1 map radar # 在实例1上执行RCON命令
etl-server logs 2           # 查看实例2的实时日志

注意

• 脚本需要安装Docker和docker-compose
• 多实例支持在初始设置时配置
• 所有命令遵循settings.env文件中的配置
• 更新默认检查活跃玩家以避免中断