博客
快速突破网络壁垒：国际卡APN配置捷径
||
跨国网络限制不再是障碍！通过国际卡APN配置的“捷径”，仅需5分钟即可打通全球连接通道，让数据自由流动，提升海外效率。
APN是设备连接到运营商网络的“身份证”——当设备插入SIM卡并注册到运营商网络时，网络侧会检查设备发送的APN信息，从而确定为设备提供哪种类型的网络连接和服务质量等级。
一、APN基础知识
APN（Access Point Name）—— 是一种网络接入技术，终端模组在接入到网络时必须配置该参数，该参数决定了模组以何种方式接入网络；用户在上网时，针对不同的APN，核心网网元GGSN/P-GW将会把用户转接代理到不同的网络。
在LuatOS开发中，如需通过模组设置APN，所设置的APN要与SIM卡开卡时配置的APN一致。
1.1 什么情况下需要配置APN如果是专网卡，首先咨询SIM卡供应商APN参数，然后在main.lua尽可能靠前的位置调用接口进行设置。
如果是公网卡，不需要用户主动设置APN，软件自动去网络端查询APN进行设置。
1.2 如何区分专网卡和公网卡根据使用的网络类型来分，SIM卡可以分为公网卡和专网卡两种。可按照如下顺序判断确认：
咨询SIM卡供应商；
如果APN有账号、或者有密码、或者有加密类型，则可以认为是专网卡。
如果使用专网卡，需要先将访问的域名或IP加入专网卡白名单。以下是相关应用中，模组会访问的域名或IP服务器：
1.3 国内与国外APN配置差异在国内，三大运营商的公网卡大多支持即插即用，模组可以自动获取APN设置。而在海外，大多数运营商都需要手动配置APN，这也是许多国内设备出海时遇到联网问题的主要原因。
需要特别注意的是：绝对不要在国内测试好后直接发到国外使用，必须进行本地化测试。
二、Air795UG国际卡APN配置示例
Air795UG是全球通模组，支持全球主流运营商主流频段，支持4G/2G双模，支持双卡单待，支持LuatOS开发。
全球通Air795UG最新资料下载：https://docs.openluat.com/air795ug/product/shouce/
2.1 相关硬件准备
Air795UG开发板：
支持数据传输的USB数据线；
具备国际漫游功能的SIM卡；
Win10及其以上PC电脑。
LuatOS提供了便捷的API接口，可以帮助你快速配置APN。
最新API说明详见：
https://docs.openluat.com/osapi/core/mobile/
mobile.apnTableInit()
初始化自定义APN列表，主要用于海外SIM卡，无返回值。
mobile.apnTableAdd(mcc, mnc, ip_type, protocol, apn_name, user_name, password)
往自定义APN列表添加一条APN信息，主要用于海外SIM卡，相关参数说明如下表所示。
2.3 示例代码说明
国际卡APN配置示例代码如下图示，注意具体参数需要根据实际情况，跟卡商确认后填写正确信息。
2.4 示例功能验证：
Air795UG开发板通过LuaTools烧录内核固件和demo脚本代码，烧录成功后开机运行，即可查看国际卡APN配置结果。
如下图示：
今天的内容就分享到这里了~
