本文同时发布于西二Blog http://blog.w2fzu.com/2016/11/21/2016-11-12-learn-NetworkExtenison/
经过一番申请,我们西二在线iOS团队成功申请得到了Network Extension的Entitlement。于是,我们开始研究ne的开发。本文使用Swift语言及NEKit开源库制作一个简单的代理软件。
简易DEMO https://github.com/yichengchen/RabbitVpnDemo
Demo 在2017/5/7有更新,测试可以连接。
一、 安装NEProviderTargetTemplates.pkg
由于未知原因苹果在mac OS 10.12中删除了这个文件,因此我们需要从10.11系统中提取或下载。百度网盘
安装完毕后,在新增build target中我们就可以看到多了AppProxy和 Package Tunnrl Provider。我们选择Package Tunnrl Provider,在下一步中照例输入包名作者名等等,完成添加。

二、申请Profile
Network Extension不同于其他权限,无法在Xcode的compalities中一键启用,需要在Apple Developer中心手动申请profile。申请过程中会让选择additional entitlement,钩上我们的ne证书,生成并下载倒入Xcode。
同时编辑entitlememts文件,加入下列内容。
<key>com.apple.developer.networking.networkextension</key>
<array>
<string>packet-tunnel-provider</string>
<string>app-proxy-provider</string>
<string>content-filter-provider</string>
</array>
效果如图

