使用 FastDL 和 Nginx 分发 Garry's Mod 内容
使用 Nginx 为 Garry's Mod 配置 FastDL:bzip2 压缩、sv_downloadurl、resource.AddFile、安全发布、验证、回滚和故障排除。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何通过 FastDL,从专用的 Nginx 站点向玩家发送您的自定义内容:准备文件、压缩、发布、服务器配置和回滚。
HostMyServers 不提供托管式游戏主机服务:您需要在自己的 VPS 或专用服务器上自行管理该服务器。
是否需要使用 FastDL?
| 方法 | 速度 | 适用于 |
|---|---|---|
Workshop(resource.AddWorkshop) |
最快 | 任何可以发布到 Workshop 的内容,应优先使用 |
FastDL(sv_downloadurl) |
较快,逐个文件下载 | 无法发布到 Workshop 的内容 |
从游戏服务器下载(sv_allowdownload) |
限制为 64 KB/s | 应避免 |
.lua 文件不受影响:游戏通过另一种机制传输它们。
工作原理
- 服务器使用
resource.AddFile标记需要下载的文件。这些文件必须存在于游戏服务器上 - 玩家收到
sv_downloadurl中定义的地址 - 对于每个缺失的文件,玩家先请求压缩版本,再请求普通版本:
http://fastdl.您的域名.com/materials/my_server/logo.vmt.bz2
http://fastdl.您的域名.com/materials/my_server/logo.vmt因此,网站上的路径必须与 garrysmod/ 中的路径一致。
前提条件
- 已按照创建 Garry's Mod 服务器指南安装好的服务器。本指南沿用该指南中的
gmod用户、/home/gmod/gmod-server目录和gmod.service服务 - 具有
sudo权限的 SSH 访问 - 一个子域名,此处为
fastdl.您的域名.com,并带有指向服务器 IP 地址的 DNSA记录 - TCP 端口 80 可用:如果此服务器上已有其他站点在使用 Nginx,本指南只会额外添加一个独立站点
继续之前,请先检查 DNS:
getent hosts fastdl.您的域名.com步骤 1:备份配置
sudo -u gmod cp -p /home/gmod/gmod-server/garrysmod/cfg/server.cfg /home/gmod/server.cfg.before-fastdl
sudo -u gmod ls -l /home/gmod/server.cfg.before-fastdl步骤 2:安装 Nginx 和 bzip2
sudo apt update
sudo apt install -y nginx bzip2然后创建站点文件夹。它归 gmod 所有,由 gmod 向其中发布文件,并保持 Nginx 可读;在 Debian 和 Ubuntu 软件包中,Nginx 以 www-data 身份运行:
sudo install -d -o gmod -g www-data -m 2750 /var/www/gmod-fastdl /var/www/gmod-fastdl/releases
sudo ls -ld /var/www/gmod-fastdl /var/www/gmod-fastdl/releases显示的权限应为 drwxr-s---,所有者为 gmod 和 www-data。
步骤 3:放置您的内容
您的文件必须存在于游戏服务器上。请将它们集中放在一个插件中,遵循游戏的目录结构,并且只使用小写字母:
garrysmod/addons/my_content/
├── materials/my_server/logo.vmt
├── materials/my_server/logo.vtf
├── models/my_server/crate.mdl
└── sound/my_server/announcement.mp3如果您已将这些文件上传到管理账户的 ~/my_content 文件夹中,请这样复制它们:
sudo mkdir -p /home/gmod/gmod-server/garrysmod/addons/my_content
sudo cp -r ~/my_content/. /home/gmod/gmod-server/garrysmod/addons/my_content/
sudo chown -R gmod:gmod /home/gmod/gmod-server/garrysmod/addons/my_content步骤 4:创建发布脚本
该脚本会复制允许的文件类型,压缩它们,并将全部内容发布为一个新版本。它会保留最近的几个版本,以便回滚。
sudo -u gmod nano /home/gmod/fastdl-sync.sh#!/bin/bash
set -euo pipefail
umask 027
GAME="/home/gmod/gmod-server/garrysmod"
WEB="/var/www/gmod-fastdl"
KEEP=3
# 要发布的文件夹,每个都按 garrysmod/ 的结构组织
SOURCES=(
"$GAME/addons/my_content"
"$GAME/gamemodes/darkrp/content"
)
NEW="$WEB/releases/$(date +%Y-%m-%d_%H-%M-%S)"
mkdir "$NEW"
for src in "${SOURCES[@]}"; do
[ -d "$src" ] || continue
cd "$src"
for dir in maps materials models particles resource sound; do
[ -d "$dir" ] || continue
find "$dir" -type f \( \
-iname '*.bsp' -o -iname '*.vmt' -o -iname '*.vtf' -o -iname '*.png' -o -iname '*.jpg' \
-o -iname '*.mdl' -o -iname '*.vvd' -o -iname '*.vtx' -o -iname '*.phy' -o -iname '*.ani' \
-o -iname '*.pcf' -o -iname '*.ttf' -o -iname '*.otf' \
-o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.ogg' \
\) -print0 | while IFS= read -r -d '' file; do
mkdir -p "$NEW/$(dirname "$file")"
cp -- "$file" "$NEW/$file"
bzip2 -9 -k -f -- "$NEW/$file"
done
done
done
count=$(find "$NEW" -type f ! -name '*.bz2' | wc -l)
if [ "$count" -eq 0 ]; then
rm -rf "$NEW"
echo "没有可发布的文件: 保留当前版本." >&2
exit 1
fi
ln -sfn "$NEW" "$WEB/current"
# 删除最旧的版本
ls -1dt "$WEB"/releases/* | tail -n +$((KEEP + 1)) | xargs -r rm -rf --
echo "发布完成: $count 个文件位于 $NEW"使脚本可执行,然后运行它:
sudo -u gmod chmod 700 /home/gmod/fastdl-sync.sh
sudo -u gmod /home/gmod/fastdl-sync.sh如果 gamemodes/darkrp/content 文件夹不存在,则会被忽略。之所以列出它,是因为 DarkRP 会用 resource.AddFile 标记其部分文件:因此这些文件也必须能从 FastDL 获取。其他任何内容已被标记的插件,也请添加到 SOURCES 中。
步骤 5:配置 Nginx
sudo nano /etc/nginx/sites-available/gmod-fastdlserver {
listen 80;
listen [::]:80;
server_name fastdl.您的域名.com;
root /var/www/gmod-fastdl/current;
autoindex off;
gzip off;
types { }
default_type application/octet-stream;
add_header X-Content-Type-Options nosniff always;
access_log /var/log/nginx/gmod-fastdl.access.log;
error_log /var/log/nginx/gmod-fastdl.error.log;
location / {
return 404;
}
location ~ ^/(maps|materials|models|particles|resource|sound)/ {
limit_except GET {
deny all;
}
try_files $uri =404;
}
}只有内容文件夹可以访问。启用该站点,测试配置并重新加载 Nginx:
sudo ln -s /etc/nginx/sites-available/gmod-fastdl /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t
sudo systemctl reload nginxnginx -t 应显示 syntax is ok 和 test is successful。
步骤 6:开放端口 80
请使用服务器上已有的防火墙工具。
使用 UFW
sudo ufw allow 80/tcp
sudo ufw reload使用 iptables
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4使用 nftables
sudo nft add rule inet filter input tcp dport 80 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf步骤 7:检查站点
请测试您的某个文件,并根据实际情况调整其路径。第一条命令应返回 200:
curl -I http://fastdl.您的域名.com/materials/my_server/logo.vmt.bz2
curl -fsS http://fastdl.您的域名.com/materials/my_server/logo.vmt.bz2 | bunzip2 | sudo -u gmod cmp - /home/gmod/gmod-server/garrysmod/addons/my_content/materials/my_server/logo.vmtcmp 命令不应显示任何内容:这表示已发布的文件与原件完全相同。
还要检查其余内容是否无法访问。这两个请求都应返回 404:
curl -I http://fastdl.您的域名.com/
curl -I http://fastdl.您的域名.com/cfg/server.cfg步骤 8:标记需要下载的文件
创建一个服务器端 Lua 文件:
sudo -u gmod mkdir -p /home/gmod/gmod-server/garrysmod/lua/autorun/server
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.luaresource.AddFile( "materials/my_server/logo.vmt" )
resource.AddFile( "models/my_server/crate.mdl" )
resource.AddFile( "sound/my_server/announcement.mp3" )请从 garrysmod/ 开始写路径,不含 addons/my_content/,也不含 .bz2。resource.AddFile 还会添加相关文件:.vmt 对应的 .vtf,或 .mdl 对应的 .vvd、.vtx 和 .phy。游戏将此列表限制为 8192 个文件。
步骤 9:在服务器上启用 FastDL
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/cfg/server.cfg添加这些行,地址末尾不要加 /:
sv_downloadurl "http://fastdl.您的域名.com"
sv_allowdownload 0sv_allowdownload 0 会禁用直接从游戏服务器下载,这种方式速度慢且容易被滥用。请重启服务器:
sudo systemctl restart gmod.service步骤 10:在游戏中检查
-
在服务器上,跟踪请求:
终端sudo tail -f /var/log/nginx/gmod-fastdl.access.log -
在您的电脑上,如果
garrysmod/download/文件夹存在,请删除其中的测试内容 -
连接到服务器
您的 .bz2 文件的请求应以状态码 200 出现,并且内容应在游戏中正常显示。按 Ctrl+C 退出跟踪。
更新内容
游戏不会比较文件内容:已经拥有某个文件的玩家不会再次下载它,即使它已经改变。要分发新版本,请为文件起一个新名称,并相应调整 fastdl.lua 以及对该文件的引用。
然后发布;如果 fastdl.lua 有变化,请重启服务器:
sudo -u gmod /home/gmod/fastdl-sync.sh
sudo systemctl restart gmod.service回滚
回到之前的发布版本
sudo -u gmod ls -1t /var/www/gmod-fastdl/releases
sudo -u gmod ln -sfn /var/www/gmod-fastdl/releases/YYYY-MM-DD_HH-MM-SS /var/www/gmod-fastdl/current更改立即生效,无需重启 Nginx。
停用 FastDL
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/server.cfg.before-fastdl /home/gmod/gmod-server/garrysmod/cfg/server.cfg
sudo -u gmod rm -f /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.lua
sudo rm -f /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t && sudo systemctl reload nginx
sudo systemctl start gmod.serviceserver.cfg 的副本不包含步骤 1 之后所做的更改:如有需要,请重新应用。
故障排除
HTTP ERROR 1 (Zero Length File) downloading ... 或 HTTP ERROR 2 (Connection closed) downloading ...
这些消息出现在玩家的控制台中。请检查 sv_downloadurl 是否以 http:// 开头,该子域名上的 Cloudflare 代理是否已禁用,以及所指的文件是否能通过 curl -I 得到响应。
Nginx 日志显示 404 错误
文件未发布,或其路径不同。列出失败的请求:
sudo awk '$9 == 404 {print $7}' /var/log/nginx/gmod-fastdl.access.log | sort | uniq -c | sort -rn | head请检查路径的大小写,必要时将其文件夹添加到 SOURCES,然后重新运行脚本。指向 / 或其他无关地址的请求通常来自机器人,可以忽略。
Nginx 日志显示 403 错误或 Permission denied
请检查每一级权限:
sudo namei -l /var/www/gmod-fastdl/current/materials这些文件夹必须属于 www-data 组。如果您是以 gmod 以外的用户发布的,请修正权限,然后重新运行脚本:
sudo chown -R gmod:www-data /var/www/gmod-fastdlmkdir: cannot create directory ... Permission denied
脚本不是以 gmod 身份运行的,或者文件夹没有在步骤 2 中创建。请使用 sudo -u gmod /home/gmod/fastdl-sync.sh。
没有可发布的文件
源文件夹为空,或者文件不在 materials、models、sound 或其他被识别的文件夹中。请检查步骤 3 中的目录结构。
bind() to 0.0.0.0:80 failed (98: Address already in use)
另一个服务占用了端口 80。请使用 sudo ss -ltnp | grep ':80 ' 找出它。
玩家什么都没有下载
- 使用
rcon sv_downloadurl检查当前生效的值 - 检查文件是否已在
fastdl.lua中标记,并且存在于游戏服务器上:否则它不会被加入列表 - 玩家可能在选项中限制了下载。其控制台中的
cl_downloadfilter命令的值必须为all - 该文件可能已经存在于其
garrysmod/download/文件夹中
玩家仍然看到旧版本
这是游戏的正常行为。请按照更新一节中的说明重命名文件。
FAQ
需要把 Workshop 插件发布到 FastDL 吗?
不需要。请使用 resource.AddWorkshop,服务器安装指南中有说明。
可以把 FastDL 托管在另一台服务器上吗?
可以。在那台机器上安装 Nginx,并用 rsync 或 scp 将 current 的内容复制过去。这些文件仍必须保留在游戏服务器上,否则 resource.AddFile 不会将它们加入列表。
.bz2 文件是必需的吗?
不是,但它们可以减少传输量。脚本同时保留普通版本,在缺少压缩版本时使用。