Files
ShadowsocksX-NG/ShadowsocksX-NG2/Domain/ProxyMode.swift
T

147 lines
4.1 KiB
Swift

import Foundation
/// The mutually exclusive ways in which 2.0 exposes the local proxy to macOS.
enum ProxyMode: Codable, Equatable, Sendable {
case pac
case global
case manual
case externalPAC(URL)
private enum CodingKeys: String, CodingKey {
case kind
case url
}
private enum Kind: String, Codable {
case pac
case global
case manual
case externalPAC
}
init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: CodingKeys.self)
switch try container.decode(Kind.self, forKey: .kind) {
case .pac:
self = .pac
case .global:
self = .global
case .manual:
self = .manual
case .externalPAC:
self = .externalPAC(try container.decode(URL.self, forKey: .url))
}
}
func encode(to encoder: Encoder) throws {
var container = encoder.container(keyedBy: CodingKeys.self)
switch self {
case .pac:
try container.encode(Kind.pac, forKey: .kind)
case .global:
try container.encode(Kind.global, forKey: .kind)
case .manual:
try container.encode(Kind.manual, forKey: .kind)
case .externalPAC(let url):
try container.encode(Kind.externalPAC, forKey: .kind)
try container.encode(url, forKey: .url)
}
}
var label: String {
switch self {
case .pac:
"PAC"
case .global:
"全局"
case .manual:
"手动"
case .externalPAC:
"外部 PAC"
}
}
/// Derives the only system-proxy state that this mode is allowed to own.
/// `nil` means manual mode: restore the user's previous system settings and
/// leave them under the user's control.
func systemProxyConfiguration(
for document: SslocalRuntimeDocument
) throws -> SystemProxyConfiguration? {
switch self {
case .pac:
guard let url = document.pac.publicURL else {
throw ProxyModeError.invalidLocalPACURL
}
return SystemProxyConfiguration(target: .pac(url))
case .global:
guard (1...65535).contains(document.socksPort) else {
throw ProxyModeError.invalidSOCKSPort(document.socksPort)
}
return SystemProxyConfiguration(
target: .socks(host: "127.0.0.1", port: document.socksPort))
case .manual:
return nil
case .externalPAC(let url):
try Self.validateExternalPACURL(url)
return SystemProxyConfiguration(target: .pac(url))
}
}
static func validateExternalPACURL(_ url: URL) throws {
guard let scheme = url.scheme?.lowercased() else {
throw ProxyModeError.externalPACURLHasNoScheme
}
guard scheme == "http" || scheme == "https" else {
throw ProxyModeError.unsupportedExternalPACScheme(scheme)
}
guard url.host != nil else {
throw ProxyModeError.externalPACURLHasNoHost
}
guard url.user == nil && url.password == nil else {
throw ProxyModeError.externalPACURLContainsCredentials
}
guard url.absoluteString.utf8.count <= 2048 else {
throw ProxyModeError.externalPACURLTooLong
}
}
}
/// The part of the system proxy dictionary that 2.0 intentionally controls.
struct SystemProxyConfiguration: Equatable, Sendable {
enum Target: Equatable, Sendable {
case pac(URL)
case socks(host: String, port: Int)
}
let target: Target
}
enum ProxyModeError: Error, Equatable, Sendable {
case invalidLocalPACURL
case invalidSOCKSPort(Int)
case externalPACURLHasNoScheme
case unsupportedExternalPACScheme(String)
case externalPACURLHasNoHost
case externalPACURLContainsCredentials
case externalPACURLTooLong
var presentedReason: String {
switch self {
case .invalidLocalPACURL:
"本地 PAC URL 无效"
case .invalidSOCKSPort(let port):
"SOCKS 端口无效:\(port)"
case .externalPACURLHasNoScheme:
"外部 PAC URL 缺少协议"
case .unsupportedExternalPACScheme(let scheme):
"外部 PAC 不支持协议:\(scheme)"
case .externalPACURLHasNoHost:
"外部 PAC URL 缺少主机"
case .externalPACURLContainsCredentials:
"外部 PAC URL 不得包含凭据"
case .externalPACURLTooLong:
"外部 PAC URL 过长"
}
}
}