当前位置：首页 > article >正文

eSTK.me Cloud Enhance Server 笔记

article 2026/1/24 1:21:25

eSTK.me Cloud Enhance Server 笔记

一、概述

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

二、主要功能

处理 eUICC 请求:

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

支持多种激活码格式:

带确认码的激活码: 用于需要确认码的 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 stringserver listen address (default ":1888")-prompt stringprompt message to show on the server (max: 100 characters)-verboseverbose 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 的远程操作提供了可靠的支持。