import XCTest @testable import ShadowsocksX_NG2 /// 运行时文件存取(spec #21 D5,issue #27):0700/0600 权限基线、原子替换、 /// 读取侧判定与显式停止清理。 final class RuntimeFileStoreTests: XCTestCase { private var runtime: ProxyRuntimeFixture.TemporaryRuntime! private var store: RuntimeFileStore! override func setUpWithError() throws { try super.setUpWithError() runtime = ProxyRuntimeFixture.makeTemporaryRuntime() store = RuntimeFileStore(fileURL: runtime.contract) } override func tearDownWithError() throws { try? FileManager.default.removeItem(at: runtime.directory) try super.tearDownWithError() } private func permissions(of url: URL) throws -> Int { let attributes = try FileManager.default.attributesOfItem(atPath: url.path) return try XCTUnwrap(attributes[.posixPermissions] as? Int) } // MARK: 权限基线(D5) func testWriteCreatesDirectoryWith0700AndFileWith0600() throws { try store.write(ProxyRuntimeFixture.makeDocument()) XCTAssertEqual(try permissions(of: runtime.directory), 0o700, "runtime/ 目录 0700") XCTAssertEqual(try permissions(of: runtime.contract), 0o600, "契约文件 0600") } func testWriteHealsDirectoryPermissionBaseline() throws { try FileManager.default.createDirectory( at: runtime.directory, withIntermediateDirectories: true) try FileManager.default.setAttributes( [.posixPermissions: 0o755], ofItemAtPath: runtime.directory.path) try store.write(ProxyRuntimeFixture.makeDocument()) XCTAssertEqual(try permissions(of: runtime.directory), 0o700, "目录权限自愈回 0700") } func testAtomicReplaceKeepsFileAt0600() throws { try store.write(ProxyRuntimeFixture.makeDocument(localPort: 1086)) try store.write(ProxyRuntimeFixture.makeDocument(localPort: 2086)) XCTAssertEqual(try permissions(of: runtime.contract), 0o600, "替换后仍 0600") let document = try XCTUnwrap(store.loadDocument()) XCTAssertEqual(document.socksPort, 2086, "内容已被原子替换") } func testWriteLeavesNoTemporaryFilesBehind() throws { try store.write(ProxyRuntimeFixture.makeDocument()) try store.write(ProxyRuntimeFixture.makeDocument(localPort: 2087)) let residue = try FileManager.default.contentsOfDirectory(atPath: runtime.directory.path) .filter { $0.hasPrefix(".sslocal-active.json.tmp-") } XCTAssertTrue(residue.isEmpty, "临时文件不应残留,实际 \(residue)") } // MARK: 读取侧判定 func testLoadDocumentRoundTripsWrittenDocument() throws { let document = ProxyRuntimeFixture.makeDocument() try store.write(document) XCTAssertEqual(try store.loadDocument(), document) XCTAssertEqual(try store.readData(), try document.jsonData()) } func testLoadDocumentReturnsNilForMissingFile() throws { XCTAssertNil(try store.loadDocument()) XCTAssertNil(try store.readData()) } func testLoadDocumentReturnsNilForCorruptJSON() throws { try Data("not json {".utf8).write(to: runtime.contract) XCTAssertNil(try store.loadDocument()) } func testLoadDocumentReturnsNilForStructurallyInvalidDocument() throws { try store.write( SslocalRuntimeDocument( servers: [], listen: SslocalListenSettings(httpProxyEnabled: false))) XCTAssertNil(try store.loadDocument(), "空 servers 属结构性无效(读取侧防御)") } // MARK: 显式停止清理 func testDeleteRuntimeFilesRemovesContractPidAndStaleTemporaries() throws { try store.write(ProxyRuntimeFixture.makeDocument()) try Data("1086".utf8).write(to: runtime.pidFile) let staleTemporary = runtime.directory.appendingPathComponent(".sslocal-active.json.tmp-stale") try Data("partial".utf8).write(to: staleTemporary) store.deleteRuntimeFiles() XCTAssertFalse(FileManager.default.fileExists(atPath: runtime.contract.path)) XCTAssertFalse(FileManager.default.fileExists(atPath: runtime.pidFile.path)) XCTAssertFalse(FileManager.default.fileExists(atPath: staleTemporary.path)) } func testDeleteRuntimeFilesIsHarmlessWhenNothingExists() throws { store.deleteRuntimeFiles() store.deleteRuntimeFiles() XCTAssertTrue(true, "重复清理不抛错") } // MARK: 文档校验与监听指纹 func testWellFormedValidationRejectsStructuralGarbage() { func document( localPort: Int = 1086, servers: [SslocalServerDocument] ) -> SslocalRuntimeDocument { SslocalRuntimeDocument( servers: servers, listen: SslocalListenSettings( socksPort: localPort, httpProxyEnabled: false, pacPort: 1089)) } func server( id: String = "s", address: String = "203.0.113.7", port: Int = 8388, method: String = "aes-256-gcm" ) -> SslocalServerDocument { SslocalServerDocument( id: id, remarks: "", server: address, serverPort: port, password: "pw", method: method, plugin: nil, pluginOpts: nil) } XCTAssertTrue(document(servers: [server()]).isWellFormed) XCTAssertFalse(document(servers: []).isWellFormed, "空 servers 无效") XCTAssertFalse(document(localPort: 0, servers: [server()]).isWellFormed) XCTAssertFalse(document(localPort: 65_536, servers: [server()]).isWellFormed) XCTAssertFalse(document(servers: [server(port: 0)]).isWellFormed) XCTAssertFalse(document(servers: [server(address: "")]).isWellFormed) XCTAssertFalse(document(servers: [server(method: "")]).isWellFormed) XCTAssertFalse(document(servers: [server(id: "")]).isWellFormed) } func testListenFingerprintIgnoresServerChangesAndTracksListenFields() { let base = ProxyRuntimeFixture.makeDocument() let serverChanged = ProxyRuntimeFixture.makeDocument(serverAddress: "198.51.100.9") let listenChanged = ProxyRuntimeFixture.makeDocument(localPort: 2088) XCTAssertEqual( base.listenFingerprint, serverChanged.listenFingerprint, "仅服务器列表变化不影响监听指纹(走 SIGUSR1 热重载)") XCTAssertNotEqual( base.listenFingerprint, listenChanged.listenFingerprint, "监听端口变化改变指纹(走优雅重启)") } }