《Steam 游戏平台:开发与商业化》9.1 游戏服务器机制

游戏服务器接入的入口是 SteamGameServer_InitEx 与 EServerMode 安全模式,登录走 ISteamGameServer::LogOn/LogOnAnonymous,BLoggedOn/BSecure 是运行态门控。本节讲专用服务器登录生命周期与属性可变性边界,lab 用 C++ mock 服务器初始化状态机与连接/失败回调。

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;
}

工程语义有三个要点:

  1. usQueryPort 决定服务器浏览器通信方式。传 STEAMGAMESERVER_QUERY_PORT_SHARED(0xffff)时进入共享 socket 模式,游戏负责用 HandleIncomingPacket/GetNextOutgoingPacket 在自有的 UDP socket 上收发查询包,免去多开一个端口。
  2. pchVersionString 是主服务器判断版本的方式。头文件注释明确版本串形如 x.x.x.x,只有最新版本的服务器才会被列出——这比客户端侧的接口版本校验更粗粒度,服务器工程应在版本串里带上可识别的构建号。
  3. 初始化与属性设置的顺序是硬约束。注释反复强调: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
};

工程语义:

  1. NoAuthentication 只适合纯离线/私服:不认证、不列列表,VAC 也不跑。
  2. Authentication 与 AuthenticationAndSecure 的区别就是 VAC:认证和列表行为一致,后者额外对连接玩家跑 VAC。对买断制多人游戏,「不启用 VAC」意味着把反作弊决定权让给了自己的封禁体系——下一节详讲。
  3. 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;

工程语义:

  1. LogOn(pszToken) 是持久账号登录:需要向 Steamworks 申请专用服务器登录 token,登录结果靠回调(SteamServersConnected_t / SteamServerConnectFailure_t)异步到达。适合需要稳定 SteamID 的长驻服务器。
  2. LogOnAnonymous() 是匿名登录:不给 token 也能登录并上列表,但 SteamID 是匿名的、不可复用。对一次性开服的社区服务器足够。
  3. 登录是异步状态机:调用 LogOn 之后 BLoggedOn() 不会立刻变 true——工程上应把「已发出登录请求 / 已连接 / 已断开」三个状态分开,靠回调推进,而不是轮询。
  4. LogOff() 与断开:主动下线调用 LogOff;连接丢失会收到 SteamServersDisconnected_t。单线程服务器不手动释放线程内存,SteamGameServer_RunCallbacks() 会代劳。

接口签名对照

头文件条目语义
steam_gameserver.hEServerMode服务器安全模式(认证/列表/VAC 三档耦合)
steam_gameserver.hSteamGameServer_InitEx服务器初始化入口,返回 ESteamAPIInitResult
steam_gameserver.hSteamGameServer_InitInitEx==OK 的布尔包装
steam_gameserver.hSTEAMGAMESERVER_QUERY_PORT_SHARED共享 socket 查询端口标记
isteamgameserver.hISteamGameServer::LogOn(pszToken)持久账号登录
isteamgameserver.hISteamGameServer::LogOnAnonymous()匿名登录
isteamgameserver.hISteamGameServer::LogOff()主动下线
isteamgameserver.hISteamGameServer::BLoggedOn()/BSecure()运行态登录与 secure 门控

数据口径与来源

  • EServerMode 各值语义、SteamGameServer_InitEx 签名、查询端口常量:SDK v1.65 public/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 与封禁机制 。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图