在麒麟OS上安装税务、社保、公积金插件须严格匹配国产CPU架构（飞腾/鲲鹏/龙芯）、使用指定浏览器（Firefox 115.12+ ESR或麒麟浏览器）及32位运行环境与定制Java 11，否则将出现“无法加载”“插件空白”等故障。
在麒麟OS上完成税务、社保、公积金等财务申报系统插件安装，必须匹配国产CPU架构（如飞腾、鲲鹏、龙芯）、启用对应浏览器内核（Firefox或麒麟浏览器），且多数插件依赖32位运行环境与特定Java版本。直接双击安装或忽略架构校验会导致“无法加载”“插件空白”“点击无响应”等故障。
安装国家税务总局电子税务局插件
该插件仅支持Firefox浏览器（非Chrome系），且必须使用麒麟OS预装的Firefox 115.12+ ESR版本，旧版或手动升级的Firefox可能因NPAPI接口禁用而彻底失效。
第一步：确认浏览器版本与架构
打开Firefox → 地址栏输入 about:support → 查看“应用程序版本”是否为115.12.0esr，并核对“平台”字段含aarch64（ARM）或x86_64（AMD/Intel）字样；若显示i686或x86，说明当前是32位Firefox，需卸载后重装64位版本。
第二步：下载并启用官方插件包
访问国家税务总局电子税务局官网“下载中心”→ 下载kylin-firefox-plugin-2024-v3.2.1.deb（注意文件名含kylin标识）→ 双击该.deb文件，由麒麟安装器自动部署至/usr/lib/firefox/browser/plugins/目录。
第三步：强制启用NPAPI插件支持
在Firefox地址栏输入 about:config → 点击“接受风险并继续” → 搜索plugin.load_flash_only → 双击将其值设为false；再搜索dom.ipc.plugins.enabled.libflashplayer.so → 设为true。这一步跳过将导致插件图标显示为灰色不可点击状态。
第四步：验证插件加载
重启Firefox → 访问about:plugins → 查找“National Tax Plugin”条目，状态必须显示“已启用”，类型为“Gecko Plugin”。若仍显示“缺失”，请检查/usr/lib/firefox/browser/plugins/下是否存在libntplugin.so文件，缺失则需重新执行第二步。
安装社保/医保网上申报系统ActiveX替代插件
原Windows ActiveX控件在麒麟OS无法运行，必须使用麒麟官方适配的kylin-activex-emulator容器插件，该插件通过沙箱模拟IE9 DOM接口，仅支持麒麟浏览器（非Chromium内核分支）。
方法一：APT源一键安装（推荐）
打开终端 → 执行sudo apt update → 再执行sudo apt install kylin-activex-emulator -y。安装后无需重启浏览器，插件自动注入麒麟浏览器进程。
方法二：手动注册插件文件
从省级人社厅官网下载kylin-socsec-emulator-1.8.3.tar.gz → 解压后进入plugin/子目录 → 将libsocsec_emu.so复制到/opt/kylin-browser/plugins/（若目录不存在则创建）→ 执行sudo chmod 755 /opt/kylin-browser/plugins/libsocsec_emu.so。【注意：必须用sudo chmod，普通用户权限会导致插件被浏览器拒绝加载】
方法三：离线部署（适用于涉密专网）
将已安装kylin-activex-emulator的机器上的/var/lib/kylin-activex-emulator/整个目录打包 → 拷贝至目标机 → 执行sudo cp -r kylin-activex-emulator /var/lib/ → 运行sudo systemctl restart kylin-browser-plugin-daemon激活服务。
安装住房公积金管理中心客户端插件
公积金系统插件分两类：网页端需Firefox插件，客户端需独立Java应用。两者必须使用同一套JRE——kylin-jre-11.0.22-openjdk-aarch64（ARM）或kylin-jre-11.0.22-openjdk-amd64（x86_64），其他JDK版本会触发“签名不匹配”错误。
① 安装Firefox网页插件
从当地公积金官网下载gjj-web-plugin-kylin-v2.1.0.xpi → Firefox地址栏输入about:addons → 点击右上角“⋯”→ “从文件安装附加组件” → 选择该.xpi文件 → 安装后立即启用。
② 配置客户端Java环境
下载对应架构的kylin-jre-11.0.22-openjdk压缩包 → 解压至/opt/jdk11 → 编辑/etc/environment，追加两行：
JAVA_HOME="/opt/jdk11"
JRE_HOME="/opt/jdk11/jre" → 执行source /etc/environment生效。
③ 运行客户端安装包
下载gjj-client-kylin-4.3.5.run → 终端中执行chmod +x gjj-client-kylin-4.3.5.run → 运行./gjj-client-kylin-4.3.5.run → 安装路径必须选/opt/gjj-client（硬编码路径，改路径会导致启动失败）。
④ 启动前强制绑定JRE
编辑/opt/gjj-client/bin/start.sh → 找到java -jar行 → 在其前方插入/opt/jdk11/jre/bin/java完整路径，确保调用的是麒麟定制JRE而非系统默认Java。
