phyremaster/easy-gmod

Easy Gmod 镜像说明

镜像概述

Garry's Mod服务器搭建通常较为繁琐，本镜像通过Docker简化这一过程，自动安装并挂载Counter Strike: Source（CS:S）和Team Fortress 2（TF2）内容，解决地图和插件依赖这些游戏资源的问题（玩家仍需在客户端安装对应内容以避免纹理缺失）。镜像启动时会验证并更新服务器内容，确保环境最新。

核心功能

1. 自动资源集成：无需手动配置，自动安装CS:S和TF2内容并挂载到服务器。
2. 简化参数配置：通过环境变量快速设置服务器名称、玩家上限、游戏模式等核心参数。
3. 插件支持：通过Steam Workshop集合ID自动安装并更新插件，玩家可从Workshop直接下载。
4. 下载加速：支持FastDL配置，提升非Workshop资源的下载速度。
5. 灵活部署：支持端口映射、数据卷持久化、后台运行等Docker特性，便于管理。

使用场景

• 快速搭建Garry's Mod服务器的个人或管理员。
• 需要运行依赖CS:S/TF2资源的游戏模式（如Prop Hunt、Trouble in Terrorist Town）。
• 希望通过Docker简化服务器更新和维护流程的用户。

配置说明

前提条件

需安装Docker环境：

• Windows：下载Docker CE桌面版（https://hub.docker.com/editions/community/docker-ce-desktop-windows%EF%BC%89%E3%80%82
• Linux：通过包管理器安装（如sudo apt-get install docker-ce）。

基础运行命令

bash
docker run -p 27015:27015/udp -p 27005:27005/udp -p 27015:27015/tcp phyremaster/easy-gmod

关键配置选项

端口映射

• 27015/udp：Gmod服务器端口（必填）。
• 27005/udp：客户端端口（用于服务器列表显示）。
• 27015/tcp：RCON端口（启用远程控制台时需配置）。

数据卷挂载

持久化服务器文件（避免容器停止后数据丢失）：

bash
docker run -v /本地路径/garrysmod:/home/steam/garrysmod \
           -v /本地路径/css:/home/steam/css \
           -v /本地路径/tf2:/home/steam/tf2 \
           -p ... phyremaster/easy-gmod

Linux用户需对本地路径执行chmod 777以确保权限。

环境变量配置

常用环境变量示例：

• HOSTNAME：服务器名称（默认："A Garry's Mod Server"）。
• MAXPLAYERS：最大玩家数（默认：20）。
• GAMEMODE：游戏模式（默认：sandbox）。
• GAMEMAP：初始地图（默认：gm_flatgrass）。
• WORKSHOPID：Steam Workshop插件集合ID（自动安装插件）。
• DOWNLOADURL：FastDL资源链接（加速非Workshop文件下载）。

示例：设置自定义服务器名称和玩家上限

bash
docker run -e HOSTNAME="我的Gmod服务器" -e MAXPLAYERS=32 \
           -p 27015:27015/udp -p 27005:27005/udp \
           phyremaster/easy-gmod

后台运行与容器管理

• 后台运行：添加-d参数（如docker run -d -p ...）。
• 容器命名：添加--name参数（如--name gmod-server）。
• 自动重启：添加--restart on-failure参数（容器崩溃时自动重启）。

参考信息

端口列表

数据卷路径

常用环境变量

注意：含空格或特殊字符的环境变量值需用引号包裹（如-e HOSTNAME="我的服务器"）。