Question

1、连接不到VPN

表现： 连接不到VPN，日志输出为 connect vpn failed.连接服务器失败

解决： 1.查看IP和端口是否正确：是否有去空处理，打日志和加断点调试。 2.网络不通：在手机上打开浏览器，输入VPN的地址和端口，看一下能不能访问VPN服务端。如访问 https://vpnip:vpnport/ 。如果访问不到，说明你的手机或平板不能访问VPN服务器，你需要先确认4G或wifi能连通到VPN服务端。

2、认证时出现密码安全策略错误

注意：密码安全策略是针对VPN私有账号的，公有账号请忽略。 表现： 当提示“当前密码不符合以下密码策略”时，表示vpn服务端开启了密码安全策略，并且用户当前登录密码不符合其中的一些规则。 服务端密码策略配置：

客户端提示:

解决： 当用户密码不符合密码策略时，代码逻辑会走到onLoginProcess流程中，提示进行密码修改。将Demo中onLoginProcess相关代码复制到工程中。

3、登陆VPN成功后，却不能访问资源

参考开发前准备中的账号验证

4、VPN帐号的问题

公有、私有账号

公有账号：

多台设备可同时适用同一个账号。在线用户出现多个同名账户。

注意事项：公有账号容易出现授权占满的情况。

解决： 1.将VPN设备上，移动端的超时注销时间设置端一点。在SSL VPN设置---策略组管理-----默认策略组（选择用户所属的策略组）----账号控制--------移动端应用接入，设置超时注销时间。 2.app退出时，调用VPNlogout，等回调后再退出，通知服务端注销用户。

私有账号：

同一个时间，只能允许登陆一个账号。在线用户只会出现一个。 注意事项：容易出现一个账号，两个设备同时登陆，出现互踢现象。A设备登陆,B设备再登陆，B将A踢下线。A发现被下线之后，后台调用重连功能，自动登陆，又将B踢下线。B被踢后，又开启重连。造成A和B互踢。

解决：注销其中一台设备。私有账号不分享给其他人用。

本地和外部账号

一般情况下有两种结合方式：

• 如果用户对认证要求不严格的话，也就是只是用VPN的SDK来保证传输安全。这样可以分配一个公有帐号，所有客户端都使用同一帐号，直接把帐号写死在程序里面就可以了。
• 如果第一种方式不行，建议的方案采用外部账号：在VPN后台把VPN认证的帐号与业务系统的帐号配成一样。如没有使用VPN时，业务系统的使用的LDAP认证，则让VPN也允许LDAP认证。 在客户端，程序必须先通过VPN认证以后，再做业务系统的二次认证。不论哪一步认证失败，都给用户显示认证失败。最终用户看起来，就如同没有使用VPN帐号一样。

5、联通电信3G、4G网络问题

问题描述：

3G环境，EasyApp模块，认证正常，但是访问资源一直访问不上。日志上显示连接的资源地址为10.0.0.200\/10.0.0.172（电信代理服务器，联通不一样），这个地址本应该为资源地址。

原因：

不支持代理服务器连接VPN。 电信或者联通的wap网络会将连接转为运营商的代理服务器，导致连接使用了代理连接。

解决方法：

手机的运营商网络设置中，将wap网络改成net网络，这样手机就不会通过代理访问网络。

设置---更多---移动网络设置---接入点APN，wap和Net

6、L3VPN 环境检测

网络环境：

问题描述：

合入L3VPN sdk后用浏览器等访问内网资源有问题。

原因：

使用L3VPN必须满足一下三点：

1. 确定手机Android 4.0以上
2. 服务端pptp选项关闭 　　系统设置 ==》 SSLVPN选项 ==》 系统选项 ==》 接入选项下面 ==》 不启用pptp接入服务
3. 配置的资源里面有L3VPN资源 　　以上三条满足之后登陆后，直接导航栏会有权限对话框，弹出，同意后导航栏有一个小钥匙的标识。

开发环境：

问题描述：

L3VPN启动失败。

原因：

1. manifest文件中是否有注册 vpn-service服务
2. manifest文件是否有注册timeqry服务
3. 服务端虚拟ip资源是否充足
4. 在部分Android4.4的手机上由于系统bug会导致vpn远端服务无响应，此时只能重启手机解决。。

