SLConsole

SLConsole 是面向 SCP: Secret Laboratory 服务器管理员的 Android 原生管理 + 监控客户端:直连游戏服务器上的 SLDataAPI 插件,无需任何中间平台,凭据只保存在本机。

功能

• 概览监控:在线状态、玩家数、回合阶段与时长、核弹倒计时、阵营分布、延迟 —— 按配置间隔轮询
• 玩家管理:实时列表与搜索,踢出 / 封禁 / 禁言 / 私信 / 换角色 / 施加效果 / 传送
• 控制台:WebUI 风格终端(命令回显历史、输出实时追加)
• 地图:回合种子本地重建布局(.NET System.Random 逐位移植,与 Web 端 mapgen 同源),双指缩放 / 拖动 / 双击复位,标签防重叠,玩家实时定位,灯光 / 门 / 电梯控制
• 动态:WebSocket 实时事件流(玩家进出 / 死亡、回合开始结束、电梯门使用)
• 语音监听:直连语音转发端口,48kHz float32 实时收听,说话人列表与频道标识
• 封禁管理:封禁列表、离线封禁(steam / ip)、解封
• 服务器日志:文件列表、尾部读取(100–2000 行、关键字过滤、自动刷新)
• 控制审计:操作审计记录查看
• 插件管理:EXILED / LabAPI 插件列表、暂存启停、应用暂存、重载
• 文件管理:FileRoot 目录浏览、文本文件查看 / 编辑 / 保存、受保护文件标识。服务器打开 2.6.1 的 file_chunks 内测后,较大的文件会分段读写
• 举报管理:待处理举报列表与处理
• 多服务器:添加任意数量的服务器,一键切换;凭据经 AndroidKeyStore AES-256-GCM 加密存储

架构

