From b743de6747e0c74fcd4a489eaa59103febaa5f13 Mon Sep 17 00:00:00 2001 From: yuanyuanxiang <962914132@qq.com> Date: Sat, 14 Nov 2026 11:43:30 +0100 Subject: [PATCH] Feat(client): add TLS transport to the macOS client macOS shares the Linux transport: TlsChannel.h now dispatches __APPLE__ to the OpenSSL implementation, so handshake, pinned trust anchor, reload and removal all come from client/TlsChannelLinux.cpp. Only the platform glue is new: ConfigDir() follows initConfigPaths (HOME, then getpwuid(), then /tmp; no XDG) so the anchor sits next to config.conf, and ExeDir() uses _NSGetExecutablePath. First connect stays plaintext. The operator turns TLS on from the online list: COMMAND_TLS_ENABLE carries the anchor PEM, COMMAND_TLS_DISABLE removes it. macos/main.mm saves the anchor, calls TlsReload() and only reconnects when the transport actually changed, so re-saving the same anchor does not drop a live session. RES_TLS is filled from TlsEnabled() and refreshed on every reconnect; fillLoginInfo clears szReserved first now, because AddReserved appends and it runs twice on a group change. CMake builds arm64 only (deployment target 11.0) and links Homebrew openssl@3 statically when libcrypto.a is present, so the binary carries no Homebrew path dependency. Not built or run on a Mac yet: the Apple branch was syntax-checked under WSL and the login refresh probe-tested; macos/README.txt has the build and verify steps. Co-Authored-By: deepseek-flash --- client/IOCPClient.cpp | 4 +- client/IOCPClient.h | 4 +- client/TlsChannel.h | 23 ++++-- client/TlsChannelLinux.cpp | 52 ++++++++++-- common/logger.h | 7 +- docs/TransportTLS_Design.md | 30 +++++-- docs/WebSocket_Transport_Design.md | 4 +- macos/CMakeLists.txt | 53 +++++++++++- macos/README.txt | 28 ++++++- macos/build.sh | 7 +- macos/main.mm | 122 +++++++++++++++++++++++++++- server/2015Remote/2015RemoteDlg.cpp | 2 +- 12 files changed, 298 insertions(+), 38 deletions(-) diff --git a/client/IOCPClient.cpp b/client/IOCPClient.cpp index 2dac214..7ed5fae 100644 --- a/client/IOCPClient.cpp +++ b/client/IOCPClient.cpp @@ -733,7 +733,7 @@ BOOL IOCPClient::ConnectServer(const char* szServerIP, unsigned short uPort) return FALSE; } m_useWs = true; - // 注意:这里不能读 m_useTls——无 TLS 的平台上(macOS/Android)它不存在; + // 注意:这里不能读 m_useTls——它只在定义了 YAMA_TLS_CHANNEL 的平台上存在; // 本连接实际走的形态由 wsDegraded 区分:WSS 有锚走 TLS,没锚则明文回退。 Mprintf("[WS] WebSocket 已就绪: %s:%d%s%s\n", wsHost.c_str(), (int)port, WS_UPGRADE_PATH, wsDegraded ? " (明文,等待信任锚)" @@ -956,7 +956,7 @@ VOID IOCPClient::OnServerReceiving(CBuffer* m_CompressedBuffer, char* szBuffer, Mprintf("[ERROR] Unknown header! this=%p bufLen=%lu, first 16 bytes: %s (useTls=%d tlsReady=%d)\n", this, bufLen, buf.c_str(), (int)m_useTls, (int)m_tls.IsReady()); #else - // macOS 没有 TlsChannel(TLS 已在 Windows/Linux/Android 客户端实现) + // 该平台没有 TlsChannel(YAMA_TLS_CHANNEL 未定义):没有传输层状态可打 Mprintf("[ERROR] Unknown header! this=%p bufLen=%lu, first 16 bytes: %s\n", this, bufLen, buf.c_str()); #endif diff --git a/client/IOCPClient.h b/client/IOCPClient.h index 284bfbb..0c130b8 100644 --- a/client/IOCPClient.h +++ b/client/IOCPClient.h @@ -11,8 +11,8 @@ #pragma comment(lib,"ws2_32.lib") #endif -// TLS 通道:Windows 走 Schannel,Linux 走 OpenSSL;macOS/Android 下该头为空, -// 且不定义 YAMA_TLS_CHANNEL,下方代码自动退回明文。 +// TLS 通道:Windows 走 Schannel,Linux / Android / macOS 走 OpenSSL(TlsChannelLinux.cpp)。 +// 其它平台该头为空,且不定义 YAMA_TLS_CHANNEL,下方代码自动退回明文。 #include "TlsChannel.h" // WebSocket 传输(经反代 443 等受限端口接入)。头文件实现,各平台编译目标无需改动。 diff --git a/client/TlsChannel.h b/client/TlsChannel.h index b1d5a8e..7b20b17 100644 --- a/client/TlsChannel.h +++ b/client/TlsChannel.h @@ -6,7 +6,8 @@ // // 选型: // - Windows:Schannel(原生 SSPI),零第三方依赖;secur32.lib / crypt32.lib 为系统库。 -// - Linux:OpenSSL(构建链已因 libsign 链接 libcrypto,另加 libssl 即可)。 +// - Linux / macOS:OpenSSL(Linux 构建链已因 libsign 链接 libcrypto,另加 libssl 即可; +// macOS 需 Homebrew openssl@3,见 macos/CMakeLists.txt)。 // 两者都是单向 TLS:客户端只校验服务端证书链到固定的信任锚,不提供客户端证书, // 客户端身份仍由隧道内登录(V1 PwdHmac / V2 ECDSA)承担;均不校主机名(客户端按 IP // 连接),不做吊销检查——与 Windows 版既有语义保持一致。 @@ -16,11 +17,12 @@ // Send/Recv 对上下文的使用由 m_ctxMtx 互斥,避免重连线程释放上下文时与使用线程产生 // use-after-free。本对象作为 IOCPClient 的值成员存在,析构时释放上下文。 // -// 平台范围:_WIN32(Schannel)、Linux 与 Android(OpenSSL)有实现;macOS 不含任何内容, -// 客户端维持明文。这些平台都通过 YAMA_TLS_CHANNEL 宏告知调用方「本平台有 TLS 通道」。 +// 平台范围:_WIN32(Schannel)、Linux / Android / macOS(OpenSSL)有实现。这些平台都通过 +// YAMA_TLS_CHANNEL 宏告知调用方「本平台有 TLS 通道」。 // Android 复用 Linux 的 OpenSSL 实现(TlsChannelLinux.cpp),唯一差异是信任锚目录改为 // App 私有 filesDir(由 TlsSetAnchorDir 注入),语义(单向 TLS1.2 钉扎、fail-closed、 -// 热重载)与 Linux 完全一致。 +// 热重载)与 Linux 完全一致。macOS 同样复用这份 OpenSSL 实现且不改目录规则: +// ~/.config/ghost/yama-ca.pem 与 macOS 客户端现有的 config.conf 目录一致。 #pragma once #if defined(_WIN32) @@ -135,7 +137,7 @@ private: std::vector m_pending; // 已解密、未交付给应用层的明文 }; -#elif defined(__linux__) // 含 Android:__ANDROID__ 同时定义 __linux__ +#elif defined(__linux__) || defined(__APPLE__) // Android 同时定义 __linux__;macOS 走同一份 OpenSSL 实现 #define YAMA_TLS_CHANNEL 1 @@ -152,15 +154,18 @@ bool TlsEnabled(); // (fail-closed),不得静默回退明文。线程安全、幂等。 bool TlsLoadError(); -// Windows 版按目标地址区分「用不用内嵌锚」。Linux / Android 客户端没有内嵌锚概念(生成器 -// 只往 Windows 镜像里写锚块),信任锚一律是配置文件,故这里忽略目标地址,与进程级开关等价。 +// Windows 版按目标地址区分「用不用内嵌锚」。Linux / Android / macOS 客户端没有内嵌锚概念 +// (生成器只往 Windows 镜像里写锚块),信任锚一律是配置文件,故这里忽略目标地址,与进程级 +// 开关等价。 inline bool TlsEnabledFor(const std::string&, const std::string&) { return TlsEnabled(); } inline bool TlsLoadErrorFor(const std::string&, const std::string&) { return TlsLoadError(); } // 服务端下发信任锚(COMMAND_TLS_ENABLE):把 PEM 正文写入信任锚文件,原子替换、权限 0600。 // 写入前先解析验证,不是合法证书就整包拒绝。目录按平台: -// Linux:$XDG_CONFIG_HOME/ghost/yama-ca.pem(默认 ~/.config/ghost/yama-ca.pem,无 HOME -// 时退回程序目录); +// Linux:$XDG_CONFIG_HOME/ghost/yama-ca.pem(默认 ~/.config/ghost/yama-ca.pem); +// macOS:~/.config/ghost/yama-ca.pem(与 macos/main.mm 的 config.conf 同目录,不读 +// XDG_CONFIG_HOME;HOME 兜底也逐字对齐 initConfigPaths:HOME → getpwuid → /tmp); +// Linux 无 HOME 时退回程序目录; // Android:App 私有 filesDir/yama-ca.pem(目录由 TlsSetAnchorDir 注入)。 // 落盘后用 TlsReload() 立即生效(Windows 客户端在 COMMAND_TLS_ENABLE 里调用同一个 // TlsReload(),各平台行为一致)。 diff --git a/client/TlsChannelLinux.cpp b/client/TlsChannelLinux.cpp index a94d670..9110a27 100644 --- a/client/TlsChannelLinux.cpp +++ b/client/TlsChannelLinux.cpp @@ -1,4 +1,4 @@ -// TlsChannelLinux.cpp — 见 TlsChannel.h 头注释。Linux 与 Android 编译(共用 OpenSSL 实现)。 +// TlsChannelLinux.cpp — 见 TlsChannel.h 头注释。Linux / Android / macOS 编译(共用 OpenSSL 实现)。 // // 与 Windows 的 Schannel 实现语义对齐: // - 单向 TLS 1.2(min=max=1.2,与 SP_PROT_TLS1_2_CLIENT 及两套服务端一致); @@ -9,7 +9,7 @@ // 与 Windows 实现的差异:OpenSSL 自己管理 TLS 记录缓冲,不需要 m_raw/m_pending; // 一次性交付不出去的明文留在 SSL 内部,由 SSL_has_pending()/SSL_pending() 暴露给 // 接收线程在 select 前优先消费。 -#if defined(__linux__) // 含 Android:__ANDROID__ 同时定义 __linux__ +#if defined(__linux__) || defined(__APPLE__) // Android 同时定义 __linux__;macOS 走同一份实现 #include "TlsChannel.h" @@ -24,6 +24,7 @@ #include #include +#include #include #include #include @@ -37,6 +38,11 @@ #include #include +#if defined(__APPLE__) +#include // _NSGetExecutablePath +#include // getpwuid:与 macos/main.mm 的 HOME 兜底保持一致 +#endif + namespace { const char* const kAnchorName = "yama-ca.pem"; @@ -55,27 +61,58 @@ std::string g_anchorDir; // 信任锚目录,由 TlsSetAnchorDir // 配置目录: // Linux:与 LinuxConfig 相同规则($XDG_CONFIG_HOME/ghost 或 ~/.config/ghost); +// macOS:固定 ~/.config/ghost(跟随 macos/main.mm 的 config.conf 位置,不吃 XDG_CONFIG_HOME); // Android:App 私有 filesDir(TlsSetAnchorDir 注入),无「程序目录」回退。 std::string ConfigDir() { #ifdef __ANDROID__ return g_anchorDir; +#else + const char* home = getenv("HOME"); +#if defined(__APPLE__) + // macOS 不看 XDG_CONFIG_HOME:macos/main.mm 的 initConfigPaths 把 config.conf 固定 + // 放在 ~/.config/ghost,信任锚必须跟着它走,否则同一台机器会出现两份配置目录。 + // HOME 兜底顺序也与 initConfigPaths 逐字对齐(HOME → getpwuid()->pw_dir → /tmp): + // 手工做成 launchd daemon 时 launchd 不导出 HOME,只查 HOME 会让锚落到「程序目录」, + // 而 config.conf 在 pw_dir 下——升级/重装 app bundle 时锚跟着被删,客户端静默退回明文, + // 而服务端仍以为这台是 TLS。 + if (!home || !home[0]) { + struct passwd* pw = getpwuid(getuid()); + if (pw && pw->pw_dir && pw->pw_dir[0]) + home = pw->pw_dir; + } + if (!home || !home[0]) + home = "/tmp"; + return std::string(home) + "/.config/ghost"; #else const char* xdg = getenv("XDG_CONFIG_HOME"); if (xdg && xdg[0]) return std::string(xdg) + "/ghost"; - const char* home = getenv("HOME"); if (!home || !home[0]) return std::string(); return std::string(home) + "/.config/ghost"; #endif +#endif } -// 可执行文件所在目录(readlink /proc/self/exe,失败返回空)。Android 无此概念,返回空。 +// 可执行文件所在目录(失败返回空)。仅用作「无 HOME」时的回退位置。Android 无此概念。 std::string ExeDir() { -#ifdef __ANDROID__ +#if defined(__ANDROID__) return std::string(); +#elif defined(__APPLE__) + // macOS 没有 /proc/self/exe。_NSGetExecutablePath 返回的路径可能含符号链接/相对成分, + // 这里只取所在目录、不做规范化——用途只是找同目录的 yama-ca.pem,与 Linux 分支一致。 + // 注意 size 是 in/out:缓冲区不足时返回 -1,不能读返回后的内容。 + char buf[4096]; + uint32_t size = sizeof(buf); + if (_NSGetExecutablePath(buf, &size) != 0) + return std::string(); + char* slash = strrchr(buf, '/'); + if (!slash) + return std::string(); + *slash = '\0'; + return std::string(buf); #else char buf[4096]; ssize_t n = readlink("/proc/self/exe", buf, sizeof(buf) - 1); @@ -91,7 +128,8 @@ std::string ExeDir() } // 信任锚候选路径(按优先级),只返回已经存在的那个: -// 1) $XDG_CONFIG_HOME/ghost/yama-ca.pem(默认 ~/.config/ghost/yama-ca.pem) +// 1) ConfigDir()/yama-ca.pem(Linux 默认 ~/.config/ghost,macOS 固定 ~/.config/ghost, +// Android 为 App filesDir) // 2) 可执行文件同目录 yama-ca.pem(兼容手工投递,与 Windows 的 exe 同名文件回退一致) bool FindAnchorPath(std::string& out) { @@ -600,4 +638,4 @@ bool TlsChannel::HasPending() const return SSL_pending(m_ssl) > 0 || SSL_has_pending(m_ssl) == 1; } -#endif // __linux__(含 Android) +#endif // __linux__ / __APPLE__(Linux 含 Android;macOS) diff --git a/common/logger.h b/common/logger.h index ffc2e81..408547f 100644 --- a/common/logger.h +++ b/common/logger.h @@ -17,6 +17,7 @@ #endif #include +#include // fprintf:macOS 非 ObjC 翻译单元的 Mprintf 走 stderr #include #include #include @@ -390,7 +391,11 @@ inline const char* getFileName(const char* path) #ifdef __OBJC__ #define Mprintf(format, ...) NSLog(@"%@", [NSString stringWithFormat:@(format), ##__VA_ARGS__]) #else -#define Mprintf(format, ...) printf(format, ##__VA_ARGS__) +// 非 ObjC 翻译单元(IOCPClient/FileManager/TlsChannel 等)没有 NSLog,只能写流。 +// 必须写 stderr:macos/main.mm 把 stderr 重定向到 /tmp/ghost.log(daemon 与 App bundle +// 两种启动方式都做,App bundle 还设了 CFLOG_FORCE_STDERR 让 NSLog 也落到同一文件); +// stdout 在 App bundle / login item 启动时没人接收,写过去的日志会直接丢掉。 +#define Mprintf(format, ...) fprintf(stderr, format, ##__VA_ARGS__) #endif #elif defined(__ANDROID__) #include diff --git a/docs/TransportTLS_Design.md b/docs/TransportTLS_Design.md index e6bbeed..ae153ca 100644 --- a/docs/TransportTLS_Design.md +++ b/docs/TransportTLS_Design.md @@ -1,6 +1,6 @@ # 传输层单向 TLS 加密设计(按需加密) -> 版本:v0.8 · 状态:**Go 服务端 + Windows/Linux/Android 客户端已实现并验证;Linux/Android 客户端支持下发即时热切换;MFC 主控端见 `TransportTLS_MFCServer_Design.md`;macOS 未接入** · 日期:2026-11-11(Android 客户端接入 + 热切换) +> 版本:v0.9 · 状态:**Go 服务端 + Windows/Linux/Android 客户端已实现并验证;Linux/Android 客户端支持下发即时热切换;macOS 客户端已按同一模式实现(2026-11-14,待 Mac 实机构建验证);MFC 主控端见 `TransportTLS_MFCServer_Design.md`** · 日期:2026-11-14(macOS 客户端接入) > 目标:让 YAMA 设备端口(TCP 6543)在继续兼容老客户端(明文/XOR)的同时,允许新客户端在拿到证书后按需开启**单向 TLS** 加密传输。 > 本期范围:**Go 服务端(`server/go`)+ Windows 客户端 + Linux 客户端 + Android 客户端**。 > @@ -23,8 +23,7 @@ - 不做 **mTLS / 客户端证书**:单向 TLS 不验证客户端证书,客户端身份仍由隧道内的现有登录(`PwdHmac` V1 / `ECDSA` V2)承担。 - 不做传输层 PSK(`YAMA_TRANSPORT_KEY`)方案——本设计改用证书,更贴合「颁发证书」的运维模型。 - 不改应用层协议(flag 帧格式 / XOR / zstd),不做「TLS 内去掉 XOR」的二次精简(后续可选)。 -- Windows 客户端**不做**加密开关的运行时热切换(证书只在进程启动时读取一次,改配置需重启——这正是需求)。Linux / Android 客户端例外:服务端下发 166/167 后立即重载信任锚并重连切换(§6.6 / §6.7),语义差异见该两节。 -- macOS 客户端的 TLS 接入不在本期(Linux / Android 客户端已按同一模式接入,见 §6.6 / §6.7)。 +- Windows 客户端**不做**加密开关的运行时热切换(证书只在进程启动时读取一次,改配置需重启——这正是需求)。Linux / Android / macOS 客户端例外:服务端下发 166/167 后立即重载信任锚并重连切换(§6.6 / §6.7 / §6.8),语义差异见该三节。 - 不做 **MFC 服务端(`server/2015Remote`)的 TLS 接入**——本期只做 Go 服务端(`server/go`),MFC 主控端延后到阶段 3。 ## 2. 现状与复用 @@ -194,6 +193,8 @@ Linux 无注册表,信任锚按:① `$XDG_CONFIG_HOME/ghost/yama-ca.pem`( Android 同样无注册表,信任锚为 App 私有 `context.filesDir/yama-ca.pem`(目录由 `TlsSetAnchorDir()` 在 `nativeInit` 注入,见 §6.7),无程序目录回退;存在即视为已配置、fail-closed。与 Linux 共用 `client/TlsChannelLinux.cpp` 实现。 +macOS 无注册表,信任锚为 `~/.config/ghost/yama-ca.pem`(与 `macos/main.mm` 的 `config.conf` 同目录;**不看 `XDG_CONFIG_HOME`**,保持与 macOS 客户端既有配置路径一致)→ ② 程序目录(`_NSGetExecutablePath`)`yama-ca.pem`。存在即视为已配置、fail-closed。与 Linux/Android 共用 `client/TlsChannelLinux.cpp` 实现(见 §6.8)。 + ### 6.2 TLS 栈选型(已定:Schannel) - **已选 Schannel(Windows 原生 SSPI)**:零第三方依赖/零额外 DLL 部署,`secur32.lib`/`crypt32.lib` 均为系统库(`secur32.lib` 已在 `CFFmpegH264Encoder.cpp:38` 链接)。 @@ -230,7 +231,7 @@ Schannel 流模式(`ISC_REQ_STREAM`)下,`DecryptMessage` 会把输入的 ### 6.6 Linux 客户端实现(OpenSSL,2026-10-28) - **选型**:OpenSSL(`libssl`)。Linux 构建早已因 `libsign.a` 链接 `libcrypto`,只多链一个 `OpenSSL::SSL`,不引入新的运行时依赖包(同一 OpenSSL 3 包提供 `libcrypto.so.3` / `libssl.so.3`)。 -- **代码组织**:`client/TlsChannel.h` 按平台分派(`_WIN32` → Schannel,`__linux__` → OpenSSL,含 Android,见 §6.7),Windows 分支内容不变;实现文件为 `client/TlsChannelLinux.cpp`。`YAMA_TLS_CHANNEL` 宏标注「本平台有 TLS 通道」,`IOCPClient` 用它替代原先的 `#ifdef _WIN32`,因此主连接与子连接共用同一接线点。macOS 不定义该宏,维持明文。 +- **代码组织**:`client/TlsChannel.h` 按平台分派(`_WIN32` → Schannel,`__linux__`(含 Android,见 §6.7)与 `__APPLE__`(macOS,见 §6.8)→ OpenSSL),Windows 分支内容不变;实现文件为 `client/TlsChannelLinux.cpp`。`YAMA_TLS_CHANNEL` 宏标注「本平台有 TLS 通道」,`IOCPClient` 用它替代原先的 `#ifdef _WIN32`,因此主连接与子连接共用同一接线点。 - **语义对齐**:`TLS 1.2` 钉扎(min=max,与 `SP_PROT_TLS1_2_CLIENT` 及两套服务端一致);单向 TLS、不提供客户端证书、不校主机名、不做吊销检查;`SSL_VERIFY_PEER` + 只含信任锚的 `X509_STORE`(不含系统根库,严格钉扎),握手内完成链校验,失败即断开(fail-closed)。 - **缓冲差异**:OpenSSL 自己管理记录缓冲,不需要 Schannel 的 `m_raw`/`m_pending`;一次 `SSL_read` 交付不完的明文留在 `SSL` 内部,接收线程在 `select` 前用 `SSL_pending() || SSL_has_pending()` 优先消费,否则剩余字节会被 2 秒 `select` 超时卡住。 - **下发/撤销**:`COMMAND_TLS_ENABLE`(166) 的 PEM 正文写入 `~/.config/ghost/yama-ca.pem`(目录 0700、文件 0600、临时文件 + rename 原子替换);`COMMAND_TLS_DISABLE`(167) 删除该文件(含程序目录同名回退文件)。写入前先用 OpenSSL 解析一遍,不是合法证书就整包拒绝并保留原状态。 @@ -241,7 +242,7 @@ Schannel 流模式(`ISC_REQ_STREAM`)下,`DecryptMessage` 会把输入的 - 热重载遇到坏锚时**保留原状态**并记日志,不把正在工作的客户端打死(下次启动仍按 fail-closed 语义)。 - 重连由 `DataProcess`(接收线程)只置 `g_needReconnect` 标志,由主心跳线程 `Disconnect()` 后走外层重连循环——避免在接收线程里关 socket 与主线程发送竞争。 - **代价**:此刻若正处于远程桌面/文件传输会话,主连接重建会中断该会话(子连接随之失效)。这是「立即生效」的固有代价。 -- **上报**:登录 `szReserved[19]`(`RES_TLS`)填 `TlsEnabled() ? 1 : 0`,主控端主机信息显示 Y/N。热切换后重连会重新登录,登录前用 `RefreshLoginTls()` 刷新该字段,主控端在线列表的 TLS 列随之翻转。 +- **上报**:登录 `szReserved[19]`(`RES_TLS`)填 `TlsEnabled() ? 1 : 0`,主控端主机信息显示 Y/N。热切换后重连会重新登录,登录前用 `RefreshLoginTls()` 刷新该字段,主控端在线列表的 TLS 列随之翻转。Android 同。 ### 6.7 Android 客户端实现(OpenSSL,2026-11-11) @@ -252,6 +253,22 @@ Schannel 流模式(`ISC_REQ_STREAM`)下,`DecryptMessage` 会把输入的 - **OpenSSL 构建**:Android 的 `libsign.a` 用便携纯 C SHA256、不含 OpenSSL,故需新交叉编译 `libssl.a`/`libcrypto.a`。`android/build_openssl_android.sh`(已并入 `build_android_libs.ps1`,可 `-OpenSslOnly` 单跑)用 NDK clang + MSYS2 perl/make 按 ABI(arm64-v8a / armeabi-v7a / x86 / x86_64,API 21)构建 OpenSSL 3.5.0 静态库(`no-shared no-apps no-legacy` 等裁剪);产物落 `app/src/main/cpp/lib//`,`opensslconf.h` 各架构不同故头文件也按 ABI 存放。CMake 链接 `libssl.a`+`libcrypto.a`,并用 `-Wl,--exclude-libs,ALL` 不让静态库符号泄出 `libyama.so`(与 Java 层 Conscrypt 隔离;JNI 入口来自目标文件,不受影响)。 - **Windows 构建坑(已解决)**:Git for Windows 的精简 perl 缺 Configure 所需模块,且其 bash/env 会抢占 PATH——跨 MSYS 运行时传子进程丢环境变量(Configure 拿不到 `ANDROID_NDK_ROOT`),脚本改用 `#!/bin/bash` 并把 MSYS2 `/usr/bin` 置顶;NDK 自带原生 make 不认 Makefile 里的 `/c/...` 路径,须用 MSYS2 make(`pacman -S make`)。 +### 6.8 macOS 客户端实现(OpenSSL,2026-11-14) + +- **选型 / 代码组织**:复用 Linux/Android 的 OpenSSL 实现。`client/TlsChannel.h` 的平台分支由 `__linux__` 放宽为 `__linux__ || __APPLE__`,`TlsChannelLinux.cpp` 的编译守卫同步放宽(该文件本就是 OpenSSL + POSIX,无 Linux 专有调用);`YAMA_TLS_CHANNEL` 随之在 macOS 生效,主连接/子连接共用与 Linux 相同的接线点(`IOCPClient`)。**服务端零改动**。 +- **平台差异点(都在 `TlsChannelLinux.cpp` 内条件编译)**: + - **配置目录**:`ConfigDir()` 在 Apple 上**不读 `XDG_CONFIG_HOME`**,HOME 兜底顺序与 `macos/main.mm` 的 `initConfigPaths` 逐字对齐(`HOME` → `getpwuid()->pw_dir` → `/tmp`),最终都是 `/.config/ghost`——否则信任锚和 `config.conf` 会落在两个目录(launchd daemon 不导出 `HOME` 时尤其明显:锚落到程序目录,重装 app bundle 时跟着被删,客户端静默退回明文而服务端仍以为它是 TLS)。 + - **程序目录回退**:`ExeDir()` 用 `_NSGetExecutablePath`(``)截取目录;Linux 继续用 `/proc/self/exe`,Android 仍返回空。 + - **`SIGPIPE`**:`macos/main.mm` 启动时已 `signal(SIGPIPE, SIG_IGN)`(WSS 引入时加的),TLS 写入对端已关时不会直接杀掉进程。 +- **热切换接线(`macos/main.mm`)**:与 Linux 同一套语义。`DataProcess` 收到 `COMMAND_TLS_ENABLE`(166) → `TlsTrustAnchorSave()`;`COMMAND_TLS_DISABLE`(167) → `TlsTrustAnchorRemove()`;两者随后都走 `ApplyTlsAnchorChange()`:`TlsReload()` 重建 `SSL_CTX`,只在传输方式真的变化(明文↔TLS)时置 `g_needReconnect`(接收线程只置标志),主心跳循环每秒检查、`Disconnect()` 后由外层重连循环用新传输方式重连。仅换锚不打断现有会话。 +- **上报**:登录 `szReserved[19]`(`RES_TLS`)填 `TlsEnabled() ? 1 : 0`;重连登录前用 `RefreshLoginTls()` 刷新(`logInfo` 启动时填一次、之后复用)。顺带修掉一个既有缺陷:分组变更重发登录时 `fillLoginInfo()` 会被再次调用,而 `AddReserved()` 是追加语义,原先会把整套保留字段再拼一遍,导致服务端按 `LOGIN_RES` 下标读到错位/重复字段——现在 `fillLoginInfo()` 入口先清空 `szReserved`。 +- **构建(`macos/CMakeLists.txt` / `build.sh`)**: + - 源码列表加入 `client/TlsChannelLinux.cpp`;链接 `OpenSSL::SSL`、`OpenSSL::Crypto`。 + - Homebrew 的 `openssl@3` 不在 CMake 默认搜索路径,`CMakeLists.txt` 自动探测 `/opt/homebrew/opt/openssl@3`(及其它常见前缀),找不到直接 `FATAL_ERROR` 并提示 `brew install openssl@3`,也可 `-DOPENSSL_ROOT_DIR=...` 指定。 + - 有静态库(`libssl.a`/`libcrypto.a`)时优先静态链接(`OPENSSL_USE_STATIC_LIBS`),避免发布包还得让目标 Mac 装 Homebrew OpenSSL;只有动态库时给 `WARNING`,需自行把 dylib 放进 `Contents/Frameworks`。 + - 目标为 **arm64 单架构**(Homebrew OpenSSL 只有本机架构,保留 x86_64 slice 会链接失败)、部署目标 macOS 11.0。`build.sh` 通过命令行显式传 `-DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0`——这两个是 CMake **cache 变量**,在已存在的 `build/` 目录里改了 `CMakeLists.txt` 也不会生效,必须命令行覆盖或删目录重建。 +- **注意**:macOS 客户端在线升级仍不支持(服务端 `OnOnlineUpdate` 无 MAC 分支),升级 TLS 相关代码需重新 `macos/build.sh` 并按 `macos/install.sh` 部署(会重置 TCC 授权)。 + ## 7. 兼容矩阵 | 客户端 | 服务端行为 | 结果 | @@ -337,6 +354,7 @@ Android 客户端:信任锚写入 App 私有 `filesDir/yama-ca.pem`(经 166/ - **阶段 2(Windows 客户端)**:证书检测 + TLS 栈 + fail-closed。 - **阶段 2b(Linux 客户端)**:OpenSSL 实现,复用同一接线点与协议语义(2026-10-28 完成)。 - **阶段 2c(Android 客户端)**:复用 Linux OpenSSL 实现,NDK 按 ABI 交叉编译 OpenSSL,热切换(2026-11-11 完成)。 +- **阶段 2d(macOS 客户端)**:复用 Linux OpenSSL 实现(`__APPLE__` 分支 + `_NSGetExecutablePath`),Homebrew OpenSSL 静态链接,热切换(2026-11-14 完成代码,待 Mac 实机验证)。 - **阶段 3(MFC 服务端 `server/2015Remote`,延后)**:与 Go 服务端同款的 TLS 检测 + 解包接入。设计稿见 `docs/TransportTLS_MFCServer_Design.md`。 - **回滚**:服务端清空 `YAMA_TLS_CERT/KEY` 即回到纯明文;客户端删除注册表 `tls_cert` 值(或 `yama-ca.pem` 文件)即回明文。 @@ -345,4 +363,4 @@ Android 客户端:信任锚写入 App 私有 `filesDir/yama-ca.pem`(经 166/ 1. ~~客户端 TLS 栈最终选型~~ → **已定 Schannel**(见 §6.2,2026-10-13 落地)。 2. ~~信任锚文件固定名(`yama-ca.pem`)是否需可配置~~ → **已改为注册表 `tls_cert` 值优先、文件回退**(见 §6.1/§9.3,2026-10-14)。 3. 是否同步把「TLS 内去掉 XOR」列为后续精简项(当前保留 XOR,换取零协议改动)。 -4. ~~Linux / macOS / Android 客户端的 TLS 接入排期~~ → **Linux(2026-10-28)、Android(2026-11-11)已接入**(均 OpenSSL、支持热切换);macOS 待定(需 Security.framework 或自带 OpenSSL)。 +4. ~~Linux / macOS / Android 客户端的 TLS 接入排期~~ → **Linux(2026-10-28)、Android(2026-11-11)、macOS(2026-11-14)已接入**(均 OpenSSL、支持热切换)。 diff --git a/docs/WebSocket_Transport_Design.md b/docs/WebSocket_Transport_Design.md index d331c90..33a2e5f 100644 --- a/docs/WebSocket_Transport_Design.md +++ b/docs/WebSocket_Transport_Design.md @@ -112,7 +112,7 @@ Host 头同理:用**配置里的地址(域名)**,而不是解析后的 I | 有锚但加载失败(损坏/为空) | 拒绝连接(fail-closed)——管理员已「颁发」证书,不能静默回退明文 | | 无锚 + `PROTO_WS` | 明文(本来如此) | | 有锚 + `PROTO_WS` | **仍是明文**(显式选择的形态,见下) | -| 平台无 TLS(macOS 未定义 `YAMA_TLS_CHANNEL`)+ `PROTO_WSS` | 直接断开并打日志:没有热切换路径,回退只会让人误以为在加密 | +| 平台无 TLS(未定义 `YAMA_TLS_CHANNEL`)+ `PROTO_WSS` | 直接断开并打日志:没有热切换路径,回退只会让人误以为在加密 | | WS 握手失败 | 断开,`Mprintf` 里带上服务端返回的状态行 | 回退的判据是「本机**根本没有**信任锚」这一可观测状态,而不是握手中途失败——TLS 握手 @@ -415,7 +415,7 @@ server { 升级线程里才有。若这是硬性合规要求,需单独评估(本特性未改变这一点,只是让它的漏检更 容易发生)。 - 裸 `PROTO_WS` 是明文,只适合内网或回环(nginx 已在同一台机器上终止 TLS 的情形用 WSS 即可)。 -- macOS 客户端没有 TLS 实现,只能选 `PROTO_WS`(明文),走不了 443(Linux / Android 已有 TLS,见 `TransportTLS_Design.md` §6.6 / §6.7)。 +- macOS 客户端自 2026-11-14 起也有 TLS(与 Linux/Android 同一 OpenSSL 实现,见 `TransportTLS_Design.md` §6.8),WSS 与 Linux 行为一致;更早的 macOS 构建仍只能选 `PROTO_WS`(明文),走不了 443。 - 经反代接入时地址只应填**一个域名**(多地址取第一个做 Host/SNI)。 - 不改应用协议、不改 MCP、不改 Web 控制台。 diff --git a/macos/CMakeLists.txt b/macos/CMakeLists.txt index 4e1f141..76c77f1 100644 --- a/macos/CMakeLists.txt +++ b/macos/CMakeLists.txt @@ -4,11 +4,16 @@ project(ghost_macos) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) -# macOS deployment target -set(CMAKE_OSX_DEPLOYMENT_TARGET "10.13" CACHE STRING "Minimum macOS version") +# macOS deployment target。arm64 的底线就是 11.0(Apple Silicon 首发系统), +# 与 Homebrew openssl@3 自身的最低版本一致,避免链接时出现 "built for newer" 告警。 +set(CMAKE_OSX_DEPLOYMENT_TARGET "11.0" CACHE STRING "Minimum macOS version") -# Universal Binary (Intel + Apple Silicon) -set(CMAKE_OSX_ARCHITECTURES "x86_64;arm64" CACHE STRING "Build architectures") +# 只构建 Apple Silicon。仓库里发布过的 macos/ghost 一直是 arm64-only(universal 设置从未 +# 真正落地),且 Homebrew 的 OpenSSL 是单架构——保留 x86_64 slice 会让链接直接失败。 +# 将来真要支持 Intel Mac,应单独用 x86_64 的 OpenSSL 构建一份,而不是把这里改回 universal。 +# 注意 CMAKE_OSX_ARCHITECTURES 是 cache 变量:旧 build 目录里存的值不会因这里改字面量而 +# 更新,build.sh 因此显式传 -DCMAKE_OSX_ARCHITECTURES=arm64。 +set(CMAKE_OSX_ARCHITECTURES "arm64" CACHE STRING "Build architectures (arm64 only)") include_directories(../) include_directories(../client) @@ -19,6 +24,9 @@ set(SOURCES main.mm ../client/Buffer.cpp ../client/IOCPClient.cpp + # TLS 传输(OpenSSL 实现,与 Linux/Android 共用)。文件名叫 Linux 是历史原因, + # 平台守卫为 __linux__ || __APPLE__;macOS 的差异只有 ExeDir() 用 _NSGetExecutablePath。 + ../client/TlsChannelLinux.cpp ../client/sign_shim_unix.cpp ScreenHandler.mm InputHandler.mm @@ -49,6 +57,41 @@ find_library(COREVIDEO_FRAMEWORK CoreVideo REQUIRED) find_library(ACCELERATE_FRAMEWORK Accelerate REQUIRED) find_library(ICONV_LIBRARY iconv REQUIRED) +# ---- OpenSSL(TLS 传输,见 client/TlsChannelLinux.cpp)---- +# macOS 不自带 OpenSSL。优先用 Homebrew 的 openssl@3;也可显式指定 +# cmake .. -DOPENSSL_ROOT_DIR=/path/to/openssl +# Apple Silicon 的 Homebrew 前缀是 /opt/homebrew,Intel 是 /usr/local。 +if(NOT OPENSSL_ROOT_DIR) + foreach(_openssl_candidate + /opt/homebrew/opt/openssl@3 + /usr/local/opt/openssl@3 + /opt/homebrew/opt/openssl + /usr/local/opt/openssl) + if(EXISTS "${_openssl_candidate}/include/openssl/ssl.h") + set(OPENSSL_ROOT_DIR "${_openssl_candidate}") + break() + endif() + endforeach() +endif() +if(NOT OPENSSL_ROOT_DIR) + message(FATAL_ERROR + "找不到 OpenSSL。先执行: brew install openssl@3\n" + "或显式指定: cmake .. -DOPENSSL_ROOT_DIR=/opt/homebrew/opt/openssl@3") +endif() + +# 有静态库就静态链接:产物保持单文件,install.sh 不需要打包 dylib 或修 @rpath。 +# Homebrew 的 openssl@3 同时装 .a 和 .dylib;只有动态库时这里退化为动态链接并告警, +# 那种情况下发布前必须把 libssl/libcrypto dylib 一并放进 .app 的 Contents/Frameworks。 +if(EXISTS "${OPENSSL_ROOT_DIR}/lib/libssl.a" AND EXISTS "${OPENSSL_ROOT_DIR}/lib/libcrypto.a") + set(OPENSSL_USE_STATIC_LIBS TRUE) +else() + message(WARNING + "OpenSSL 静态库不存在(${OPENSSL_ROOT_DIR}/lib/libssl.a),将动态链接;" + "发布前请确认目标 Mac 装有同一份 OpenSSL,或把 dylib 放进 Contents/Frameworks。") +endif() +find_package(OpenSSL REQUIRED) +message(STATUS "OpenSSL: ${OPENSSL_VERSION} (${OPENSSL_INCLUDE_DIR})") + target_link_libraries(ghost PRIVATE ${COCOA_FRAMEWORK} ${COREGRAPHICS_FRAMEWORK} @@ -68,6 +111,8 @@ target_link_libraries(ghost PRIVATE # libsign.a 内部使用 macOS CommonCrypto(HMAC-SHA256),CCHmac 在 libSystem # 中已被 Cocoa/CoreFoundation 等链接自动引入,故此处无需额外 framework "${CMAKE_SOURCE_DIR}/lib/libsign.a" + OpenSSL::SSL + OpenSSL::Crypto ) # Compiler flags diff --git a/macos/README.txt b/macos/README.txt index d71d518..f6e5987 100644 --- a/macos/README.txt +++ b/macos/README.txt @@ -4,6 +4,12 @@ macOS Remote Desktop Client Prerequisites: 1. Xcode Command Line Tools: xcode-select --install 2. CMake: brew install cmake + 3. OpenSSL (TLS transport): brew install openssl@3 + CMake 自动探测 /opt/homebrew/opt/openssl@3,也可用 + cmake .. -DOPENSSL_ROOT_DIR=/path/to/openssl 指定。 + + 构建目标是 Apple Silicon (arm64) 单架构:Homebrew 的 OpenSSL 只有本机架构, + 保留 x86_64 slice 会链接失败。Intel Mac 需另建 x86_64 的 OpenSSL 单独构建。 Build: chmod +x build.sh @@ -11,7 +17,7 @@ Build: Or manually: mkdir build && cd build - cmake .. + cmake .. -DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 make Run: @@ -21,6 +27,26 @@ Configuration: Server address is configured in main.mm (g_SETTINGS variable). Modify before building if needed. +TLS Transport: + Default is plaintext on first connect. The controller's host right-click menu + ("TLS 传输") sends the trust anchor; the client stores it at + ~/.config/ghost/yama-ca.pem, hot-reloads and reconnects over TLS 1.2 + (fail-closed, pinned to that anchor). "取消TLS" deletes the file and + reconnects in plaintext. Existing sessions survive only if the transport does + not change (replacing the certificate keeps TLS). + + Verify after building: + otool -L build/bin/ghost | grep -i ssl # 期望无输出:OpenSSL 已静态链接 + tail -f /tmp/ghost.log + Startup prints one of: + [TLS] transport on first connect: plaintext (no trust anchor) + [TLS] transport on first connect: TLS (trust anchor present) + Clicking "TLS 传输" should log "TLS transport switched to TLS, reconnecting"; + the host's TLS column in the online list then shows Y. "取消TLS" logs + "switched to plaintext" and the column flips back to N. + If the log says "trust anchor exists but failed to load", the client refuses + to connect (fail-closed) until the anchor is fixed or removed. + Permissions Required: 1. Screen Recording - System Settings > Privacy & Security > Screen Recording 2. Accessibility - System Settings > Privacy & Security > Accessibility diff --git a/macos/build.sh b/macos/build.sh index b5d3b94..ca22dc6 100644 --- a/macos/build.sh +++ b/macos/build.sh @@ -27,8 +27,13 @@ mkdir -p build cd build # Configure +# 架构与最低系统版本显式传:两者都是 CMake 的 cache 变量,旧 build 目录里可能还存着 +# universal / 10.13 的旧值,只改 CMakeLists.txt 不会生效(arm64 + Homebrew OpenSSL +# 是单架构组合,留着 x86_64 slice 会链接失败)。 echo "Configuring..." -cmake .. -DCMAKE_BUILD_TYPE=Release +cmake .. -DCMAKE_BUILD_TYPE=Release \ + -DCMAKE_OSX_ARCHITECTURES=arm64 \ + -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0 # Build echo "" diff --git a/macos/main.mm b/macos/main.mm index f8c7cdc..7d52190 100644 --- a/macos/main.mm +++ b/macos/main.mm @@ -15,9 +15,12 @@ #import #import #import +#import +#import // strncpy(RefreshLoginTls 改写 szReserved) #import #import "../client/IOCPClient.h" +#include "../client/TlsChannel.h" // TLS 传输(信任锚保存/热重载),随 IOCPClient 一起定义 YAMA_TLS_CHANNEL #define XXH_INLINE_ALL #include "../common/xxhash.h" #include "../common/rtt_estimator.h" @@ -38,6 +41,10 @@ // Global state static std::atomic g_running(true); static std::atomic g_needResendLogin(false); // 分组变更后需要重发登录信息 +// 传输方式热切换(服务端 COMMAND_TLS_ENABLE/DISABLE 改了信任锚)后需要重建连接。 +// DataProcess 跑在接收线程上,直接关 socket 会和主线程的发送竞争,所以只置标志, +// 由主心跳循环择机 Disconnect 并重连(与 linux/main.cpp 的 g_needReconnect 同语义)。 +static std::atomic g_needReconnect(false); // Client ID (calculated from system info, used by ScreenHandler) uint64_t g_myClientID = 0; @@ -496,6 +503,11 @@ static void fillLoginInfo(LOGIN_INFOR& info) // Token is set in constructor info.bToken = TOKEN_LOGIN; + // 分组变更后会带着同一个 logInfo 再调一次本函数。AddReserved 是「追加」,不清空 + // 就会把整套保留字段再拼一遍,服务端按 LOGIN_RES 下标取值,看到的是重复/错位的 + // 字段。这里先把保留区清空,让本函数可重入。 + info.szReserved[0] = '\0'; + // OS Version std::string osVer = getMacOSVersion(); strncpy(info.OsVerInfoEx, osVer.c_str(), sizeof(info.OsVerInfoEx) - 1); @@ -612,11 +624,13 @@ static void fillLoginInfo(LOGIN_INFOR& info) } info.AddReserved(std::to_string(g_myClientID).c_str()); - // PID / 文件大小 / TLS:macOS 暂不上报,占位保持位置(服务端按 LOGIN_RES 下标取值, + // PID / 文件大小:macOS 暂不上报,占位保持位置(服务端按 LOGIN_RES 下标取值, // 少发一项会让后面所有字段前移)。 info.AddReserved(""); info.AddReserved(""); - info.AddReserved(""); + // [19] RES_TLS:与 Linux 一致,有信任锚即 1。服务端在线列表的 TLS 列取这个值; + // 热切换后重连重发登录,务必用 RefreshLoginTls 刷新成当前状态。 + info.AddReserved(TlsEnabled() ? 1 : 0); // [20] RES_UPTIME:登录时刻的进程已运行秒数,服务端据此算「启动信息」里的时长 info.AddReserved((int)getProcessUptimeSeconds()); @@ -627,6 +641,39 @@ static void fillLoginInfo(LOGIN_INFOR& info) osVer.c_str(), hostname.c_str(), info.dwCPUMHz, pubIP.c_str(), g_myClientID); } +// [[19] RES_TLS] 是「当前」传输状态的快照,服务端在线列表的 TLS 列就取这个值。 +// logInfo 只在启动时填一次、之后每条连接复用,因此热切换后重连时必须刷新它, +// 否则列里会一直显示切换前的状态。szReserved 是按 '|' 位置解析的,这里逐字段 +// 拆开、只改第 [19] 项再拼回去(不能用 AddReserved,它只会往后追加)。 +// 只在主线程调用(与 SendLoginInfo 同一线程),避免和接收线程抢同一个结构体。 +static void RefreshLoginTls(LOGIN_INFOR& info) +{ + std::vector fields; + std::string s(info.szReserved); + size_t pos = 0; + for (;;) { + size_t bar = s.find('|', pos); + if (bar == std::string::npos) { + fields.push_back(s.substr(pos)); + break; + } + fields.push_back(s.substr(pos, bar - pos)); + pos = bar + 1; + } + while (fields.size() <= (size_t)RES_TLS) + fields.push_back(""); + fields[RES_TLS] = TlsEnabled() ? "1" : "0"; + + std::string joined; + for (size_t i = 0; i < fields.size(); ++i) { + if (i) + joined += '|'; + joined += fields[i]; + } + strncpy(info.szReserved, joined.c_str(), sizeof(info.szReserved) - 1); + info.szReserved[sizeof(info.szReserved) - 1] = '\0'; +} + // ============== Signal Handling ============== // 注意:signal handler 内不能调 NSLog/Mprintf(NSLog 走 Foundation 锁, @@ -781,6 +828,28 @@ static void SpawnSubConnWorker(const char* name, void* (*entry)(void*)) } } +// 信任锚已落盘/已删除:热重载 TLS 状态,必要时请求主循环重建连接。 +// 只在传输方式真正变化(明文↔TLS)时重连;仅换证书(仍是 TLS)不打断现有会话, +// 新锚从下一条新连接开始生效。与 linux/main.cpp 的 ApplyTlsAnchorChange 同语义。 +static void ApplyTlsAnchorChange(void* user) +{ + bool before = TlsEnabled(); + std::string err; + if (!TlsReload(err)) { + Mprintf("** [%p] TLS reload failed: %s (keeping current transport) ***\n", user, err.c_str()); + return; + } + bool after = TlsEnabled(); + if (before == after) { + Mprintf("** [%p] TLS trust anchor updated, transport unchanged (%s) ***\n", + user, after ? "TLS" : "plaintext"); + return; + } + g_needReconnect.store(true); + Mprintf("** [%p] TLS transport switched to %s, reconnecting ***\n", + user, after ? "TLS" : "plaintext"); +} + int DataProcess(void* user, PBYTE szBuffer, ULONG ulLength) { if (szBuffer == nullptr || ulLength == 0) @@ -888,6 +957,31 @@ int DataProcess(void* user, PBYTE szBuffer, ULONG ulLength) // 标记需要重发登录信息(让服务端更新分组显示) g_needResendLogin.store(true); Mprintf("** [%p] Group changed to: %s ***\n", user, groupName.c_str()); + } else if (szBuffer[0] == COMMAND_TLS_ENABLE) { + // 服务端下发信任锚证书(载荷与 Windows/Linux 一致:szBuffer+1 起为 PEM 正文)。 + // 落盘到 ~/.config/ghost/yama-ca.pem 后热重载,传输方式真正变化时由主循环重连。 + if (ulLength > 1) { + std::string pem((char*)szBuffer + 1, ulLength - 1); + std::string err; + if (TlsTrustAnchorSave(pem, err)) { + Mprintf("** [%p] TLS trust anchor received and saved ***\n", user); + ApplyTlsAnchorChange(user); + } else { + Mprintf("** [%p] TLS trust anchor save failed: %s ***\n", user, err.c_str()); + } + } else { + // 没有证书正文就等于「启用但没有锚」——不该悄悄忽略,留一行便于排查。 + Mprintf("** [%p] COMMAND_TLS_ENABLE without a certificate payload, ignored\n", user); + } + } else if (szBuffer[0] == COMMAND_TLS_DISABLE) { + // 撤销信任锚:删除配置文件并热重载,当前连接若是 TLS 就重连回明文。 + std::string err; + if (TlsTrustAnchorRemove(err)) { + Mprintf("** [%p] TLS trust anchor removed ***\n", user); + ApplyTlsAnchorChange(user); + } else { + Mprintf("** [%p] TLS trust anchor removal: %s ***\n", user, err.c_str()); + } } else { Mprintf("** [%p] Received unimplemented command: %d ***\n", user, int(szBuffer[0])); } @@ -953,6 +1047,15 @@ int main(int argc, const char* argv[]) loadConfig(); NSLog(@"Config loaded from %s", g_configPath.c_str()); + // 传输方式由信任锚文件决定(服务端右键「TLS 传输」才会写入 ~/.config/ghost/yama-ca.pem)。 + // 启动时打一行,排查「首次连接为什么/为什么不加密」不用去猜。 + if (TlsLoadError()) { + Mprintf("[TLS] trust anchor exists but failed to load; connections will be refused (fail-closed)\n"); + } else { + Mprintf("[TLS] transport on first connect: %s\n", + TlsEnabled() ? "TLS (trust anchor present)" : "plaintext (no trust anchor)"); + } + // Check permissions NSLog(@"Checking permissions..."); @@ -1011,9 +1114,15 @@ int main(int argc, const char* argv[]) Sleep(5000); continue; } + // 上一条连接断掉时若还挂着「切换传输」的请求,这条连接已经是按新信任锚 + // 建立的了(ConnectServer 现读 TlsEnabled),标志已过时——不清掉会让心跳 + // 循环刚进去就再断一次,白白抖动一轮。 + g_needReconnect.store(false); // 进入新连接,重置服务端身份校验状态 ClientAuth::OnNewConnection(); + // 本条连接可能是热切换信任锚后重建的:TLS 标志按当前状态重算,再发登录。 + RefreshLoginTls(logInfo); ClientObject->SendLoginInfo(logInfo.Speed(clock() - c)); // 心跳保活循环:定时发送心跳包,服务端回复后动态更新 RTT @@ -1028,10 +1137,19 @@ int main(int argc, const char* argv[]) // 等待心跳间隔(每秒检查一次退出条件,保证及时响应) int interval = g_heartbeatInterval > 0 ? g_heartbeatInterval : 30; for (int i = 0; i < interval; ++i) { + if (g_needReconnect.load(std::memory_order_relaxed)) + break; if (!ClientObject->IsRunning() || !ClientObject->IsConnected() || g_bExit != S_CLIENT_NORMAL) break; Sleep(1000); } + // 信任锚热切换(COMMAND_TLS_ENABLE/DISABLE)会置这个标志: + // 断开后由外层循环按新的传输方式重连。 + if (g_needReconnect.exchange(false)) { + Mprintf(">>> Reconnecting to apply the transport change\n"); + ClientObject->Disconnect(); + break; + } if (!ClientObject->IsRunning() || !ClientObject->IsConnected() || g_bExit != S_CLIENT_NORMAL) break; diff --git a/server/2015Remote/2015RemoteDlg.cpp b/server/2015Remote/2015RemoteDlg.cpp index 1044259..a1bef7e 100644 --- a/server/2015Remote/2015RemoteDlg.cpp +++ b/server/2015Remote/2015RemoteDlg.cpp @@ -5185,7 +5185,7 @@ void CMy2015RemoteDlg::OnExperimentTlsEnable() return; } // 二次确认:避免误点就切换被控端 TLS。 - // 两平台都是立即生效:客户端收到命令后落盘信任锚(Windows 注册表 / Linux 配置文件)、 + // 客户端都是立即生效:收到命令后落盘信任锚(Windows 注册表 / Linux、macOS 配置文件)、 // 热重载 TLS 状态(各平台 TlsChannel 的 TlsReload)并断开重连,正在进行的远程会话会中断。 if (IDYES != MessageBoxL(_T("确定对选中主机启用 TLS 传输吗?\n" "(客户端立即生效并断线重连,正在进行的远程会话会中断)"),