7、L3VPN没有小钥匙

日志提示Device not support service

可能原因：

1. VPN服务器没有配置L3VPN资源。解决：找管理VPN设备的负责人配置L3VPN资源。
2. L3VPN弹得允许框，之前没有允许。因为L3需要建立虚拟网卡，系统会自动弹框，用户允许才可以开启L3服务。前一次弹框用户没有允许，系统记住该配置，下次便默认采用上次的选择。
3. 在系统弹窗后没有通知sdk授权结果，导致sdk不再继续执行
4. 部分手机开启应用白名单后会导致通知栏小钥匙显示不准确，此时不必惊慌，vpn网络可以正常使用。

解决：重启手机，再次弹框，选择允许。

8、Android 64位库问题

不支持64位库，但可以在64位机上运行32位库。

解决：

1. 针对使用其他三方库的情况：将64位库中的so库移到armeabi文件夹中。删除libs下的64位文件夹。当手机是64位时，会在64位文件夹中查找库，如果不存在64位文件夹，就会到默认文件夹中去查找armeabi。但如果存在64位文件夹，却缺少库，会报错。

针对自己编译的库，编译时在Application.mk中去掉64位的编译选项。

9、Android 6.0问题

read_phone_state权限 Android6.0以上需要动态获取

解决：

参考demo中6.0权限申请代码。

10、reset by peer

问题：登陆VPN之后，访问内网地址时，访问不上。出现Connection reset by peer read data from SVPN or USER failed!:Connection reset by peer日志。

原因：

（1）VPN服务器端断开：私有账号同一个时间多设备登陆。登陆后VPN服务器会把前一个设备踢下线，而SDK设备后台又重连，导致两台设备互踢。伴有relogin关键字日志。

解决：

使用公有账号测试下。或者确保同一个私有账号同一时间只有一台SDK设备登陆。

原因：

（2）防火墙或者内网服务器断开：在VPN抓包，或者在VPN之后的其他网络设备上抓包分析。

解决：联系办事处客服配合抓包。或者联系4006306430转2总部客服抓包处理。

11、 公有账号超时注销

现象：使用公有账号，在线用户一直在增加，最终导致授权占满，无法登陆。 解决： 1.客户端退出时，使用vpnlogout，收到logout回调之后再退出。参照demo中的写法。 2.设置超时注销：SSL VPN设置---策略组管理---默认策略组（用户所在策略组）-----账号控制------常规接入和移动端接入均设置超时时间。

备注：以前版本的SDK会以“常规接入”的超时注销为准，但当前版本SDK已经使用“移动应用接入”超时注销。

12、 认为vpn网络不稳定，经常断线

此时可以使用普通http请求访问百度以及我们vpn的登录地址，若是可以正常访问，可以检查一下当前vpn的状态是否为离线，若是离线，需要重新登录vpn，若是处于并一直处于重连中，则可以通知用户换用我们其他产品如aWork或者EC进行登录，以排除中间网络的影响。

对于经常出问题的用户，也可以下载 miniConnect,当vpn出现问题时，使用其自带的诊断功能诊断网络状态。

特别强调，不要直接监听tun0网卡的状态，因为即便tun0网卡在启用，外部网络不通或者vpn的网络服务被系统阻断，也是不能正常使用vpn的，我们会有一个vpn状态回调，会通知app vpn外部网络通道的状态，应该以此为准。再者，一些情况下，手机内的虚拟网卡名字可能是tun1，tun2等。

13、 关于多应用共用l3vpn

由于系统限制，L3VPN同时只能存在一个，这就造成了互相推挤的问题。为此，我们提供两种方案供使用，这两种方案各有优缺点，我们也在考虑采取哪一种。

1. 发包检测vpn是否存在

   我们提供了一个接口 detectTunnel 来检测当前的vpn，该接口传入一个vpn地址，并构造数据包发给虚拟网卡，根据虚拟网卡回复数据包判断当前登录的vpn是否和目标vpn一致。 所有应用注册一个接口 com.sangfor.ssl.common.Foreground,当app从后台进入前台时会收到这个接口的回调，在回调中判断vpn是否还在。 可以使用这个接口检测当前有没有vpn在线，有没有必要启用vpn。

   • 优点：原生支持，只需要调用接口即可
   • 缺点：在开启vpn的应用被系统杀死后，无法通知其他应用去启动l3vpn。