SLConsole (Android, Kotlin + Jetpack Compose)
  │  HTTP   https://host:8081/...          Bearer <VerifyToken>   监控轮询（明文回退 http）
  │  HTTP   POST /control/*                Bearer <API Key>       控制操作
  │  WS     wss://host:8081/control        Bearer <API Key>       控制调用 + 实时事件（明文回退 ws）
  │  WS     wss://host:<voice_port>/ws     Bearer <API Key>       语音流（明文回退 ws，同一张证书）
  ▼
SLDataAPI 2.6.0 及以上。TLS 需要 SLDataAPI 2.6.1 Mores。2.6.1 是预发布，里面的内测功能默认关闭，不打开时和 2.6.0 一样。

• 数据面与控制面为两套独立凭据(与 Web 端 upstream.js 注入规则一致);
• 服务器 control_transport: ws 时,控制调用经 WS call{reqId, path, body} 信封发送,同一连接可订阅实时事件(25s 心跳、断线自动重连);
• 地图布局完全由回合种子在本地确定性重建,不请求房间数据。

构建

要求:Android Studio(含 JBR / JDK 17)+ Android SDK 36。

./gradlew assembleDebug
# 产物:app/build/outputs/apk/debug/app-debug.apk

• 最低支持 Android 8.0(API 26);
• settings.gradle.kts 默认优先使用阿里云 Maven 镜像(国内网络环境),海外可自行调整顺序;
• 命令行构建需 JAVA_HOME 指向完整 JDK(PATH 上只有 JRE 时 Gradle 会报 "No Java compiler found")。

服务器端前置条件

1. 游戏服务器安装 SLDataAPI（2.6.0 或更新版本的功能仍可用；TLS 需要 SLDataAPI 2.6.1 Mores）。verify_token 为强口令（弱口令会触发 fail-closed 503）。2.6.1 预发布的适配插件动作和大文件分块默认关闭，需要时再在测试服打开；
2. control_enabled: true，按需选择 control_transport: http | ws（与 app 内设置一致）。tls_mode 为 off | optional | required，默认 optional；
3. 通过服务器控制台创建 API Key：sldataapi apikey create <id> <duty|admin>。Key 的角色在创建时就定了，事后改 apikey.config 里的角色不会生效，还会导致认证失败；要 admin 权限就新建一把 admin Key 并在 app 里换上。按需在 apikey.config 的 endpoints_override 中放开 plugins / files 等端点；
4. 启用语音需 voice_enabled: true，并确认语音端口可被手机直连（不走网页反向代理）。语音端口用同一张证书；
5. 防火墙放行 8081（及语音端口）。证书指纹用 sldataapi cert show 查看，或看启动时的 TLS: … SHA-256 横幅。更换证书用 sldataapi cert regen（只影响新连接）。

安全说明

• 凭据经 AndroidKeyStore AES-256-GCM 加密后存储，密钥不可导出，卸载即失效；
• 插件支持 TLS 时，连接使用 HTTPS/WSS，并固定该服务器自签证书的 SHA-256 指纹。第一次连接会请你对照服务器控制台（sldataapi cert show 或启动横幅）再信任。需要带 TLS 的 SLDataAPI。旧插件或 tls_mode: off 会退回明文，界面一直显示「此连接不加密」；一旦加密成功过，就不会再自动改回明文。
• 检查更新仍然用系统信任访问 GitHub，不受这台服务器的证书固定影响。
• 封禁、引爆核弹、重启回合等破坏性操作均有二次确认。

数据与隐私

• 服务器数据：服务器地址、凭据、监控数据和控制命令只在这台手机和你自己的服务器之间传输，不经过作者或其他第三方的服务器。
• 匿名使用统计：应用集成了 Microsoft Clarity，用来了解哪些界面不好用。默认开启，可以在新手引导里选「不开启」，或者以后在「设置 → 隐私」里关闭。如果在走到使用统计那一步之前跳过引导，这项会保持关闭。没开启时 Clarity 不会初始化，关闭后立即停止。开启后，Clarity 仍可能收到设备型号、系统版本、IP 地址和点击坐标；服务器地址、密钥、输入框、控制台内容和玩家信息会尽量遮住，但不是每一项都保证被遮住。统计数据发送给 Microsoft，按 Microsoft Clarity 的条款处理。
• 检查更新：启动时（最多每 6 小时一次，可在设置里关闭）和手动点「立即检查」时，应用会请求 GitHub API（api.github.com）读取最新发布信息。这个请求不带服务器信息或个人数据，GitHub 能看到的只有普通网络请求都会带的 IP 地址等信息。
• 除上面两项之外，应用不向任何地方上传数据。

特别鸣谢

感谢由 FXDYJ 开发的地图绘制JS,源自 SCPSLMaps

许可与版权

Copyright (C) 2026 DNT_OF

SLConsole 是自由软件。你可以依据自由软件基金会发布的 GNU 通用公共许可证第 3 版，或者（由你选择）任何更新的版本，重新分发和修改它（SPDX：GPL-3.0-or-later）。完整条款见 LICENSE。本程序按“原样”提供，不附带任何担保。

再分发或修改时需要注意：

• 分发修改版（包括只分发编译好的 APK）时，必须以 GPLv3 公开对应的完整源代码，接收者同样享有 GPLv3 的全部权利；
• 必须保留源文件开头的版权声明和 SPDX 许可标识，以及本 README、NOTICE 里的版权信息；
• 修改版需要显著注明你做了修改以及修改日期（GPLv3 第 5 条）。

官方版本使用作者自己的签名证书。别人自行编译或修改的版本签名不同，应用会在启动时和「关于」页提示「非官方版本」。请只从 Releases 下载官方版本。

官方签名证书指纹

官方 APK 的签名证书 SHA-256 指纹是：

3D:20:0A:A5:36:9B:75:A0:73:56:A1:85:8C:07:C9:D8:D5:05:56:25:4A:5D:F0:7A:3E:C9:C8:E0:AA:A7:50:36

核对方法：

• 在应用里打开「关于」，点版本旁边的徽标（或「非官方版本」标签），会列出当前安装包的证书指纹和上面的官方指纹；
• 或者在电脑上运行 apksigner verify --print-certs SLConsole-vX.Y.Z.apk，看 certificate SHA-256 digest 是否为 3d200aa5369b75a07356a1858c07c9d8d50556254a5df07a3ec9c8e0aaa75036。

指纹不一致的安装包不是官方版本。

名称与图标

GPL 授权的是代码的版权，不包括以下标识：「SLConsole」这个名称、作者名「DNT_OF」、应用图标，以及「关于」页的「正版授权」徽标（「使用 DNT_OF 系列程序 · 官方签名」）。依据 GPLv3 第 7 条 (e) 款，本项目不授予这些名称和标识在商标法上的使用权。

修改版（包括只改了签名、重新打包的版本）必须遵守：

• 不得自称官方版本，也不得暗示得到了作者认可；
• 不得显示「正版授权」徽标，不得使用「SLConsole」名称和应用图标，请换成自己的名称和图标；
• 不得为了让徽标出现而改动或绕过签名校验，例如把官方证书指纹写死成当前签名。

按要求保留版权声明和作者署名不受这条限制。

附加许可（链接例外）

作为唯一的版权人，DNT_OF 依据 GPLv3 第 7 条给出一项附加许可：允许把 SLConsole 与 Microsoft Clarity SDK、Google Play Install Referrer 库及它们不属于 GPL 的传递依赖组合在一起分发，这些组件本身不需要按 GPL 提供源代码；SLConsole 自己的完整源代码仍须按 GPLv3 提供。条款全文见 LICENSE-EXCEPTION.md。

源文件头里的 SPDX 标识仍写 GPL-3.0-or-later，因为 SPDX 许可列表里没有这条自定义例外的标识；这项附加许可适用于本仓库里 DNT_OF 撰写的全部文件。

第三方组件

依赖库及其许可见 THIRD_PARTY_NOTICES.md。

液态玻璃绘制使用 Backdrop 1.0.6（Kyant，Apache-2.0）。界面里的 Lora、Poppins 字体以 SIL Open Font License 1.1 提供，许可全文在 app/src/main/assets/licenses/。

License (English)

Copyright (C) 2026 DNT_OF

SLConsole is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version (GPL-3.0-or-later). See LICENSE. It comes with ABSOLUTELY NO WARRANTY.

• If you distribute a modified version, including APK-only releases, you must make the complete corresponding source code available under GPLv3.

• Keep the copyright notices and SPDX headers in the source files, as well as the notices in this README and in NOTICE, and mark your changes (GPLv3 section 5).

• Official builds are signed with the author's certificate. Builds signed with any other key are flagged by the app as unofficial (「非官方版本」). The official signing certificate SHA-256 fingerprint is 3D:20:0A:A5:36:9B:75:A0:73:56:A1:85:8C:07:C9:D8:D5:05:56:25:4A:5D:F0:7A:3E:C9:C8:E0:AA:A7:50:36. Check it in the app (About → tap the badge) or with apksigner verify --print-certs.

• Names, icon and badge: the GPL does not grant any rights to the name "SLConsole", the author name "DNT_OF", the app icon or the 「正版授权」 (genuine) badge shown on the About page. Under GPLv3 section 7(e), trademark rights to them are not granted. Modified versions, including re-signed or repackaged builds, must not claim to be official or endorsed, must not display the 「正版授权」 badge, and must not use the SLConsole name or icon; they must not alter or bypass the signature check to make the badge appear.

• Additional permission (linking exception): as the sole copyright holder, DNT_OF grants an additional permission under GPLv3 section 7 to combine and convey SLConsole with the Microsoft Clarity SDK, the Google Play Install Referrer library and their transitive non-GPL dependencies, without those components having to be provided in source form. See LICENSE-EXCEPTION.md. The SPDX headers stay GPL-3.0-or-later because the SPDX list has no identifier for this custom exception; the permission applies to all files in this repository written by DNT_OF.

• Data and privacy: server data goes only between the phone and your own server. Microsoft Clarity anonymous usage analytics is on by default and can be turned off in onboarding or in Settings → Privacy. Skipping onboarding before the analytics step leaves it off. When it is on, Clarity can still receive device model, OS version, IP address and tap coordinates; sensitive fields are masked where the app can, but not every value is guaranteed to be hidden. The update check contacts the GitHub API with normal system TLS. Nothing else is uploaded. Game-server traffic uses HTTPS/WSS with a pinned self-signed certificate when SLDataAPI supports TLS, and falls back to plaintext only for plugins that do not speak TLS.

Third-party licenses are listed in THIRD_PARTY_NOTICES.md.