Metal 发布的操作系统映像
2025年1月5日日,Equinix Metal将停止支持Alma Linux、Alpine Linux、Flatcar Linux和FreeBSD操作系统。届时,未运行这些操作系统的用户在部署新服务器时将无法再选择它们。已运行这些操作系统的服务器不受影响。
Equinix Metal™ 提供一系列操作系统供您在我们的平台上部署。Metal 的操作系统镜像是上游云镜像的轻度修改版本,旨在与我们的服务器硬件和网络配置兼容。
我们免费提供 Linux 和开源操作系统,授权操作系统按使用量或自带许可模式计费,或者您可以使用自定义 iPXE自带操作系统。
关于我们的图像
操作系统镜像的变更记录在 equinixmetal-images/changelog 中。镜像版本尽可能与上游版本保持一致。
变更日志旨在显示自上次发布映像以来哪些软件包发生了变化、映像中使用的内核以及新发布的映像与上游云映像有哪些偏差(如果有)。
当您使用我们的镜像配置服务器时,您将获得我们发布的最新镜像。一旦您配置了服务器,我们将不再访问该系统;您有责任确保操作系统保持最新状态。
如果我们没有提供符合您使用场景的操作系统或操作系统版本,您可以使用 自定义 iPXE 导入您自己的映像。
图像生命周期
Equinix Metal在 API 中发布了我们图像生命周期的日期。
要查找特定操作系统和版本的生命周期日期,请向 /operating-systems 端点发送 GET 请求,并按路径中的操作系统别名进行筛选。
curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/operating-systems?slug=<os_slug>
响应参数:
“release_date”- The date the upstream operating system maintainer released this version."build date"- The date Metal built and released the current operating system image.“deprecation_date”- The date set by the upstream operating system maintainer indicating the end of feature updates and bug fixes, and the beginning of security-only updates for this operating system version.“end_of_service_date”- A Metal-specific date, typically 30 days before end-of-life, when you should for prepare any new provisions to use the newest version of the operating system.“end_of_life_date”- The operating system image no longer receives any updates and can be disabled at any time. Metal typically matches the end-of-life date to the deprecation date set by the operating system maintainer.
API 响应还包含一个 "lifecycle_state" 参数,用于指示操作系统映像所处的生命周期阶段。可能的状态有:
"testing""pre_release""active""deprecated""end_of_service""end_of_life"
请注意,状态为 "testing" 和 "pre_release" 的镜像可能不处于可配置或可运行状态。尝试使用状态为 "testing" 或 "pre_release" 的镜像配置服务器可能会导致错误,因此这些镜像仅应用于测试和评估。
生命终结图像
当操作系统镜像停止维护时,您将无法再通过控制台或 API 在新服务器上配置该镜像。停止维护的镜像最终会从 Metal API 中完全移除,其变更日志也会从 变更日志存储库 中移除。
运行已停产操作系统的服务器将继续正常运行,但您将无法通过Metal控制台或 API 为新服务器配置相同的操作系统映像或版本。
操作系统参考
Debian
默认用户:root
操作系统 | 别名 | 弃用 | 服务终止 | 生命周期终止 | 变更日志 |
-------|-------|-------|-------|-------|-------|-------|
Debian 12 | debian_12 | 2026/06/30 | 2028/05/10 | 2028/06/10 | x86_64 arm64 |
Debian 11 | debian_11 | 2024/08/14 | 2026/05/31 | 2026-06-31 | x86_64 arm64 |
Rocky Linux
默认用户:root
操作系统 | 别名 | 弃用 | 服务终止 | 生命周期终止 | 变更日志 |
-------|-------|-------|-------|-------|-------|-------|
Rocky Linux 9 | rocky_9 | 2027/05/31 | 2032/04/30 | 2032/05/31 | x86_64 arm64
Rocky Linux 8 | rocky_8 | 2024/05/31 | 2029/04/29 | 2029/05/31 | x86_64 arm64
Ubuntu
默认用户:root
操作系统 | 别名 | 弃用 | 服务终止 | 生命周期终止 | 变更日志 |
-------|-------|-------|-------|-------|-------|-------|
Ubuntu 24.04 LTS | ubuntu_24_04 | 2024-09-30 | 2029/03/01 | 2029/04/01 | x86_64 arm64
Ubuntu 22.04 LTS | ubuntu_22_04 | 2024-09-30 | 2027/03/01 | 2027/04/01 | x86_64 arm64
服务器兼容性
我们所有的操作系统映像都经过验证流程,以便在我们的服务器计划中配置。并非所有操作系统都适用于每台服务器。
- CLI
- API
要获取哪些服务器上有哪些操作系统的列表,请使用 metal operating-systems get 命令,并将输出指定为 JSON 格式。
metal operating-systems get -o json
响应中包含一个 "provisionable_on" 对象,它是一个包含可配置操作系统的服务器的数组。(示例响应已被截断。)
{
"id": "d782347f-fd9a-4427-b7bb-6b9d4c1ebfc0",
"slug": "debian_12",
"name": "Debian 12",
"version": "12",
"provisionable_on": [
"a3.large.x86",
"c2.medium.x86",
"c3.large.arm64",
"c3.medium.x86",
"c3.small.x86",
....
]
},
要获取哪些服务器上可用的操作系统列表,请向 /operating-systems 端点发送 GET 请求。
curl -X GET \
-H 'X-Auth-Token: <API_TOKEN>' \
"https://api.equinix.com/metal/v1/operating-systems"
响应将包含操作系统名称、ID 和别名,如果您通过 API 或 CLI 配置服务器,这些信息非常有用。响应还将包含 "provisionable_on",这是一个包含可配置该操作系统的服务器的数组。(示例响应已被截断。)
{
"id": "d782347f-fd9a-4427-b7bb-6b9d4c1ebfc0",
"slug": "debian_12",
"name": "Debian 12",
"version": "12",
"provisionable_on": [
"a3.large.x86",
"c2.medium.x86",
"c3.large.arm64",
"c3.medium.x86",
"c3.small.x86",
....
]
},
使用 Metal 发布的镜像进行配置
- Console
- CLI
- API
当您通过Equinix Metal控制台配置服务器时,可用的操作系统将由您选择的服务器进行过滤。

如果您从预留服务器或通过现货市场进行配置,您的操作系统选项也会受到类似过滤。
在 CLI 中使用 metal device create 命令配置服务器时,必需的 --operating-system 或 -O 参数用于指定要在服务器上安装哪个操作系统。
metal device create -p $METAL_PROJECT_ID -m <metro> -P <plan_slug> -O <os_slug>
如果您尝试使用与硬件不兼容的操作系统来配置服务器,您将收到 ... is not a valid operating system 错误响应。
如果您正在通过 API 配置服务器,则需要在 operating_systems 字段中指定要在服务器上安装的操作系统。该字段为必填项。
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
"metro": "<metro>",
"plan": "<plan_slug>",
"operating_system": "<os_slug>"
}'
如果您尝试使用与硬件不兼容的操作系统来配置服务器,您将收到 ... is not a valid operating system 错误响应。