9.1 游戏服务器机制
上一章处理了网络层,这一节把视角从「玩家之间的连接」抬到「服务器作为平台对象」:一台专用服务器要出现在服务器浏览器里、要验证玩家、要决定是否启用 VAC——这些都不是游戏逻辑自己声明的,而是通过 SteamGameServer 这一组接口向 Steam 平台登记的。接入工程要理解的不只是「调 LogOn 就登录」,而是服务器生命周期与属性可变性的边界。
本卷所有接口口径以 Steamworks SDK v1.65(2026-07-23) 为准。本节摘录的签名对照该版本 public/steam/steam_gameserver.h、isteamgameserver.h。
本章与站内既有内容的分工
- Steam 发行专题 (操作手册)讲「后台配置服务器列表与反作弊」;本节讲「专用服务器代码里怎么初始化、怎么登录、什么时候能改属性」。
- 卷一《平台机制与商店》讲账号与客户端机制;本节把「服务器即平台对象」的机制判断落到
SteamGameServer_Init与EServerMode的接口语义。 - lab 用纯 C++ 复现服务器初始化状态机与连接/失败回调,不依赖 Steam 客户端运行。
初始化:SteamGameServer_Init 与 EServerMode
专用服务器接入的第一步与普通游戏不同:它初始化的是 SteamGameServer 上下文,而不是 SteamAPI_Init 的客户端上下文。入口签名:
// steam_gameserver.h:SteamGameServer_InitEx/Init(SDK v1.65 头文件摘录,已删减)
inline ESteamAPIInitResult SteamGameServer_InitEx( uint32 unIP, uint16 usGamePort, uint16 usQueryPort, EServerMode eServerMode, const char *pchVersionString, SteamErrMsg *pOutErrMsg );
inline bool SteamGameServer_Init( uint32 unIP, uint16 usGamePort, uint16 usQueryPort, EServerMode eServerMode, const char *pchVersionString )
{
return SteamGameServer_InitEx( unIP, usGamePort, usQueryPort, eServerMode, pchVersionString, NULL ) == k_ESteamAPIInitResult_OK;
}
工程语义有三个要点:
usQueryPort决定服务器浏览器通信方式。传STEAMGAMESERVER_QUERY_PORT_SHARED(0xffff)时进入共享 socket 模式,游戏负责用HandleIncomingPacket/GetNextOutgoingPacket在自有的 UDP socket 上收发查询包,免去多开一个端口。pchVersionString是主服务器判断版本的方式。头文件注释明确版本串形如x.x.x.x,只有最新版本的服务器才会被列出——这比客户端侧的接口版本校验更粗粒度,服务器工程应在版本串里带上可识别的构建号。- 初始化与属性设置的顺序是硬约束。注释反复强调:
SetProduct、SetGameDescription、SetModDir、SetDedicatedServer等属性「must be set before before calling LogOn」且登录后不可改。
EServerMode:安全模式即反作弊开关
EServerMode 是服务器初始化时唯一的「安全档位」,四个值把三件事耦合在一起:是否认证用户、是否上服务器列表、是否启用 VAC:
// steam_gameserver.h:EServerMode(SDK v1.65 头文件摘录,已删减)
enum EServerMode
{
eServerModeInvalid = 0, // DO NOT USE
eServerModeNoAuthentication = 1, // Don't authenticate user logins and don't list on the server list
eServerModeAuthentication = 2, // Authenticate users, list on the server list, don't run VAC on clients that connect
eServerModeAuthenticationAndSecure = 3, // Authenticate users, list on the server list and VAC protect clients
};
工程语义:
NoAuthentication只适合纯离线/私服:不认证、不列列表,VAC 也不跑。Authentication与AuthenticationAndSecure的区别就是 VAC:认证和列表行为一致,后者额外对连接玩家跑 VAC。对买断制多人游戏,「不启用 VAC」意味着把反作弊决定权让给了自己的封禁体系——下一节详讲。BSecure()是运行态可见的 secure 标记:客户端连接时据此判断服务器是否「安全」;GSPolicyResponse_t回调把该标记广播给玩家侧。模式在初始化时定死,运行中不可切换。
登录生命周期:LogOn / LogOnAnonymous / BLoggedOn
初始化完成后,服务器要真正「上线」还需要登录。v1.65 提供两种登录:
// isteamgameserver.h:ISteamGameServer 登录与状态(SDK v1.65 头文件摘录,已删减)
virtual void LogOn( const char *pszToken ) = 0;
virtual void LogOnAnonymous() = 0;
virtual void LogOff() = 0;
virtual bool BLoggedOn() = 0;
virtual bool BSecure() = 0;
virtual CSteamID GetSteamID() = 0;
工程语义:
LogOn(pszToken)是持久账号登录:需要向 Steamworks 申请专用服务器登录 token,登录结果靠回调(SteamServersConnected_t/SteamServerConnectFailure_t)异步到达。适合需要稳定 SteamID 的长驻服务器。LogOnAnonymous()是匿名登录:不给 token 也能登录并上列表,但 SteamID 是匿名的、不可复用。对一次性开服的社区服务器足够。- 登录是异步状态机:调用 LogOn 之后
BLoggedOn()不会立刻变 true——工程上应把「已发出登录请求 / 已连接 / 已断开」三个状态分开,靠回调推进,而不是轮询。 LogOff()与断开:主动下线调用 LogOff;连接丢失会收到SteamServersDisconnected_t。单线程服务器不手动释放线程内存,SteamGameServer_RunCallbacks()会代劳。
接口签名对照
| 头文件 | 条目 | 语义 |
|---|---|---|
steam_gameserver.h | EServerMode | 服务器安全模式(认证/列表/VAC 三档耦合) |
steam_gameserver.h | SteamGameServer_InitEx | 服务器初始化入口,返回 ESteamAPIInitResult |
steam_gameserver.h | SteamGameServer_Init | InitEx==OK 的布尔包装 |
steam_gameserver.h | STEAMGAMESERVER_QUERY_PORT_SHARED | 共享 socket 查询端口标记 |
isteamgameserver.h | ISteamGameServer::LogOn(pszToken) | 持久账号登录 |
isteamgameserver.h | ISteamGameServer::LogOnAnonymous() | 匿名登录 |
isteamgameserver.h | ISteamGameServer::LogOff() | 主动下线 |
isteamgameserver.h | ISteamGameServer::BLoggedOn()/BSecure() | 运行态登录与 secure 门控 |
数据口径与来源
EServerMode各值语义、SteamGameServer_InitEx签名、查询端口常量:SDK v1.65public/steam/steam_gameserver.h可实证(本机镜像已核对)。- 「登录前必须设属性、登录后不可改」:
isteamgameserver.h注释明文。 - 服务器登录 token 的申请流程与额度:partner 文档登录后可见,以官方当前为准;本卷不给假设数值。
以上接口口径撰写时对照 Steamworks SDK v1.65 头文件与 partner.steamgames.com 官方文档核对;登录后可见数据以官方当前为准。
可运行产物:C++ 最小验证
下面的仿真复现「游戏服务器生命周期」的工程语义:初始化状态机、EServerMode 与 BSecure 的关系、LogOn/LogOnAnonymous 登录、LogOff、连接/失败回调、登录前后属性可变性边界。它与 src/09-1-game-server-mechanics.cpp 逐字节一致,mock 接口签名对照 SDK v1.65 头文件:
// file: src/09-1-game-server-mechanics.cpp
// tier: L1
// verify: clang++ -std=c++20 -Wall -I. src/09-1-game-server-mechanics.cpp -o bin/09-1-game-server-mechanics && ./bin/09-1-game-server-mechanics
//
// mock:复现游戏服务器接入的生命周期——SteamGameServer_Init/InitEx 初始化、
// EServerMode 安全模式、LogOn/LogOnAnonymous 登录、LogOff、连接/失败回调、
// 以及登录前后属性的可变性边界。
// 签名对照 SDK v1.65 steam_gameserver.h / isteamgameserver.h,非 Valve 实现。
#include "verify.h"
#include <cstdint>
#include <string>
namespace steam_repro {
// EServerMode 枚举值对照 steam_gameserver.h
enum MockServerMode {
kModeInvalid = 0,
kModeNoAuthentication = 1,
kModeAuthentication = 2,
kModeAuthenticationAndSecure = 3,
};
constexpr uint16_t kQueryPortShared = 0xffff; // STEAMGAMESERVER_QUERY_PORT_SHARED
// SteamServersConnected_t 语义:登录成功后由回调泵派发
struct MockServersConnected {
enum { kCallback = 100 + 1 }; // k_iSteamUserCallbacks + 1
};
// SteamServerConnectFailure_t 语义:登录失败(token 拒绝)时派发
struct MockServerConnectFailure {
enum { kCallback = 100 + 2 };
int result;
bool stillRetrying;
};
class MockSteamGameServer {
public:
// SteamGameServer_InitEx:初始化并设置不可变属性;返回 ESteamAPIInitResult
int initEx(uint32_t unIP, uint16_t usGamePort, uint16_t usQueryPort,
int eServerMode, const char* versionString, std::string* pErrMsg) {
(void)unIP;
(void)usGamePort;
(void)usQueryPort;
if (eServerMode == kModeInvalid) {
if (pErrMsg) *pErrMsg = "server mode invalid";
return 1; // k_ESteamAPIInitResult_FailedGeneric
}
if (versionString == nullptr || versionString[0] == '\0') {
if (pErrMsg) *pErrMsg = "version string required";
return 1; // k_ESteamAPIInitResult_FailedGeneric
}
mode_ = eServerMode;
inited_ = true;
connected_ = false;
pendingLogin_ = false;
pendingFailure_ = false;
return 0; // k_ESteamAPIInitResult_OK
}
// SteamGameServer_Init:布尔包装
bool init(uint32_t unIP, uint16_t usGamePort, uint16_t usQueryPort,
int eServerMode, const char* versionString) {
return initEx(unIP, usGamePort, usQueryPort, eServerMode, versionString, nullptr) == 0;
}
// ISteamGameServer::LogOn:以持久账号 token 登录
void logOn(const char* token) {
if (!inited_) return;
if (token != nullptr && std::string(token) == kValidToken) {
pendingLogin_ = true;
pendingFailure_ = false;
} else {
pendingLogin_ = false;
pendingFailure_ = true;
}
}
// ISteamGameServer::LogOnAnonymous:匿名账号登录
void logOnAnonymous() {
if (!inited_) return;
pendingLogin_ = true;
pendingFailure_ = false;
}
// 推进一帧(回调泵):完成登录,产生连接/失败回调
int pump() {
int cb = 0;
if (pendingLogin_) {
connected_ = true;
pendingLogin_ = false;
cb = MockServersConnected::kCallback;
} else if (pendingFailure_) {
connected_ = false;
pendingFailure_ = false;
cb = MockServerConnectFailure::kCallback;
}
return cb;
}
// ISteamGameServer::LogOff
void logOff() {
connected_ = false;
pendingLogin_ = false;
pendingFailure_ = false;
}
// ISteamGameServer::BLoggedOn
bool bLoggedOn() const { return inited_ && connected_; }
// ISteamGameServer::BSecure:仅 eServerModeAuthenticationAndSecure 为真
bool bSecure() const { return mode_ == kModeAuthenticationAndSecure; }
// ISteamGameServer::GetSteamID
uint64_t getSteamID() const { return connected_ ? kGameServerSteamId : 0; }
// ISteamGameServer::SetProduct / SetGameDescription:登录前可改,登录后锁定
bool setProduct(const char* p) {
if (connected_) return false;
product_ = p ? p : "";
return true;
}
bool setGameDescription(const char* d) {
if (connected_) return false;
desc_ = d ? d : "";
return true;
}
const std::string& product() const { return product_; }
const std::string& desc() const { return desc_; }
bool inited() const { return inited_; }
uint16_t queryPortShared() const { return kQueryPortShared; }
private:
static constexpr const char* kValidToken = "gs-persist-token";
static constexpr uint64_t kGameServerSteamId = 90071996842377216ull; // 例:GS steamID 空间
int mode_ = kModeInvalid;
bool inited_ = false;
bool connected_ = false;
bool pendingLogin_ = false;
bool pendingFailure_ = false;
std::string product_;
std::string desc_;
};
} // namespace steam_repro
int main() {
using namespace steam_repro;
MockSteamGameServer srv;
// 1. 未初始化前:未登录、不 secure
CHECK(!srv.inited());
CHECK(!srv.bLoggedOn());
CHECK(!srv.bSecure());
// 2. 非法模式初始化失败
std::string err;
CHECK(srv.initEx(0, 27015, 27016, kModeInvalid, "1.0.0.1", &err) != 0);
CHECK(!err.empty());
// 3. 无版本串初始化失败
CHECK(srv.init(0, 27015, 27016, kModeAuthentication, nullptr) == false);
// 4. NoAuthentication 模式不开启 VAC/secure
MockSteamGameServer plain;
CHECK(plain.init(0, 27015, 27016, kModeNoAuthentication, "1.0.0.1"));
CHECK(!plain.bSecure());
// 5. AuthenticationAndSecure 模式开启 secure
CHECK(srv.init(0, 27015, 27016, kModeAuthenticationAndSecure, "1.0.0.1"));
CHECK(srv.inited());
CHECK(srv.bSecure());
CHECK(srv.queryPortShared() == 0xffff);
// 6. 登录前属性可设
CHECK(srv.setProduct("mygame"));
CHECK(srv.setGameDescription("Dedicated server for MyGame"));
CHECK(srv.product() == "mygame");
// 7. LogOnAnonymous 后一帧连接
srv.logOnAnonymous();
CHECK(srv.pump() == MockServersConnected::kCallback);
CHECK(srv.bLoggedOn());
CHECK(srv.getSteamID() != 0);
// 8. 登录后属性被锁定
CHECK(!srv.setProduct("other"));
// 9. 无效 token → 失败回调,未登录
srv.logOff();
CHECK(!srv.bLoggedOn());
srv.logOn("bad-token");
CHECK(srv.pump() == MockServerConnectFailure::kCallback);
CHECK(!srv.bLoggedOn());
// 10. 有效 token → 连接成功
srv.logOn("gs-persist-token");
CHECK(srv.pump() == MockServersConnected::kCallback);
CHECK(srv.bLoggedOn());
// 11. LogOff 后断开
srv.logOff();
CHECK(!srv.bLoggedOn());
CHECK(srv.getSteamID() == 0);
return lab::report("09-1 游戏服务器机制");
}
本机实测(Apple clang 16,clang++ -std=c++20 -Wall):编译通过(零警告),断言 26/26 通过。
小结
- 专用服务器用
SteamGameServer_InitEx初始化,EServerMode把认证/列表/VAC 三件事耦合成一个安全档位。 - 登录有两种:
LogOn(pszToken)持久账号、LogOnAnonymous()匿名;结果靠回调异步到达,BLoggedOn()只反映已连接状态。 - 属性(Product/GameDescription/ModDir)必须在登录前设好,登录后锁定。
BSecure()是运行态 secure 标记,决定玩家侧看到的服务器是否受 VAC 保护。
阅读导航:上一节:8.3 网络可靠性工程 · 下一节:9.2 VAC 与封禁机制 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。