RealNet Pass Safari 安装指南

Safari 16.4+ (macOS 13+) - 实网腰牌统一实名认证扩展

← 返回插件下载页

方法一：Xcode 转换安装 推荐

下载扩展文件包，使用 Apple 官方工具 xcrun safari-web-extension-packager 转换为 Safari 扩展。 需要安装 Xcode 14+ 和 macOS 13+。

下载扩展文件包
  1. 点击上方按钮下载 realnet-pass-safari.zip 并解压到任意目录
  2. 确保已安装 Xcode（从 Mac App Store 下载）和 Command Line Tools
  3. 打开"终端"应用，执行以下命令转换为 Xcode 项目：
xcrun safari-web-extension-packager /path/to/realnet-pass-safari --app-name "RealNet Pass" --bundle-identifier link.realnet.pass --macos-only --copy-resources --no-open
  1. 用 Xcode 打开生成的 RealNet Pass.xcodeproj 项目
  2. 按 Cmd+R 编译并运行，系统会自动构建容器应用
  3. 在弹出的容器应用窗口中，点击"打开 Safari 扩展设置"按钮
  4. 在 Safari 偏好设置中，找到"扩展"标签页，勾选启用"RealNet Pass"
  5. 在权限提示中选择"始终允许"以授予所需的网站访问权限
首次安装：如果 Safari 不允许安装未签名扩展，请在 Safari 菜单栏选择"开发" -> "允许未签名的扩展"（需先在"高级"设置中启用"开发"菜单）。
注意：每次重启 Safari 后可能需要重新启用"允许未签名的扩展"。通过 Mac App Store 发布后则无需此步骤。

方法二：Mac App Store 安装 即将上线

RealNet Pass 即将上架 Mac App Store，届时可一键安装，无需 Xcode。

  1. 打开 Mac App Store
  2. 搜索"RealNet Pass"或"实网腰牌"
  3. 点击"获取"安装应用
  4. 打开应用，点击"启用 Safari 扩展"
  5. 在 Safari 扩展设置中勾选启用
优势：App Store 版本经过 Apple 审核，签名认证，安装后永久有效，重启浏览器无需重新配置。

安装后配置

  1. 安装完成后，Safari 工具栏会出现 RealNet Pass 图标
  2. 点击图标，在弹出窗口中输入 SSO 账号密码登录
  3. 登录成功后，插件将自动同步认证状态到浏览器
  4. 访问实网平台时无需重复登录，插件自动共享会话
会话持久化：登录后关闭浏览器再重新打开，无需重新登录。只有主动点击"退出登录"才会清除会话。

系统要求

操作系统 macOS 13.0 (Ventura) 或更高版本
Safari 版本 Safari 16.4 或更高版本
Xcode（方法一） Xcode 14 或更高版本
磁盘空间 约 10 MB（含 Xcode 项目）

常见问题

Q: 为什么 Safari 需要 Xcode 转换？
A: Safari Web Extension 必须封装在 macOS 应用中分发，不能像 Chrome/Firefox 那样直接加载 .crx/.xpi 文件。Apple 提供了官方转换工具自动化这一过程。

Q: 转换时报 manifest 警告怎么办？
A: 转换工具可能会提示某些 manifest 键不被当前 Safari 版本支持。只要不影响核心功能，可以忽略警告继续编译。Safari 16.4+ 已支持 MV3 的全部关键特性。

Q: 扩展无法在 Safari 中启用？
A: 确保已在 Safari"开发"菜单中启用"允许未签名的扩展"。如果"开发"菜单不可见，前往 Safari -> 设置 -> 高级，勾选"在菜单栏中显示开发菜单"。