用于设置操作系统的局域网设置的Node模块(Node >= v7.6), 支持 Windows、macOS, 后续会支持 Linux
npm i --save lan-settings
const lan = require('lan-settings'); // 获取设备的所有可用 NetworkServices (macOS Only) lan.listNetworkServices() .then(console.log.bind(console, '获取成功: ')) .catch(console.log.bind(console, '获取失败: ')); // 获取当前局域网设置信息,如果err非空,表示获取失败 lan.getSettings() .then(console.log.bind(console, '获取成功: ')) .catch(console.log.bind(console, '获取失败: ')); // output: // { autoDetect: false, // autoConfig: false, // autoConfigUrl: '', // proxyEnable: true, // proxyServer: '127.0.0.1:8888', // bypassLocal: false, // bypass: '' } // 自动检测设置 lan.setSettings({ autoDetect: true }) .then(console.log.bind(console, '设置成功')) .catch(console.log.bind(console, '设置失败: ')); // 开启并这种PAC脚本 lan.setSettings({ autoConfig: true, autoConfigUrl: 'http://127.0.0.1:50011' }) .then(console.log.bind(console, '设置成功')) .catch(console.log.bind(console, '设置失败: ')); // 开启并设置统一的代理服务器,开启本地代理白名单 lan.setSettings({ proxyEnable: true, proxyServer: '127.0.0.1:8888', bypassLocal: true }) .then(console.log.bind(console, '设置成功')) .catch(console.log.bind(console, '设置失败: ')); // 高级设置,对http、https、ftp、socks分别设置不同的代理,并设置白名单域名前缀 lan.setSettings({ proxyEnable: true, proxyServer: 'http=127.0.0.1:8888;https=127.0.0.1:8889;ftp=127.0.0.1:8890;socks=127.0.0.1:8891', bypassLocal: false, bypass: 'www.test;www.abc' }) .then(console.log.bind(console, '设置成功')) .catch(console.log.bind(console, '设置失败: ')); // 重置到修改前的设置 lan.reset() .then(console.log.bind(console, '设置成功')) .catch(console.log.bind(console, '设置失败: '));
const lan = require('lan-settings'); // 获取设备的所有可用 NetworkServices (macOS Only) lan.listNetworkServices(function(err, services) { console.log(err ? '获取失败' : '获取成功'); console.log(services); }); // 获取当前局域网设置信息,如果err非空,表示获取失败 lan.getSettings(function(err, settings) { console.log(settings); // output: // { autoDetect: false, // autoConfig: false, // autoConfigUrl: '', // proxyEnable: true, // proxyServer: '127.0.0.1:8888', // bypassLocal: false, // bypass: '' } }); // 自动检测设置 lan.setSettings({ autoDetect: true }, function(err) { console.log(err ? 'Fail' : 'Success'); }); // 开启并这种PAC脚本 lan.setSettings({ autoConfig: true, autoConfigUrl: 'http://127.0.0.1:30001/' }, function(err) { console.log(err ? 'Fail' : 'Success'); }); // 开启并设置统一的代理服务器,开启本地代理白名单 lan.setSettings({ proxyEnable: true, proxyServer: '127.0.0.1:8888', bypassLocal: true }, function(err) { console.log(err ? 'Fail' : 'Success'); }); // 高级设置,对http、https、ftp、socks分别设置不同的代理,并设置白名单域名前缀 lan.setSettings({ proxyEnable: true, proxyServer: 'http=127.0.0.1:8888;https=127.0.0.1:8889;ftp=127.0.0.1:8890;socks=127.0.0.1:8891', bypassLocal: false, bypass: 'www.test;www.abc' }, function(err) { console.log(err ? 'Fail' : 'Success'); }); // 重置到修改前的设置 lan.reset(function(err) { console.log(err ? 'Fail' : 'Success'); });
lan.listNetworkServices([cb]):
获取设备的所有可用 NetworkServices
cb(err) 为可选回调函数,如果重置失败,则err不为空; (macOS only)
若不传入回调函数, 则返回 Promise 对象;
[ 'iPhone USB', 'Ethernet', 'Wi-Fi', 'Bluetooth PAN', 'Thunderbolt Bridge' ]
lan.getSettings([cb, networkservice]):
获取当前局域网设置信息
其中 cb(err, settings) 为可选回调函数,如果出错err不为空,否则settings为当前系统局域网设置信息;
若不传入回调函数, 则返回 Promise 对象;
{ autoDetect: true, // 是否开启自动检查设置 autoConfig: true, // 是否开启pac脚本 autoConfigUrl: 'http://127.0.0.1:50011', // pac脚本的url proxyEnable: true, // 是否开启代理设置 proxyServer: '127.0.0.1:8888', // 代理服务器ip和端口,如果使用高级设置,可能返回 `htt=127.0.0.1:8888;https=127.0.0.2:8889`等 bypassLocal: true, // 是否启用对本地地址不使用代理 bypass: 'www.test;www.abc' // 高级设置里面的白名单信息 }
lan.setSettings(settings, [cb, networkservice]):
设置局域网信息
settings如上,如果为null表示清空并关闭所有局域网设置项,cb(err) 为可选回调函数,如果设置失败,则err不为空。
若不传入回调函数, 则返回 Promise 对象;
lan.reset(cb[, networkservice]):
将局域网设置重置到修改前
cb(err) 为可选回调函数,如果重置失败,则err不为空。
若不传入回调函数, 则返回 Promise 对象;