Installing the Maikr Pro beta XPI in Firefox
For beta testers. Covers maikr-firefox-beta-v1.1.3.xpi — an unsigned build.
| File | maikr-firefox-beta-v1.1.3.xpi |
| Version | 1.1.3 |
| Size | 2.3 MB |
| SHA-256 | 425463385fb050d2a9057ed1123a45b2463ef71a38b10e5d6124fb15c15a7da1 |
| Add-on ID | proxy-manager@maikrapps.com |
| Requires | Firefox 140.0+ desktop (Android: 142.0+) |
| Signed by Mozilla | No |
Read this first — the build is unsigned
This XPI has never been sent to Mozilla, so it carries no signature. Firefox has enforced
add-on signing on release builds since version 48, and stock Firefox Release and Beta
ignore the xpinstall.signatures.required preference entirely — it is not a
setting you can flip there. That is a deliberate safety decision by Mozilla, not a bug or a
misconfiguration.
The practical consequence: which Firefox you run decides which install method works.
| Your Firefox | Permanent install | Temporary install |
|---|---|---|
| Release (normal download) | ✕ not possible | ✓ Method B |
| Beta (branded) | ✕ not possible | ✓ Method B |
| Developer Edition | ✓ Method A | ✓ Method B |
| Nightly | ✓ Method A | ✓ Method B |
| Unbranded Beta / Release | ✓ Method A | ✓ Method B |
| ESR | ⚠ unreliable — treat as ✕ | ✓ Method B |
Check your build via Firefox → About Firefox. “Developer Edition” and “Nightly” say so explicitly; a plain version number means Release.
If you were told to “just turn off signature checking” on normal Firefox — that has not been possible for years. Use Method B, or install Developer Edition.
Method A — Permanent install (Developer Edition / Nightly / unbranded)
Survives restarts. Requires one of the builds marked ✓ above.
- Open a new tab, go to
about:config, accept the warning. - Search for
xpinstall.signatures.required. - Set it to
false(double-click the row to toggle). - Go to
about:addons. - Click the gear icon (top right) → Install Add-on From File…
- Select
maikr-firefox-beta-v1.1.3.xpi. - Confirm the permission prompt (see below).
Verify: the add-on appears in about:addons under Extensions, and the Maikr icon
appears in the toolbar.
If step 3 has no effect and the install is still refused, you are on a build that ignores the pref — go to Method B.
Method B — Temporary install (works on every Firefox)
Nothing to configure, but the add-on is removed when Firefox closes. You will redo this each session. Good for a quick test; painful for multi-day testing.
- Go to
about:debugging. - Click This Firefox in the left sidebar.
- Click Load Temporary Add-on…
- Select
maikr-firefox-beta-v1.1.3.xpi.
The add-on loads immediately. It disappears on restart — including on crash or update.
You may select the unzipped folder’s
manifest.jsoninstead of the XPI; both work.
Permissions you will be asked to approve
Expected, and required for the extension to function:
- Access your data for all websites — proxy routing decisions are made per-request, so the extension must see the request URL to decide direct-vs-proxy.
- Control browser proxy settings — the core function.
- Access browser tabs — to show per-tab proxy status on the toolbar icon.
- Monitor extension usage and manage themes (
management) — used to detect other extensions competing for proxy control and name them in the conflict warning. - Storage / Alarms — settings persistence and periodic reconnect scheduling.
Verify the file before installing
Confirm the download was not corrupted or substituted:
shasum -a 256 maikr-firefox-beta-v1.1.3.xpiMust print:
425463385fb050d2a9057ed1123a45b2463ef71a38b10e5d6124fb15c15a7da1If it does not match, do not install — re-download and report it.
Updating to a later beta
Unsigned betas have no auto-update. Each new build is installed by hand.
- Method A: repeat steps 4–7. Installing a higher version over the same add-on ID upgrades in place and preserves your settings.
- Method B: just load the new file after restart.
To downgrade or start clean, remove it from about:addons first.
Uninstalling
- Method A:
about:addons→ Extensions → Maikr Pro → ⋯ → Remove - Method B: restart Firefox, or click Remove in
about:debugging
To also discard stored settings, remove the add-on before reinstalling — data is keyed to the add-on ID and otherwise survives.
Troubleshooting
“This add-on could not be installed because it appears to be corrupt”
Usually not corruption — it is the signature check on a build that enforces it. Verify the SHA-256 above; if it matches, you are on stock Release/Beta. Use Method B.
“The add-on is not compatible with this version of Firefox”
Requires Firefox 140.0+. Check About Firefox and update.
Extension installs but the toolbar icon is missing
Firefox may have collapsed it into the overflow (») menu. Open the toolbar customization menu and drag it out.
Settings vanished after restart
You used Method B. Temporary add-ons are removed on close, taking their storage with them. Use Method A for anything longer than a single session.
Nothing routes through the proxy
Another extension may hold the proxy setting — Firefox grants it to one extension at a time. Maikr Pro’s popup reports the conflict and names the competing extension. Disable that one, or give Maikr Pro precedence.
Reporting problems
Include: Firefox version and channel (About Firefox), OS, install method (A or B), what you expected, what happened, and anything in the console.
Background-script logs: about:debugging → This Firefox → find
Maikr Pro → Inspect. That console is the one that matters; the page console will
not show background errors.
Send to maikrvpn@gmail.com.
↓ 中文版本在 Firefox 中安装 Maikr Pro 测试版
供测试人员使用。本文档针对 maikr-firefox-beta-v1.1.3.xpi——一个未签名的构建版本。
| 文件 | maikr-firefox-beta-v1.1.3.xpi |
| 版本 | 1.1.3 |
| 大小 | 2.3 MB |
| SHA-256 | 425463385fb050d2a9057ed1123a45b2463ef71a38b10e5d6124fb15c15a7da1 |
| 扩展 ID | proxy-manager@maikrapps.com |
| 系统要求 | Firefox 桌面版 140.0 以上（Android：142.0 以上） |
| 是否经 Mozilla 签名 | 否 |
请先阅读——此版本未签名
该 XPI 从未提交给 Mozilla，因此不带任何签名。自 Firefox 48 起，正式版已强制要求扩展签名，
并且普通版（Release）和 Beta 版会完全忽略 xpinstall.signatures.required
这一设置项——在这些版本中该开关根本不起作用。这是 Mozilla 出于安全考虑的有意设计，
并非缺陷或配置错误。
由此带来的实际影响：你使用的 Firefox 版本决定了哪种安装方式可行。
| 你的 Firefox 版本 | 永久安装 | 临时安装 |
|---|---|---|
| Release 正式版（常规下载） | ✕ 无法安装 | ✓ 方式 B |
| Beta 测试版（官方品牌版） | ✕ 无法安装 | ✓ 方式 B |
| Developer Edition 开发者版 | ✓ 方式 A | ✓ 方式 B |
| Nightly 每夜构建版 | ✓ 方式 A | ✓ 方式 B |
| 无品牌（Unbranded）Beta / Release | ✓ 方式 A | ✓ 方式 B |
| ESR 延长支持版 | ⚠ 不可靠——请视同 ✕ | ✓ 方式 B |
请通过 Firefox →「关于 Firefox」（About Firefox） 查看你的版本。开发者版和 Nightly 会明确标注名称；若只显示版本号，则为正式版。
如果有人告诉你「在普通 Firefox 上把签名校验关掉就行」——这种做法多年前就已失效。 请改用方式 B，或安装 Developer Edition 开发者版。
方式 A——永久安装（开发者版 / Nightly / 无品牌版）
重启后依然保留。需使用上表中标记 ✓ 的版本。
- 新建标签页，访问
about:config，接受风险提示。 - 搜索
xpinstall.signatures.required。 - 将其设为
false（双击该行即可切换）。 - 访问
about:addons。 - 点击右上角的齿轮图标 →「从文件安装附加组件…」（Install Add-on From File…）。
- 选择
maikr-firefox-beta-v1.1.3.xpi。 - 在权限提示中点击确认（权限说明见下文）。
验证方法：该扩展会出现在 about:addons 的「扩展」列表中，且工具栏上会显示
Maikr 图标。
如果第 3 步没有任何效果、安装仍被拒绝，说明你所用的版本会忽略该设置项——请改用方式 B。
方式 B——临时安装（所有 Firefox 版本均可）
无需任何配置，但关闭 Firefox 后扩展会被移除，每次启动都需重新加载。 适合快速测试；若需连续多日测试则较为繁琐。
- 访问
about:debugging。 - 点击左侧栏的「此 Firefox」（This Firefox）。
- 点击「加载临时附加组件…」（Load Temporary Add-on…）。
- 选择
maikr-firefox-beta-v1.1.3.xpi。
扩展会立即加载。重启后即消失——崩溃或浏览器更新同样会导致其消失。
你也可以选择解压后文件夹中的
manifest.json来代替 XPI 文件，两种方式均可。
安装时会请求的权限
以下权限均为扩展正常运行所必需：
- 访问您在所有网站上的数据——代理路由是按请求逐条判断的，因此扩展必须读取 请求的 URL，才能决定该请求走直连还是走代理。
- 控制浏览器代理设置——扩展的核心功能。
- 访问浏览器标签页——用于在工具栏图标上显示各标签页的代理状态。
- 监视扩展使用情况并管理主题（
management）——用于检测其他 同样争夺代理控制权的扩展，并在冲突警告中指出具体是哪一个。 - 存储 / 闹钟（Storage / Alarms）——用于保存设置以及定时重连调度。
安装前请校验文件
确认下载的文件未损坏、未被替换：
shasum -a 256 maikr-firefox-beta-v1.1.3.xpi输出必须为：
425463385fb050d2a9057ed1123a45b2463ef71a38b10e5d6124fb15c15a7da1若不一致，请勿安装——请重新下载并向我们反馈。
升级到后续测试版
未签名的测试版不支持自动更新，每个新版本都需手动安装。
- 方式 A：重复第 4–7 步。由于扩展 ID 相同，安装更高版本会原地升级并保留 你的设置。
- 方式 B：重启后直接加载新文件即可。
若需降级或从干净状态开始，请先在 about:addons 中移除该扩展。
卸载
- 方式 A：
about:addons→「扩展」→ Maikr Pro → ⋯ →「移除」（Remove） - 方式 B：重启 Firefox，或在
about:debugging中点击 「移除」（Remove）
如果同时要清除已保存的设置，请先移除扩展再重新安装——数据是按扩展 ID 保存的，否则会一直保留。
常见问题排查
提示「该附加组件似乎已损坏，无法安装」
通常并非文件损坏，而是该版本强制执行了签名校验。请先核对上文的 SHA-256；若校验值一致， 说明你使用的是正式版或 Beta 版，请改用方式 B。
提示「该附加组件与此版本的 Firefox 不兼容」
本扩展需要 Firefox 140.0 以上版本。请在「关于 Firefox」中查看版本并升级。
扩展已安装，但工具栏上看不到图标
Firefox 可能已将其折叠到溢出菜单（»）中。打开工具栏自定义菜单， 将图标拖出即可。
重启后设置全部丢失
这是因为你使用了方式 B。临时扩展会在浏览器关闭时被移除，其存储数据也随之清除。 若测试时间超过单次会话，请使用方式 A。
流量没有走代理
可能有其他扩展正占用代理设置——Firefox 同一时间只允许一个扩展控制代理。 Maikr Pro 的弹窗会报告该冲突并指出具体是哪个扩展。请禁用该扩展，或让 Maikr Pro 优先。
问题反馈
请提供：Firefox 版本及渠道（见「关于 Firefox」）、操作系统、所用安装方式（A 或 B）、 预期结果、实际结果，以及控制台中的相关信息。
后台脚本日志查看方式：about:debugging →「此 Firefox」→
找到 Maikr Pro →「检查」（Inspect）。请以该控制台为准；普通页面的控制台
不会显示后台脚本的错误。
请发送至 maikrvpn@gmail.com。
↑ English version