eSTK.me Cloud Enhance Server 笔记

eSTK.me Cloud Enhance Server 笔记

一、 概述

eSTK.me Cloud Enhance Server 是一个用 Go 语言编写的开源服务器，旨在处理 eSTK.me 远程 eUICC（嵌入式通用集成电路卡）的请求，例如配置文件下载和通知处理。该服务器主要针对 ESTKme ECO/Lite 系列可拆卸 eUICC，目前不支持 ESTKme 2025 系列可拆卸 eUICC（如 DRO、MEGA 等）。

二、 主要功能

1.

处理 eUICC 请求:

• 下载配置文件: 接收来自 eUICC 的下载请求，并将配置文件传输到 eUICC。
• 处理通知: 接收来自 eUICC 的通知请求，并执行相应的操作，例如发送通知、删除通知等。

2.

支持多种激活码格式:

• 带确认码的激活码: 用于需要确认码的 eSIM 提供商。
  • 格式: LPA:1$SM-DP+$Matching Id$$<confirmation_code>
  • 例如: LPA:1$SM-DP+\$1234567890$$abcdef123456
• 带自定义 IMEI 的激活码: 用于需要自定义 IMEI 的情况。
  • 带确认码: LPA:1$SM-DP+$Matching Id$$<confirmation_code>#<custom_imei>
  • 不带确认码: LPA:1$SM-DP+$Matching Id#<custom_imei>
• 例如: LPA:1$SM-DP+\$1234567890$$abcdef123456#123456789012345

三、 安装与部署

1. 二进制文件安装

• 下载二进制文件: 从 GitHub Releases 页面 下载预编译的二进制文件。
• 构建二进制文件:
  • 克隆仓库:

    git clone git@github.com:damonto/estkme-cloud.git
    cd estkme-cloud
    

  • 使用 Go 编译:

    go build -trimpath -ldflags="-w -s" -o estkme-cloud main.go
    

  • 设置可执行权限:

    chmod +x estkme-cloud
    

• 安装依赖项:
  • Debian:

    apt-get install -y --no-install-recommends ca-certificates libpcsclite1 libcurl4
    

  • Arch Linux:

    pacman -S pcsclite
    

• 运行服务器:
  • 默认端口为 1888:

    ./estkme-cloud
    

  • 使用 --help 标志查看可用选项:

    ./estkme-cloud --help
    

    Usage of estkme-cloud:
      -listen-address string
            server listen address (default ":1888")
      -prompt string
            prompt message to show on the server (max: 100 characters)
      -verbose
            verbose mode
    

• 后台运行:
  • 使用 systemctl 命令将服务器作为服务运行：1.创建服务文件，例如 /etc/systemd/system/estkme-cloud.service，内容如下：

    [Unit]
    Description=eSTK.me Cloud Enhance Server
    After=network.target
    [Service]
    Type=simple
    User=your_user_here
    Restart=on-failure
    ExecStart=/your/binary/path/here/estkme-cloud
    RestartSec=10s
    TimeoutStopSec=30s
    [Install]
    WantedBy=multi-user.target
    

    2.启动服务:

    systemctl start estkme-cloud
    

    3.设置开机自启:

    systemctl enable estkme-cloud
    

2. Docker 安装

• 使用 Docker 运行服务器:

  docker run -d --name estkme-cloud -p 1888:1888 damonto/estkme-cloud:latest
  

  或者使用 GitHub 容器注册表:

  docker run -d --name estkme-cloud -p 1888:1888 ghcr.io/damonto/estkme-cloud:latest
  

四、 使用指南

1. 下载配置文件

• 启用 Cloud Enhance: 在 eUICC 上启用 Cloud Enhance 功能，并将服务器监听地址设置为服务器地址。
• 发送下载请求: 服务器将处理下载请求，并将配置文件下载到 eUICC。
• 激活码格式:
  • 带确认码: 使用上述带确认码的激活码格式。
  • 带自定义 IMEI: 使用上述带自定义 IMEI 的激活码格式。

2. 常用命令

• 消耗数据:

  /data <amount_of_data_in_KiB>
  

  例如: /data 1024 表示消耗 1 MiB 数据。

• 列出通知:

  /ln <enable|disable|install|delete>
  

  例如: /ln enable 表示启用通知。

• 处理通知:

  /process <seq number>
  

  可以使用 /ln 命令获取 seq number。

3. 通知处理

• 当用户在 eSTK.me eUICC 上点击 “Process Notification” 按钮时，服务器将接收通知请求并发送所有通知。
• 注意事项:

  1.所有启用、禁用和安装通知在发送后将被删除。

  2.删除通知将保留在您的 eSTK.me eUICC 中。

五、 总结

eSTK.me Cloud Enhance Server 为 eUICC 的远程配置和管理提供了一个高效、安全的解决方案。通过支持多种激活码格式和常用命令，该服务器为用户提供了灵活的操作方式。同时，服务器的安全性和稳定性也得到了保障，为 eUICC 的远程操作提供了可靠的支持。