eSIM Tools

eSIM Tools 是一款开源、现代化的 Web 工具集，旨在简化 Giffgaff（英国）和 Simyo（荷兰）用户的 eSIM 申请、激活及管理流程。它通过自动化处理复杂的 API 调用和验证码流程，让用户只需几步操作即可生成标准的 LPA 激活二维码，彻底告别繁琐的手动配置。

核心亮点

1. 🇬🇧 Giffgaff 全自动激活

• 智能登录：支持安全的 OAuth 2.0 PKCE 认证，也支持免 OAuth 的 Cookie 快速登录。
• MFA 多因子验证：完美兼容邮件或短信验证码。
• 短信验证码激活（推荐）：
  • 全自动流程：发送验证码 → 输入6位码 → 系统自动完成预订、SIM 交换及激活。
  • 极速体验：通常 1-2 分钟内即可完成所有步骤。
  • 一键生成二维码：激活成功后，自动生成标准的 LPA 激活码和二维码，直接扫码安装。
• ⚠️ 重要提示：手动激活方式已于 2025年10月8日 被 Giffgaff 官方修复停用，请务必使用“短信验证码激活”模式。

2. Simyo 无缝切换

• 荷兰手机号专用：严格验证 06 开头的荷兰手机号格式。
• 设备更换支持：不仅支持新申请，还完整支持 SIM 卡更换流程。
• 即时二维码：自动处理短信或客服验证码，一键生成可扫描的激活码。
• 安装确认：提供清晰的引导，确保 eSIM 在新设备上正确激活。

3. 安全与隐私优先

• 本地化处理：所有敏感数据处理均在本地浏览器或你的私有部署环境中进行。
• 零存储：不存储用户的登录凭据、Cookie 或个人信息。
• 开源透明：代码完全开源，可供审计，确保无后门。

使用指南

方式一：在线服务（推荐）

无需安装，即开即用，性能优化且支持离线缓存。
🔗 访问地址: https://esim.cosr.eu.org

方式二：本地部署

适合开发者或注重极致隐私的用户。

前置要求：

• Node.js >= 18.0.0
• npm >= 8.0.0

启动步骤：

# 1. 克隆仓库
git clone https://github.com/Silentely/eSIM-Tools.git
cd eSIM-Tools

# 2. 安装依赖
npm install

# 3. 启动服务
# Windows
start_simyo_server.bat
# macOS/Linux
./start_simyo_server.sh
# 或手动启动
npm start

# 4. 访问应用
打开浏览器访问 http://localhost:3000

Giffgaff 激活详细流程

1. 身份验证：选择 OAuth 登录或 Cookie 登录，完成 MFA 验证。
2. 获取信息：系统自动拉取账户详情。
3. 选择激活方式：点击 “短信验证码激活”。
4. 接收验证码：点击发送，等待手机收到 6 位验证码。
5. 自动执行：输入验证码，系统将自动完成后续所有 API 调用（预订、交换、激活）。
6. 获取二维码：页面显示 LPA 字符串及二维码，使用手机相机或 eSIM 设置扫描即可。

💡 提示：Giffgaff 服务窗口为英国时间 04:30 – 21:30。在此时间段外操作可能会失败或不稳定，UI 会显示本地时间与英国时间的对比供参考。

技术架构

• 前端：HTML5/CSS3, JavaScript ES6+, Bootstrap 5, Service Worker (离线支持)。
• 后端代理：
  • 生产环境：Netlify Functions (无服务器架构)。
  • 开发环境：Node.js Express。
• 性能优化：Webpack + TerserPlugin 压缩，WebP 图片支持，代码分割。

常见问题

Q: 为什么手动激活不能用了？

A: Giffgaff 于 2025年10月8日修复了相关接口漏洞，停用了手动激活路径。请使用更稳定、自动化的“短信验证码激活”。

Q: 误关页面怎么办？

A: 重新登录后，系统通常会从可恢复的节点继续。建议在激活完成前保持页面开启。

Q: Simyo 收不到验证码？

A: 请检查短信拦截设置，或尝试选择“客服验证码”选项（如有）。

Q: 支持其他运营商吗？

A: 目前仅专门优化支持 Giffgaff 和 Simyo。其他运营商的 API 逻辑差异较大，暂不支持。