PS.你需要同时为主程序和Extension创建profile。
三、第一次建立VPN链接
创建vpn profile
-
首先,我们需要在主程序中像系统生名一个ProviderManager,即设置VPN中的栏目。
let manager = NETunnelProviderManager() let conf = NETunnelProviderProtocol() conf.serverAddress = "Rabbit" //任意值,显示在设置-VPN-Detial中 manager.protocolConfiguration = conf manager.localizedDescription = "Rabbit VPN" manager.isEnabled = true //使VPN在系统中变为选中的状态
注意,如果在mac下使用network extension需要设置
conf.providerBundleIdentifier
同时打开extension的sandbox选项。
-
将manager保存至系统中。
manager.saveToPreferences{ error in if error != nil{print(error);return;} //Todo }
此时,打开系统-Vpn菜单,即可看见我们新建的Vpn条目
-
此时如果save方法调用多次,会出现VPN 1 VPN 2等多个描述文件 ,因此,苹果也要求,在创建前应读取当前的managers。
NETunnelProviderManager.loadAllFromPreferencesWithCompletionHandler{ (managers, error) in guard let managers = managers else{return} let manager: NETunnelProviderManager if managers.count > 0 { manager = managers[0] }else{ manager = self.createProviderManager() } // Todo // manager.saveToPreferences....... }
-
简单配置extension //ps 一下内容升级至Swift3
-
打开extension中的模板文件,对应Swift版本与父类修改语法。主要需要以下两个函数控制VPN状态
func startTunnel(options: [String : NSObject]? = nil, completionHandler: @escaping (Error?) -> Swift.Void) //启动VPN时调用 func stopTunnel(with reason: NEProviderStopReason, completionHandler: @escaping () -> Swift.Void) //停止VPN时调用
-
此时我们仅仅需要测试VPN连接是否能正常建立。因此我们只需要在startTunnelWithOptions中调用setTunnelNetworkSettings方法即可。当completionHandler()执行后VPN连接就会显示在手机上了。
override func startTunnel(options: [String : NSObject]? = nil, completionHandler: @escaping (Error?) -> Swift.Void){ let ipv4Settings = NEIPv4Settings(addresses: ["192.169.89.1"], subnetMasks: ["255.255.255.0"]) let networkSettings = NEPacketTunnelNetworkSettings(tunnelRemoteAddress: "8.8.8.8") networkSettings.mtu = 1500 networkSettings.iPv4Settings = ipv4Settings setTunnelNetworkSettings(networkSettings) { error in guard error == nil else { completionHandler(error) return } completionHandler(nil) } }
启动VPN
-
启动VPN很简单,只需对ProviderManager执行startVPNTunnelWithOptions()方法即可
try! manager.connection.startVPNTunnel(options: [:])
- 注意,如果在创建VPN Save后立刻执行startVPN,会遇到报错说Domain=“null”。此时说明系统还未准备好。所以应将启动代码放到 loadFromPreferences 的Block中。
saveToPreferences{ error in ..... manager.loadFromPreferences{ if $0 != nil{print($0)} manager.startVPN......... } }
-
此时,VPN应该能成功启动。
-
连接成功会manager.connection.status会发生相应改变,因此我们需要在按下连接按钮后监听status,从而知道目前Vpn的连接状态。
func addVPNStatusObserver() { guard !observerAdded else{ return } loadProviderManager { [unowned self] (manager) -> Void in if let manager = manager { self.observerAdded = true NotificationCenter.default.addObserver(forName: NSNotification.Name.NEVPNStatusDidChange, object: manager.connection, queue: OperationQueue.main, using: { [unowned self] (notification) in self.updateVPNStatus(manager: manager) }) } } }
Debug
-
Extension debug不同于正常的程序,尽量使用NSlog代替print,即可在系统日志中查看到内容。同时,如果需要Debug,可通过Xcode->Debug->Attach To Process 选择你的Tunnel名进行debug
-
若在此时启动VPN时不断提示Connection intrupt、Connection invalid ,一般是因为target配置错误导致启动失败、崩溃。比如Carthage添加了framwork却没有执行copy-framwork等等……
四、导入NEKit
Extension中导入NEKit后进行简单配置,导入规则等等可参照NEKit的项目Specht配置相应启动停止函数。注意:目前NEKit在Swift3环境下仍然存在相应问题,将导致连接在网络请求下很快崩溃断开,可考虑先使用Swift2.3版本进行操作。// 现在NEKIT在Swift3上已经稳定,可以直接使用swift3的代码
五、监听网络状态改变
-
这里是苹果的一个大坑。当网络状态改变 例如发生 WiFi->4G 切换时,若保持VPN连接,则会在状态栏上显示一个暗色的WiFi图标。反之,则会发生让手机在WiFI连接的状态下走流量等奇怪问题。
-
NEProvider 中存在属性
public var defaultPath: NWPath? { get }
表明当前系统的网络请求路径。我们可以通过KVO监听他的改变。当defaultPath与之前状态发生改变,且defaultPath.status == .Satisfied
时,我们可以认定系统网络进行了切换。此时我们需要重启VPN及重启代理服务器。
重连VPN方法非常简单,只需要再次调用StartVPN函数即可。
NSLog("Network Environment Changed")
DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in
// 延迟1s确保系统就绪
guard let strongSelf = self else { return }
strongSelf.startTunnel(options: nil), completionHandler: { _ in })
}
同时我们需要重启proxyServer,否则会发生部分连接在WiFi环境下继续使用4G网络出口等问题。
interface.stop()
proxyServer.stop()
六、传递配置文件
我们需要在主程序中传递类似账号、密码、端口、加密方式等参数给我们的VPN组件。
-
主程序写入
还记得之前的NETunnelProviderProtocol吗?我们可以把配置放在NETunnelProviderProtocol的providerConfiguration中
let conf = ["port":1000,"method":"AES-256-CFB","password":"hello"] let providerProtocol = manager.protocolConfiguration as! NETunnelProviderProtocol providerProtocol.providerConfiguration = conf manager.protocolConfiguration = orignConf
注意:设置要在save之前,否则会不生效。
-
Extension中读取:
NETunnelProvider存着我们的配置
public var protocolConfiguration: NEVPNProtocol { get }
因此我们只要直接读取就好啦~
guard let conf = (protocolConfiguration as! NETunnelProviderProtocol).providerConfiguration else{ NSLog("[ERROR] No ProtocolConfiguration Found") exit(EXIT_FAILURE) } let address = conf["address"] as! String let port = conf["port"] as! Int ...
大功告成。
七、结语
此时,我们的一个非常简单的一个利用NEKit进行的简单代理软件就完成了。其实NE开发中最困难和最多坑的地方NEKit已经帮我们解决了。本文只是帮住在像我一样在进行NetworkExtension开发尝试的iOS萌新,和我自己对这两天折腾的一个记录。
赞助我一杯可乐
