Files
ShadowsocksX-NG/ShadowsocksX-NG2/Tests/ProxyRuntimeControllerModeTests.swift
T
Qiu Yuzhou 16a2384498 fix(runtime): 收敛票据恒查全部失效事实,agent 关闭不再被旧收敛复活
mode/catalog 路径的票据子集缺 .flow/.agentEnabled:agent 关闭落在
mode 切换健康门 await 窗口内会被误分类为失败并触发 restore,把用户
显式的 off 意图静默撤销。删除逐 call site 挑子集的 Checks 政策,
convergenceIsCurrent 恒查 flow/mode/preparation/agentEnabled 四事实;
deployPrepared 的手工 preparation 守卫随之删除。

restore 门禁先行:agent 意图与票据时效先于回滚载荷持久化——竞态下
不再把旧 mode 写回持久层(内存/持久层分叉、用户切换被无声撤销)。

轮询写入守卫对齐同一票据词汇:防火墙轮询 await 恢复后补查代际
(cancel 后不得把 .firewallBlocked 盖回 .off);系统代理健康 Task
post-await 守卫补 agentEnabled。

新增 5 个交错/门禁测试(BlockingProbe/BlockingFirewallChecker 暂停
缝;修复前实测全红:agent 重注册、running 复活、.direct 意图被改回
.global、载荷写回、.failed 误分类);CONTEXT.md 增补 Convergence
ticket 词条。全量 792 测试通过。
2026-10-03 18:44:58 +08:00

332 lines
14 KiB
Swift

