主题
Micro 业务上机教程
1. 业务介绍
Micro 业务是我们专为不常见设备或低质网络打造的兜底业务。它几乎支持市面上常见的设备类型，同时支持任意 NAT 类型的 IPv4 网络。
资源与网络要求
| 项目 | 最低要求 | 说明 |
|---|---|---|
| 内存 | 可低至 15 MB | 适合内存资源有限的设备 |
| CPU | 可低至 1 个核心的 10% | 客户端 CPU 开销低 |
| 上行带宽 | 5 Mbps 及以上 | 请按实际可用上行带宽填写启动参数 |
| 网络 | 任意 NAT 类型 | 不限制 NAT 类型 |
| 设备类型 | 几乎覆盖所有常见设备 | 包括不常见设备、嵌入式设备和低配置设备 |
当前支持的操作系统与架构及测试状态见下表。如果您的设备不在列表中，请主动联系我们，我们会及时进行适配。
2. 已支持架构
| 架构 | Go GOARCH | CPU 类型 | 典型设备 | 测试状态 |
|---|---|---|---|---|
| x86_64 | amd64 | Intel/AMD 64 位 | PC、服务器、云主机 | ✅ 已测 |
| ARM64 | arm64 | AArch64 | 摄像头、飞腾、手机 | ✅ 已测 |
| ARM32 | arm | ARMv7 | 嵌入式、路由器 | ✅ 已测 |
| 龙芯 | loong64 | LoongArch64 | 龙芯 PC、服务器 | ✅ 已测 |
| MIPS64 小端 | mips64le | MIPS 64 位 | 旧版龙芯 | ✅ 已测 |
| MIPS32 | mips | MIPS 32 位 | 路由器 | ✅ 已测 |
| RISC-V | riscv64 | RISC-V 64 位 | 新兴设备 | ✅ 已测 |
| Windows | amd64 | x86_64 | PC、云桌面 | ✅ 已测 |
| Android ARM64 | arm64 | AArch64 | 手机、电视、盒子 | ✅ 已测 |
| Android ARM32 | arm | ARMv7 | 低端手机、盒子 | ✅ 已测 |
| macOS ARM64 | arm64 | Apple Silicon | MacBook、iMac | ✅ 已测 |
| macOS x86 | amd64 | Intel | 旧款 Mac | ✅ 已测 |
已测表示当前已有真机验证记录。
3. 已支持设备类型
| 序号 | 设备类型 | 测试状态 |
|---|---|---|
| 1 | 统信 UOS/麒麟 OS/信创服务器 | ✅ 已测 |
| 2 | 网吧电脑/办公PC/笔记本/NAS/蜗牛机 | ✅ 已测 |
| 3 | 云主机/云桌面/云手机 | ✅ 已测 |
| 4 | 容器 Docker/K8S | ✅ 已测 |
| 5 | 虚拟化 KVM/QEMU/LXD/VMware/Hyper-V | ✅ 已测 |
| 6 | 安卓 手机/平板/学习机/电视/机顶盒/投影仪 | ✅ 已测 |
| 7 | CPE/工控机 | ✅ 已测 |
| 8 | 智能设备 路由器/摄像头/打印机/音箱/门锁 | ✅ 已测 |
| 9 | 智能家居 冰箱/洗衣机/空调/空气净化器 | ✅ 已测 |
| 10 | 收银机/自助终端 | ✅ 已测 |
| 11 | 苹果 MacOS 电脑/笔记本 | ✅ 已测 |
已测表示当前已有真机验证记录。
4. 前置准备
上机前请准备以下信息：
UID：平台分配的用户ID，将实际值替换命令中的10086。NID：设备标识。每台设备建议使用唯一值，例如sn001，不要在多台设备上重复使用（建议使用设备序列号）。BW：计划提供的上行带宽，按 Mbps 填写数字，例如10，不要填写10M。- 设备能够访问 Micro 客户端下载地址。
查看 Linux 架构
bash
uname -m常见返回值与下载版本的对应关系如下：
uname -m 返回值 | 说明 |
|---|---|
x86_64 | Intel/AMD 64 位 CPU |
aarch64 | ARM 64 位 CPU |
armv7l、armv6l | ARM 32 位 CPU |
loongarch64 | 龙芯 64 位 CPU |
mips64el | MIPS 64 位 小端 CPU |
mips | MIPS 32 位 CPU |
riscv64 | RISC-V 64 位 CPU |
5. 手动下载接入
5.1 Linux
以下示例以 Linux x86_64 普通版为例。其他架构请将下载地址替换为上方表格中对应的文件。 注意： 下载链接仅为示例，实际下载时请根据设备架构选择对应的下载链接。
bash
# 下载 Linux x86_64 普通版
curl -sSL https://osfile-v2.ootaiwaevufe.com/micro/microaio_linux_amd64_memory_vx.x.x -o microaio
# 添加执行权限
chmod +x microaio
# 以后台方式进程方式启动
nohup ./microaio -uid=10086 -nid=sn001 -bandwidth=10 > microaio.log 2>&1 &5.2 Windows
在 PowerShell 中下载并启动：
powershell
curl.exe -L https://osfile-v2.ootaiwaevufe.com/micro/microaio_memory_vx.x.x.exe -o microaio.exe
./microaio.exe -uid=10086 -nid=sn001 -bandwidth=105.3 Android
下载 microaio_android_arm64_memory_vx.x.x 后，请按照设备的 Android 集成方式部署。Android ARM32 设备不能直接使用 ARM64 文件，需获取对应的 ARM32 版本。
5.4 参数说明
将以上示例命令中的参数替换为实际值：
| 参数 | 说明 | 示例 |
|---|---|---|
-uid | 平台分配的 UID | -uid=10086 |
-nid | 当前设备的唯一 NID | -nid=sn001 |
-bandwidth | 上行带宽，单位 Mbps | -bandwidth=10 |
6. 客户端下载
6.1 Linux 客户端
普通版下载地址：
| 架构 | 下载链接 |
|---|---|
x86_64 | 下载链接 |
aarch64 | 下载链接 |
armv7l 、armv6l | 下载链接 |
loongarch64 | 下载链接 |
mips64le | 下载链接 |
mips | 下载链接 |
riscv64 | 下载链接 |
6.2 Windows 客户端
| 架构 | 下载链接 |
|---|---|
x86_64 | 下载链接 |
6.3 Android 客户端
| 架构 | 下载链接 |
|---|---|
aarch64 | 下载链接 |
armv7l、armv6l | 下载链接 |
6.4 MacOS 客户端
MacOS ARM64、MacOS x86 当前暂不提供本页对应下载文件。需要接入这些设备时，请联系业务或技术人员获取适配版本，并先完成真机验证。
7. 启动检查与注意事项
- 下载客户端前先确认设备架构，架构不匹配时程序无法正常运行。
- 每台设备使用独立的
NID，不要复制其他设备的 NID。建议使用设备的 SN 或者 MAC 地址作为 NID。 BW、bandwidth只填写数字，单位为 Mbps；例如 10 Mbps 填写10。- 后台运行时请保留设备的进程守护能力，设备重启后按部署方式重新拉起客户端。
- 如果下载或执行失败，请先确认设备可以访问对应地址、文件具有执行权限，并检查 UID、NID 和带宽参数是否填写正确。
上机过程如果有任何问题，请联系我们解决。
