自行实现查询SCP：秘密实验室服务器信息（A2S 协议）

各位好呀，本文章要讨论的就是如何自行实现查询 SCP：Secret Laboratory 游戏服务器信息（如人数）。首先，对于已列入官方服务器列表的服务器是可以直接使用 Northwood 提供的查询 API 的，但是，如果你并没有在列表上的服务器，或者说 IP 因为某些原因被 Cloudflare 屏蔽无法使用 Northwood 的查询 API，那么就需要考虑自行实现了。

自行实现的方法有很多种，比如你可以自己写一个插件获取信息并开放一个查询接口出来，或者使用 A2S 协议查询服务器，这就是本文要讲的内容。

关于 A2S 协议#

A2S 是一种基于 UDP 的游戏服务器查询协议，由 Valve Software 作为 Steam SDK 的一部分维护，而 SCP：Secret Laboratory 同样支持此协议，使我们能够直接获取服务器信息。

注意事项#

在文章的主要内容开始之前，我要讲一些注意事项…：

由于 A2S 使用 UDP 协议，所以请确保你的查询环境（如 VPS/云服务器）未封锁 UDP。
有相当一部分位于中国的服务器屏蔽了来自海外的 UDP 请求，因此如果你的查询环境在中国境外，则可能无法正常获取这些服务器的信息。

请一定要认真阅读这些，谢谢…

实现步骤#

因为在 Server queries/Implementations 中有 30+ 种 A2S 库，所以咱们将借助成熟的开发库来实现，避免从零造轮子，以 PHP 为例，本文使用 xPaw/PHP-Source-Query PHP 库做示例。

这个库共提供了 8 个函数，除去连接服务器相关的有 6 个，但是在这 6 个函数中，SCP: Secret Laboratory 服务器只支持应答 GetInfo 函数，使用其他函数不会返回任何信息（只会报错），不过好消息是 GetInfo 获取的信息中包含了人数等，对于基础查询来说是够用的了。

安装#

这里假设你已经配置好了 PHP 开发环境和 Composer 。在项目目录中执行以下命令安装依赖：

1
composer require xpaw/php-source-query-class

（在国内网络环境下可能安装缓慢，可以考虑配置 Composer 中国镜像。）

编写代码#

在你的项目目录中创建一个 PHP 文件，并写入以下代码：

1
<?php
2
require 'vendor/autoload.php';
3

4
use xPaw\SourceQuery\SourceQuery;
5
// 设置响应头
6
header("Content-Type: text/plain; X-Content-Type-Options: nosniff; charset=utf-8");
7

8
// 服务器配置常量
9
const SQ_SERVER_ADDR = '127.0.0.1'; // 替换为你的服务器 IP
10
const SQ_SERVER_PORT = 7777; // 替换为你的服务器端口
11
const SQ_TIMEOUT = 1; // 超时时间（秒）
12
const SQ_ENGINE = SourceQuery::SOURCE; // 请勿修改
13

14
$Query = new SourceQuery();
15
try
16
{
17
    // 连接服务器
18
    $Query->Connect(SQ_SERVER_ADDR, SQ_SERVER_PORT, SQ_TIMEOUT, SQ_ENGINE);
19
    // 执行查询并打印原始结果
20
    print_r($Query->GetInfo());
21
}
22
catch( Exception $e )
23
{
24
    // 报错
25
    echo $e->getMessage();
26
}
27
finally
28
{
29
    // 确保断开连接
30
    $Query->Disconnect( );
31
}

运行#

运行此 PHP 文件，如果查询成功，你将看到类似以下的输出结构：

1
Array
2
(
3
    [Protocol] => 17
4
    [HostName] => [CN]BA:基沃托斯 沙勒服 BGP轻插服-沙勒本部 服务器群:917260212 有规则服务器 回合已进行[00:00] | 0/0 SCPs 存活 BGP/设施冰封/文字聊天/粉糖刷新/无限体力＆子弹/BA插件角色/娱乐插件Exiled 9.10.0SAC 4.3.8
5
    [Map] => Facility
6
    [ModDir] => scp secret laboratory
7
    [ModDesc] => SCP: Secret Laboratory
8
    [AppID] => 44970
9
    [Players] => 23
10
    [MaxPlayers] => 45
11
    [Bots] => 0
12
    [Dedicated] => d
13
    [Os] => w
14
    [Password] =>
15
    [Secure] =>
16
    [Version] => 14.2.0
17
    [ExtraDataFlags] => 145
18
    [GamePort] => 55513
19
    [SteamID] => 0
20
    [GameID] => 700330
21
)

否则：

1
Failed to read any data from socket

如果查询失败的话，请检查常量是否配置正确，如果都配置正确的话可以仔细阅读一下注意事项，实在不行可以到评论区中寻求帮助（注：请提供详细的日志与运行环境信息）。

结语#

至此，你已经成功自行实现了查询 SCP: Secret Laboratory 服务器，获取到数据之后可以自行加工等，希望本文章对你有帮助，拜拜！

By 德二吹风机

自行实现查询SCP：秘密实验室服务器信息（A2S 协议）

关于 A2S 协议#

注意事项#

实现步骤#

安装#

编写代码#

运行#

结语#

支持与分享

评论区

目录