2. 使用文件锁抢占建立vpn

   创建文件锁，所有要拉起vpn的应用都去获取此文件锁。获得锁的应用负责拉起vpn，当注销时，释放该锁，以供其他应用拉起vpn。没有获得文件锁的应用起异步任务阻塞式获取锁，直到成功加锁。

   • 优点：可以及时通知到vpn的断开消息
   • 缺点：需要用户自己实现

14、 关于数据安全

• 在开启l3vpn时，可以添加应用白名单，这样可以只针对部分可信应用开启vpn。此功能需要Android5.0及以上系统才支持。
• 强烈阻止将vpn账户内置到app的行为

15、 关于日志

sdk的日志存在 /sdcard/sangfor/sdklog/[包名] 文件夹下。其中 process 文件夹存放的是运行时日志，*-2.log 文件是备份文件，另一个是当前的日志文件，文件只保留两份，多余的将自动删除。 crash目录保存的是捕获到的崩溃日志，这里的崩溃不一定是sdk造成的。

目前不能指定日志提交服务器，但是提供了一个接口packLogs打包日志，包括 sdk运行日志、崩溃日志、设备信息、当前程序的logcat日志。

16、 关于保活

sdk本身没有保活机制，需要app引导用户去设置保活。sdk也可以申请一些权限来实现不被系统限制网络。

1. 可以开启前台服务，此前台服务显示一个通知栏通知，既可以显示vpn状态，也可以一定程度上做到保活。
2. 可以申请系统的悬浮窗权限，开启一个悬浮窗指示vpn状态，在一些手机上如华为，悬浮窗应用的优先级等同于前台应用。

我们观察到一些常见机型都对后台应用有限制，可以在设置中手动配置，这里提供一些参考：

    private static Intent getSettingIntent(@NonNull Context context) {
        String brand = Build.BRAND.toLowerCase();
        ArrayList<ComponentName> componentNames = new ArrayList<>();
        switch(brand){
            case "samsung":
                componentNames.add(new ComponentName("com.samsung.android.sm",/* 无法跳转 */
                        "com.samsung.android.sm.app.dashboard.SmartManagerDashBoardActivity"));
                break;
            case "meizu":
                componentNames.add(new ComponentName("com.meizu.safe",
                        "com.meizu.safe.permission.SmartBGActivity"));
                break;
            case "vivo":
                componentNames.add(new ComponentName("com.iqoo.secure", /* 无法跳转 */
                        "com.iqoo.secure.ui.phoneoptimize.AddWhiteListActivity"));
                break;
            case "oppo":
                componentNames.add(new ComponentName("com.coloros.oppoguardelf",
                        "com.coloros.powermanager.fuelgaue.PowerUsageModelActivity"));
                break;
            case "360":
                componentNames.add(new ComponentName("com.yulong.android.coolsafe",
                        "com.yulong.android.coolsafe.ui.activity.autorun.AutoRunListActivity"));
                break;
            case "xiaomi":
                componentNames.add(new ComponentName("com.miui.securitycenter", /* 可用 */
                        "com.miui.permcenter.autostart.AutoStartManagementActivity"));
                break;
            case "huawei":
                componentNames.add(new ComponentName("com.huawei.systemmanager",/* 可用 */
                        "com.huawei.systemmanager.startupmgr.ui.StartupNormalAppListActivity"));
                break;
            case "oneplus":
                componentNames.add(new ComponentName("com.oneplus.security",
                        "com.oneplus.security.chainlaunch.view.ChainLaunchAppListActivity"));
                break;
            default:
        }
        if(componentNames.size()==0){
            return new Intent(Settings.ACTION_SETTINGS);
        }
        for (ComponentName componentName : componentNames ) {
            Intent intent = new Intent();
            intent.setComponent(componentName);
            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            if (context.getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_SYSTEM_ONLY)!=null) {
                return intent;
            }
        }
       return new Intent(Settings.ACTION_SETTINGS);
    }

还有一些其他的设置，需要针对不同的机型去摸索