Skip to content
UntilSoftwareDevsPublic
forked from TLeonardUK/ds3os

About

Dark Souls - Open Server

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Dark Souls III Open Server — 离线认证 Fork

这是 TLeonardUK/ds3os 的派生项目,专注 Dark Souls III 独立服务端。新增显式的离线认证模式:玩家首次连接时,服务器也不需要连接 Steam 验证服务或保存以前的验证记录。

“离线认证”只表示服务器不进行 Steam 票据验证,不能证明玩家拥有正版,也不等于游戏客户端、Steam 登录或玩家间 P2P 联机可以完全离线。本项目不修改游戏 DRM 或实现 Steam 模拟器。

默认构建不编译二代服务端,运行时拒绝 GameType=DarkSouls2。为保留 Fork 历史和上游来源,仓库仍留有二代及启动器源码。原 README 位于 docs/README.upstream.md。

离线模式的行为

  • EnableSteamAuthentication 默认是 true;显式设为 false 才启用离线模式,Steam 初始化或认证失败不会自动降级。
  • 离线模式跳过服务端 Steam GameServer 初始化、票据验证及相应清理;程序仍使用随包的 Steam API 运行库,但不要求启动 Steam 桌面客户端来初始化服务器。
  • 保留 Login → Auth → Game 的 RSA/CWC、密钥交换、临时 token 和可靠 UDP 协议。空票据可用,但仍需要正确的 16 字节会话密钥封套。
  • Auth 阶段声明的 SteamID 必须与游戏登录一致;登录前玩家操作、重复登录、错误密钥和短票据会被拒绝。离线 SteamID 仍是客户端自报身份,持久玩家档案和封禁不能据此获得可信账号保障。
  • 离线模式要求 Advertise=false、SupportSharding=false,不恢复已有子服务器,并导出 Saved/default/server.ds3osconfig 供启动器手工导入。原子服务器资料保留。

仅向可信玩家开放离线服务。原有 Password 是服务器列表获取连接信息的密码,不是游戏连接的可靠访问控制;使用私有网络或云防火墙限制可连接的玩家。无需在公开仓库保存运行配置、私钥、玩家数据库或管理密码。

构建

需要 C++17 编译器和 CMake。默认只构建服务端;Loader/Injector 是保留的上游客户端工具,默认关闭。已有构建环境即可使用,不需要启用 GitHub Actions。

Linux amd64/x86_64(GCC、CMake、Make 或 Ninja、uuid-dev、binutils;仓内 Steam 动态库不支持 ARM64):

BUILD_JOBS=2 bash Tools/build_linux.sh
bash Tools/generate_package_linux.sh

第一步仅编译三代 Server;第二步将已有产物整理到新的 intermediate/linux-stage/,包含 Server、libsteam_api.so、WebUI、示例配置及许可声明,不包含运行数据。将该目录整体放到目标 Linux 主机,再按下文配置运行。程序使用 $ORIGIN 查找同目录 Steam 库;其他系统运行库记录在 runtime-dependencies.txt。Linux 构建不要求 SteamCMD 或 Steam 桌面客户端。

BUILD_DIR、BUILD_JOBS、BUILD_GENERATOR、CMAKE_BIN 可覆盖构建位置、并发、生成器和 CMake 路径。脚本不会安装依赖或覆盖已有打包目录;测试与实际运行证据见 验证记录。

Windows(已安装 Visual Studio 2022 C++ 工具):

cmake -S . -B intermediate/vs -G "Visual Studio 17 2022" -A x64 -DBUILD_TESTING=ON
cmake --build intermediate/vs --config Release --target Server AuthPolicyTests OfflineProtocolClient --parallel 4
ctest --test-dir intermediate/vs -C Release --output-on-failure

Windows 也可使用已有 MSYS2 MinGW64 工具链。请从 ASCII 路径构建和运行(例如 C:\ds3os;此 MinGW 版本在中文路径下可能启动失败):