import XCTest
@testable import ShadowsocksX_NG2
/// Mode restoration and commands share the Domain availability policy without
/// starting a real runtime or touching host proxy settings.
@MainActor
extension ProxyRuntimeControllerTests {
func testRuntimeFactsProjectControllerStateAtStableSeam() async {
let controller = makeController(probe: ProxyRuntimeFixture.FakeProbe.reachable())
XCTAssertEqual(
controller.runtimeFacts,
ProxyRuntimeFacts(status: .off, isOn: false))
await controller.resyncOnLaunch()
XCTAssertEqual(
controller.runtimeFacts,
ProxyRuntimeFacts(status: .running, isOn: true),
"默认 agent 意图开启:重同步后无目标也进入空列表监听")
}
}
// MARK: - 收敛票据全事实检查(候选①:agent 关闭不得被任何 await 窗口内的
// 旧收敛复活;restore 先查时效再动持久层)
@MainActor
extension ProxyRuntimeControllerTests {
/// agent-off 落在 mode 切换的健康门 await 窗口内:票据查全四事实 →
/// superseded,不触发 restore 重注册,用户的 mode 意图保留在持久层与内存。
func testAgentOffDuringModeTransitionHealthGateSupersedesWithoutRestore() async throws {
let seeded = try makeSeededCatalog()
let probe = ProxyRuntimeFixture.BlockingProbe()
let started = expectation(description: "mode transition health probe paused")
let settingsStore = InMemoryProxySettingsStore()
let controller = makeController(
probe: probe,
settingsStore: settingsStore,
settings: ProxySettings(
listen: ActivationFixture.listen, preferredMode: .global,
agentEnabled: true, systemProxyEnabled: true),
proxyMode: .global)
try await controller.activate(seeded.server)
XCTAssertEqual(controller.state, .running)
probe.arm(started: started)
let modeSwitch = Task { await controller.setProxyMode(.direct) }
await fulfillment(of: [started], timeout: 3)
await controller.setAgentEnabled(false)
XCTAssertEqual(controller.state, .off)
let registrationsAfterStop = agent.registerCount
probe.release()
await modeSwitch.value
XCTAssertEqual(
agent.registerCount, registrationsAfterStop, "被取代的切换不得经 restore 重注册 agent")
XCTAssertEqual(controller.state, .off)
XCTAssertFalse(controller.settings.agentEnabled)
XCTAssertEqual(controller.settings.preferredMode, ProxyModeKind.direct, "切换意图保留在内存")
XCTAssertEqual(settingsStore.saved?.preferredMode, ProxyModeKind.direct, "切换意图保留在持久层")
XCTAssertEqual(settingsStore.saved?.agentEnabled, false)
XCTAssertNil(controller.lastDocument)
}
/// agent-off 落在 mode→rule 的派生窗口内:派生缝 preparationIsCurrent
/// 恒查 agent 意图与并发流,派生即弃权,apply 根本不会启动。
func testAgentOffDuringModeRuleDerivationSupersedesDeployment() async throws {
let seeded = try makeSeededCatalog()
let started = expectation(description: "rule snapshot load paused")
let release = DispatchSemaphore(value: 0)
defer { release.signal() }
let loader = BuiltinRuleSnapshots(loader: { source -> RuleSnapshot in
if source == .geolocationCN {
started.fulfill()
release.wait()
}
return rulesFixture(source)
})
let controller = makeController(
probe: ProxyRuntimeFixture.FakeProbe.reachable(),
settings: ProxySettings(
listen: ActivationFixture.listen, preferredMode: .global, agentEnabled: true),
proxyMode: .global,
ruleSnapshots: loader)
try await controller.activate(seeded.server)
let modeSwitch = Task { await controller.setProxyMode(.rule) }
await fulfillment(of: [started], timeout: 3)
await controller.setAgentEnabled(false)
XCTAssertEqual(controller.state, .off)
let registrationsAfterStop = agent.registerCount
release.signal()
await modeSwitch.value
XCTAssertEqual(agent.registerCount, registrationsAfterStop, "派生被取代后不得部署")
XCTAssertEqual(controller.state, .off)
XCTAssertNil(controller.lastDocument)
XCTAssertFalse(controller.settings.agentEnabled)
XCTAssertEqual(controller.settings.preferredMode, ProxyModeKind.rule, "切换意图保留")
}
/// restore 的时效门禁先于任何事实变更:agent 意图关闭或票据过期时弃权——
/// 不执行计划、不重注册,回滚载荷不得写回持久层(否则会静默撤销用户的
/// mode 意图)。
func testRestoreSkipsPayloadPersistenceWhenAgentOffOrSuperseded() async throws {
let seeded = try makeSeededCatalog()
let settingsStore = InMemoryProxySettingsStore()
let controller = makeController(
probe: ProxyRuntimeFixture.FakeProbe.reachable(),
settingsStore: settingsStore,
settings: ProxySettings(
listen: ActivationFixture.listen, preferredMode: .global, agentEnabled: true),
proxyMode: .global)
try await controller.activate(seeded.server)
let document = try XCTUnwrap(controller.lastDocument)
// (a) agent 意图已关闭:门禁弃权。
await controller.setAgentEnabled(false)
let registrationsAfterStop = agent.registerCount
var offTicket = controller.convergenceTicket()
let offReport = await controller.restore(
RollbackPlan(
document: document, state: .running,
payload: .modeTransition(mode: .rule, ruleDefaultAction: .proxyWhenUnmatched),
systemProxyIntentAtCapture: false, convergeProxyOnIntentChange: false),
ticket: &offTicket)
XCTAssertNil(offReport.runtimeHealthy)
XCTAssertNil(offReport.payloadFailureDescription)
XCTAssertEqual(agent.registerCount, registrationsAfterStop, "弃权的回滚不得拉起旧运行时")
XCTAssertEqual(settingsStore.saved?.preferredMode, ProxyModeKind.global, "旧载荷未写回持久层")
XCTAssertFalse(settingsStore.saved?.agentEnabled ?? true)
XCTAssertEqual(controller.state, .off)
// (b) 票据过期(mode 代际已前进):同样弃权且不写回。
await controller.setAgentEnabled(true)
await controller.setProxyMode(.direct)
XCTAssertEqual(controller.state, .running)
let staleTicket = controller.convergenceTicket()
await controller.setProxyMode(.rule)
XCTAssertEqual(controller.state, .running)
let registrationsBeforeRestore = agent.registerCount
var ticket = staleTicket
let staleReport = await controller.restore(
RollbackPlan(
document: try XCTUnwrap(controller.lastDocument), state: .running,
payload: .modeTransition(mode: .global, ruleDefaultAction: .proxyWhenUnmatched),
systemProxyIntentAtCapture: false, convergeProxyOnIntentChange: false),
ticket: &ticket)
XCTAssertNil(staleReport.runtimeHealthy)
XCTAssertEqual(agent.registerCount, registrationsBeforeRestore)
XCTAssertEqual(settingsStore.saved?.preferredMode, ProxyModeKind.rule, "过期回滚不得改写持久层")
}
/// agent-off 落在目录部署(deployPrepared 路径)的健康门窗口内:结果必须是
/// superseded(而非误分类的 failed),运行时保持 off、lastDocument 不复活。
func testAgentOffDuringDeploymentHealthGateSupersedesDeployment() async throws {
let seeded = try makeSeededCatalog()
let probe = ProxyRuntimeFixture.BlockingProbe()
let started = expectation(description: "deployment health probe paused")
let controller = makeController(
probe: probe,
settings: ProxySettings(
listen: ActivationFixture.listen, preferredMode: .global, agentEnabled: true),
proxyMode: .global)
try await controller.activate(seeded.server)
XCTAssertEqual(controller.state, .running)
probe.arm(started: started)
let deployment = Task {
await controller.deploy(SslocalRuntimeDocument(servers: [], listen: ActivationFixture.listen))
}
await fulfillment(of: [started], timeout: 3)
await controller.setAgentEnabled(false)
XCTAssertEqual(controller.state, .off)
let registrationsAfterStop = agent.registerCount
probe.release()
let result = await deployment.value
XCTAssertEqual(result, .superseded)
XCTAssertEqual(controller.state, .off)
XCTAssertEqual(agent.registerCount, registrationsAfterStop)
XCTAssertNil(controller.lastDocument)
}
/// 防火墙轮询在 await 恢复后代际已推进(含取消本任务的 stop 路径)时,
/// 不得把过期的 .firewallBlocked 盖到最新状态呈现上。
func testFirewallPollDoesNotWriteAfterExecutionSupersedesIt() async throws {
let seeded = try makeSeededCatalog()
let started = expectation(description: "firewall poll awaiting checker")
let checker = ProxyRuntimeFixture.BlockingFirewallChecker(
outcomes: [.permitted, .blocked], blockOnCall: 2, started: started)
let controller = makeController(
probe: ProxyRuntimeFixture.FakeProbe.reachable(),
listen: SslocalListenSettings(listenerMode: .allIPv4Interfaces),
firewallChecker: checker)
try await controller.activate(seeded.server)
XCTAssertEqual(controller.state, .running, "首次防火墙检查通过后进入运行态并武装轮询")
await fulfillment(of: [started], timeout: 3)
await controller.setAgentEnabled(false)
XCTAssertEqual(controller.state, .off)
checker.release()
try await Task.sleep(nanoseconds: 50_000_000)
XCTAssertEqual(controller.state, .off, "被取代的轮询不得改写状态")
}
}
/// Coordinator/controller integration for the shared committed catalog source.
@MainActor
final class CatalogRuntimeSnapshotIntegrationTests: XCTestCase {
private var runtime: ProxyRuntimeFixture.TemporaryRuntime!
private var catalogFileURL: URL!
private var activationFileURL: URL!
private var credentials: InMemoryCredentialStore!
private var agent: ProxyRuntimeFixture.FakeLaunchAgent!
private var systemProxy: ProxyRuntimeFixture.FakeSystemProxy!
override func setUp() async throws {
try await super.setUp()
runtime = ProxyRuntimeFixture.makeTemporaryRuntime()
catalogFileURL = runtime.directory.appendingPathComponent("catalog.json")
activationFileURL = runtime.directory.appendingPathComponent("activation.json")
credentials = InMemoryCredentialStore()
agent = ProxyRuntimeFixture.FakeLaunchAgent()
systemProxy = ProxyRuntimeFixture.FakeSystemProxy()
}
override func tearDown() async throws {
try? FileManager.default.removeItem(at: runtime.directory)
try await super.tearDown()
}
func testCommitWithoutActiveTargetFeedsLaterActivationThroughSharedSnapshot() async throws {
let fileStore = CatalogFileStore(fileURL: catalogFileURL)
let bootstrap = CatalogCommitCoordinator.bootstrap(fileStore: fileStore)
let controller = makeController(
catalogSnapshotReader: bootstrap.catalogSnapshotReader,
settings: ProxySettings(listen: ActivationFixture.listen, agentEnabled: false))
let coordinator = CatalogCommitCoordinator(
fileStore: fileStore,
runtime: ProxyRuntimeSyncAdapter(controller: controller),
bootstrap: bootstrap)
let server = try coordinator.commit { catalog, _ in
try ActivationFixture.addPlainServer(
"提交后激活", in: &catalog, credentials: credentials)
}
XCTAssertEqual(coordinator.syncStatus, .idle, "无目标时目录只发布,不触发运行时")
XCTAssertNil(controller.activeTargetID)
try await controller.activate(server)
XCTAssertEqual(controller.activeTargetID, server, "激活读取协调器刚发布的唯一快照")
XCTAssertEqual(controller.state, .off, "agent 意图关闭时该命令仅选择目标,不部署")
}
func testCoordinatorUsesProductionAdapterToClearRemovedActiveTarget() async throws {
let server = try makeSeededCatalog()
try ActivationStateFileStore(fileURL: activationFileURL).save(activeTargetID: server)
let fileStore = CatalogFileStore(fileURL: catalogFileURL)
let bootstrap = CatalogCommitCoordinator.bootstrap(fileStore: fileStore)
let controller = makeController(
catalogSnapshotReader: bootstrap.catalogSnapshotReader,
probe: ProxyRuntimeFixture.FakeProbe.reachable())
let coordinator = CatalogCommitCoordinator(
fileStore: fileStore,
runtime: ProxyRuntimeSyncAdapter(controller: controller),
bootstrap: bootstrap)
_ = try coordinator.commit { catalog, _ in try catalog.remove(server) }
await waitUntilRuntimeSettles(
{
if case .finished = coordinator.syncStatus { return true }
return false
}())
guard case .finished(_, .clearedAndStopped) = coordinator.syncStatus else {
return XCTFail("生产 adapter 应以刚提交快照清理无效目标")
}
XCTAssertNil(controller.activeTargetID)
XCTAssertNil(
try ActivationStateFileStore(fileURL: activationFileURL).loadActiveTargetID(),
"adapter 收敛后持久化清除失效目标")
}
private func makeController(
catalogSnapshotReader: RuntimeCatalogSnapshotReading,
settings: ProxySettings? = nil,
probe: EndpointProbing = SystemEndpointProbe()
) -> ProxyRuntimeController {
let runtimeFileStore = RuntimeFileStore(fileURL: runtime.contract)
agent.onRegister = { [runtimeFileStore] in
guard let document = runtimeFileStore.loadDocument() else { return }
try? runtimeFileStore.writeRuntimeReceipt(for: document, processID: 42)
}
return ProxyRuntimeController(
catalogSnapshotReader: catalogSnapshotReader,
activationFileStore: ActivationStateFileStore(fileURL: activationFileURL),
runtimeFileStore: runtimeFileStore,
credentials: credentials,
plugins: ActivationFixture.plugins,
listenRestore: RestoredListenSettings(
settings: ActivationFixture.listen, unreadableError: nil),
settingsStore: InMemoryProxySettingsStore(),
appBundle: AppArtifact.bundle,
settingsRestore: RestoredProxySettings(
settings: settings ?? ProxySettings(listen: ActivationFixture.listen),
unreadableError: nil),
agent: agent,
probe: probe,
systemProxy: systemProxy,
systemProxyHelper: ProxyRuntimeFixture.FakeSystemProxyHelperService(),
firewallExecutableURLs: [URL(fileURLWithPath: "/bundle/Helpers/sslocal")],
firewallPollIntervalNanoseconds: 1_000_000,
launchHealthTimeoutSeconds: 0.05,
sendSignal: { _, _ in 0 },
processIsAlive: { $0 == 42 })
}
private func makeSeededCatalog() throws -> NodeID {
var catalog = ConfigurationCatalog()
let server = try ActivationFixture.addPlainServer(
"待删除", in: &catalog, credentials: credentials)
try CatalogFileStore(fileURL: catalogFileURL).save(CatalogDocument(catalog: catalog))
return server
}
}