mirror of
https://github.com/shadowsocks/ShadowsocksX-NG.git
synced 2026-11-22 13:34:00 +00:00
93 lines
3.6 KiB
Swift
93 lines
3.6 KiB
Swift
import Foundation
|
||
|
||
/// #33 的用户偏好快照。监听端点仍是运行时契约的输入,但不会把偏好文件
|
||
/// 当作运行时文件使用;代理启动前由控制器从快照重新派生完整契约。
|
||
struct ProxySettings: Equatable, Sendable {
|
||
static let defaultProxyExceptions = ""
|
||
|
||
var listen: SslocalListenSettings
|
||
/// User-added system-proxy exceptions; these entries do not become ACL rules.
|
||
var proxyExceptions: String
|
||
/// The persisted current mode: the mode selector's choice survives GUI
|
||
/// restarts. First run defaults to rule mode (issue #67).
|
||
var preferredMode: ProxyModeKind
|
||
/// 规则模式子选项(issue #63):未匹配默认动作,出厂「未匹配时代理」。
|
||
var ruleDefaultAction: RuleDefaultAction
|
||
/// 代理 agent 意图(issue #60,ADR-0011):默认关闭——全新用户没有服务器
|
||
/// 配置,默认启动没有意义;用户显式打开的选择持久化,且偏好重置不改变它。
|
||
var agentEnabled: Bool
|
||
/// 系统代理意图(issue #60):默认关闭;与 agent 意图相互独立,开关关闭
|
||
/// 关闭时清理匹配 NG2 端点的系统代理配置,不影响本地监听。
|
||
var systemProxyEnabled: Bool
|
||
|
||
init(
|
||
listen: SslocalListenSettings = SslocalListenSettings(),
|
||
proxyExceptions: String = ProxySettings.defaultProxyExceptions,
|
||
preferredMode: ProxyModeKind = .rule,
|
||
ruleDefaultAction: RuleDefaultAction = .proxyWhenUnmatched,
|
||
agentEnabled: Bool = false,
|
||
systemProxyEnabled: Bool = false
|
||
) {
|
||
self.listen = listen
|
||
self.proxyExceptions = proxyExceptions
|
||
self.preferredMode = preferredMode
|
||
self.ruleDefaultAction = ruleDefaultAction
|
||
self.agentEnabled = agentEnabled
|
||
self.systemProxyEnabled = systemProxyEnabled
|
||
}
|
||
|
||
/// 系统代理的 ExceptionsList;输入顺序保留,重复项只保留第一次出现的值。
|
||
var proxyExceptionList: [String] {
|
||
var result: [String] = []
|
||
var seen = Set<String>()
|
||
for value in proxyExceptions.split(whereSeparator: { character in
|
||
character == "," || character == "、" || character.isWhitespace
|
||
}) {
|
||
let item = String(value)
|
||
let identity = item.lowercased()
|
||
guard !item.isEmpty, seen.insert(identity).inserted else { continue }
|
||
result.append(item)
|
||
}
|
||
return result
|
||
}
|
||
|
||
var validationErrors: [ProxySettingsValidationError] {
|
||
listen.portValidationErrors().map(ProxySettingsValidationError.init)
|
||
}
|
||
}
|
||
|
||
/// 设置快照的点名校验错误;端口错误保留 D8 的端点与数值信息。
|
||
enum ProxySettingsValidationError: Error, Hashable, Sendable {
|
||
case portOutOfRange(endpoint: ProxyEndpointKind, port: Int)
|
||
case duplicatePort(endpoint: ProxyEndpointKind, otherEndpoint: ProxyEndpointKind, port: Int)
|
||
|
||
init(_ error: PortSettingError) {
|
||
switch error {
|
||
case .portOutOfRange(let endpoint, let port):
|
||
self = .portOutOfRange(endpoint: endpoint, port: port)
|
||
case .duplicatePort(let endpoint, let otherEndpoint, let port):
|
||
self = .duplicatePort(endpoint: endpoint, otherEndpoint: otherEndpoint, port: port)
|
||
}
|
||
}
|
||
|
||
}
|
||
|
||
protocol ProxySettingsStoring {
|
||
func load() throws -> ProxySettings
|
||
func save(_ settings: ProxySettings) throws
|
||
}
|
||
|
||
enum ProxySettingsStoreError: Error, Equatable {
|
||
case corrupt(detail: String)
|
||
case invalid([ProxySettingsValidationError])
|
||
case ioFailure(detail: String)
|
||
case missingCredential(CredentialReference)
|
||
case credentialFailure(detail: String)
|
||
case legacyListenSettings(ListenSettingsStoreError)
|
||
}
|
||
|
||
struct RestoredProxySettings: Equatable {
|
||
let settings: ProxySettings
|
||
let unreadableError: ProxySettingsStoreError?
|
||
}
|