中文

游戏服务器

使用 FastDL 和 Nginx 分发 Garry's Mod 内容

使用 Nginx 为 Garry's Mod 配置 FastDL:bzip2 压缩、sv_downloadurl、resource.AddFile、安全发布、验证、回滚和故障排除。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何通过 FastDL,从专用的 Nginx 站点向玩家发送您的自定义内容:准备文件、压缩、发布、服务器配置和回滚。

HostMyServers 不提供托管式游戏主机服务:您需要在自己的 VPS 或专用服务器上自行管理该服务器。

是否需要使用 FastDL?

方法 速度 适用于
Workshop(resource.AddWorkshop) 最快 任何可以发布到 Workshop 的内容,应优先使用
FastDL(sv_downloadurl) 较快,逐个文件下载 无法发布到 Workshop 的内容
从游戏服务器下载(sv_allowdownload) 限制为 64 KB/s 应避免

.lua 文件不受影响:游戏通过另一种机制传输它们。

工作原理

  1. 服务器使用 resource.AddFile 标记需要下载的文件。这些文件必须存在于游戏服务器上
  2. 玩家收到 sv_downloadurl 中定义的地址
  3. 对于每个缺失的文件,玩家先请求压缩版本,再请求普通版本:
文本
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 地址的 DNS A 记录
  • 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-fastdl
Nginx
server {
    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 nginx

nginx -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.vmt

cmp 命令不应显示任何内容:这表示已发布的文件与原件完全相同。

还要检查其余内容是否无法访问。这两个请求都应返回 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.lua
lua
resource.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 0

sv_allowdownload 0 会禁用直接从游戏服务器下载,这种方式速度慢且容易被滥用。请重启服务器:

终端
sudo systemctl restart gmod.service

步骤 10:在游戏中检查

  1. 在服务器上,跟踪请求:

    终端
    sudo tail -f /var/log/nginx/gmod-fastdl.access.log
  2. 在您的电脑上,如果 garrysmod/download/ 文件夹存在,请删除其中的测试内容

  3. 连接到服务器

您的 .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.service

server.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-fastdl

mkdir: 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 文件是必需的吗?

不是,但它们可以减少传输量。脚本同时保留普通版本,在缺少压缩版本时使用。