$env:PATH = "C:\msys64\mingw64\bin;" + $env:PATH
cmake -S . -B intermediate/mingw -G Ninja -DCMAKE_BUILD_TYPE=Release '-DCMAKE_POLICY_VERSION_MINIMUM=3.5' -DBUILD_TESTING=ON
cmake --build intermediate/mingw --target Server AuthPolicyTests OfflineProtocolClient --parallel 4
ctest --test-dir intermediate/mingw --output-on-failure

CMake 4 对仓库内旧版第三方构建文件需要 -DCMAKE_POLICY_VERSION_MINIMUM=3.5;CMake 3.22 可直接使用。输出位于 bin/x64_release/。运行时保留其中的 Steam API 库和 WebUI/;MinGW 编译版本还需要对应的 GCC、C++ 和线程运行库。

Docker 与 Kubernetes

DarkSouls3.Dockerfile 提供 Linux amd64 多阶段构建配方,Compose 示例 和 Kubernetes 模板 使用同一运行契约:非 root 用户、只读根文件系统、Saved 持久化、首次初始化配置不覆盖既有存档。Kubernetes 使用单副本 StatefulSet,并提供仅游戏端口的 LoadBalancer overlay;SQLite 和内存会话不支持直接扩容为多副本。

本轮只发布源码与构建、部署配置,不发布 Linux 二进制或容器镜像,不配置自动镜像构建。镜像构建及注册表、存储、负载均衡参数由后续使用者按自己的环境处理。完整说明及未来手动命令见 Linux 容器与 Kubernetes 运行契约。

配置并连接

  1. 在服务器程序旁创建 Saved/default/。首次启动前,将 configs/offline.example.json 复制为该目录的 config.json。已有配置应编辑合并,保留原私钥和数据库。
  2. 修改 ServerHostname 和 ServerPrivateHostname 为玩家可达的 IPv4 地址或解析到 IPv4 的主机名。示例的 127.0.0.1 仅用于同机测试;云端访问不能保留该地址。显式填写地址还能避免上游的公网 IP 自动查询。
  3. 启动 Server.exe(Windows)或 ./Server(Linux)。配置和数据以可执行文件所在目录为基准。
  4. 将生成的 Saved/default/server.ds3osconfig 交给玩家,在 上游 DS3OS Loader 的三代页面手动导入,选定正版游戏目录后启动。只分享导入文件,不分享 private.key、数据库或管理配置。
用途 默认端口 开放范围
Login TCP 50050 可信玩家
Auth TCP 50000 可信玩家
Game 协议/匹配 UDP 50010 可信玩家
WebUI TCP 50005 仅管理网络;离线连接不需要对玩家开放

服务默认监听所有网卡;配置中的 127.0.0.1 只控制返回给客户端的地址,不限制监听范围。请通过防火墙或私有网络把上述端口限制在对应的开放范围。

示例配置把管理用户名/密码留空,不能登录管理接口。需要管理功能时在本机配置文件设置独立凭据,并限制管理端口访问。以上端口不代表游戏自身 Steam P2P 的全部联网需求。保留 DS3OS 独立存档,不把私服存档复制回官方联机存档。

验证与边界

单元测试检查模式选择、SteamID 格式、密钥/票据边界和登录状态规则;合成协议客户端使用真实套接字连接本地真实 Server 进程,验证离线登录和拒绝路径:

python Tests/run_offline_integration.py --help

确切构建命令、集成测试结果和未验证范围见 docs/VALIDATION.md。本仓库的协议测试不替代实际游戏、双玩家召唤/入侵、长时间稳定性或 Linux 云主机验收。继承的在线模式保留上游同步 BeginAuthSession 行为,不宣称已完成严格的异步所有权验证。

协议地图 说明消息族、传输与已知占位实现;上游与许可 记录 Fork 基线。源码保留 Tim Leonard 的 MIT 许可和各第三方原许可。新 Fork 的 GitHub Actions 保持关闭,本次未修改 .github/workflows/,也未部署任何云服务器。

About

Dark Souls - Open Server

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages