LoongArch64 (loong64) 龙芯架构:Docker Buildx 多架构镜像构建指南

环境

[root@anolis ~]# uname -a
Linux anolis 6.6.102-5.3.3.an23.loongarch64 #1 SMP Tue May 26 14:00:16 CST 2026 loongarch64 loongarch64 loongarch64 GNU/Linux
[root@anolis ~]# 

问题

[root@anolis ~]# docker run --rm --privileged tonistiigi/binfmt --install all || true
Unable to find image 'tonistiigi/binfmt:latest' locally
latest: Pulling from tonistiigi/binfmt
docker: no matching manifest for linux/loong64 in the manifest list entries

Run 'docker run --help' for more information
[root@anolis ~]#

解决方案

使用 ghcr.io/loong64/binfmt

docker run --rm --privileged ghcr.io/loong64/binfmt --install all || true
docker buildx create --name ci-builder --use --driver docker-container --driver-opt image=ghcr.io/loong64/buildkit:buildx-stable-1 || docker buildx use ci-builder
docker buildx inspect --bootstrap

# docker buildx inspect --bootstrap --builder ci-builder
[root@anolis ~]# docker run --rm --privileged ghcr.io/loong64/binfmt --install all || true
Unable to find image 'ghcr.io/loong64/binfmt:latest' locally
latest: Pulling from loong64/binfmt
86723d0c8d07: Pull complete 
5c6aa5b88ca8: Pull complete 
Digest: sha256:abe730caa95d5495aa1b888e2d77eadc41b3ea303ef75e2d82f8dad420b7f4d9
Status: Downloaded newer image for ghcr.io/loong64/binfmt:latest
{
  "supported": [
    "linux/loong64",
    "linux/amd64",
    "linux/amd64/v2",
    "linux/arm64",
    "linux/riscv64",
    "linux/ppc64le",
    "linux/s390x",
    "linux/386",
    "linux/mips64le",
    "linux/mips64",
    "linux/arm/v7",
    "linux/arm/v6"
  ],
  "emulators": [
    "qemu-aarch64",
    "qemu-arm",
    "qemu-i386",
    "qemu-mips64",
    "qemu-mips64el",
    "qemu-ppc64le",
    "qemu-riscv64",
    "qemu-s390x",
    "qemu-x86_64"
  ]
}
[root@anolis ~]# 
[root@anolis ~]# docker buildx create --name ci-builder --use --driver docker-container --driver-opt image=ghcr.io/loong64/buildkit:buildx-stable-1 || docker buildx use ci-builder
ci-builder
[root@anolis ~]#
root@anolis buildkit]# docker buildx inspect --bootstrap
[+] Building 4.5s (1/1) FINISHED                                                                                                                                                                 
 => [internal] booting buildkit                                                                                                                                                             4.5s
 => => pulling image ghcr.io/loong64/buildkit:buildx-stable-1                                                                                                                               1.4s
 => => creating container buildx_buildkit_ci-builder0                                                                                                                                       3.1s
Name:          ci-builder
Driver:        docker-container
Last Activity: 2026-07-18 19:03:53 +0000 UTC

Nodes:
Name:                  ci-builder0
Endpoint:              unix:///var/run/docker.sock
Driver Options:        image="ghcr.io/loong64/buildkit:buildx-stable-1"
Status:                running
BuildKit daemon flags: --allow-insecure-entitlement=network.host
BuildKit version:      v0.20.1
Platforms:             linux/loong64, linux/amd64, linux/amd64/v2, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/mips64le, linux/mips64, linux/arm/v7, linux/arm/v6
Labels:
 org.mobyproject.buildkit.worker.executor:         oci
 org.mobyproject.buildkit.worker.hostname:         b9a22f46ee58
 org.mobyproject.buildkit.worker.network:          host
 org.mobyproject.buildkit.worker.oci.process-mode: sandbox
 org.mobyproject.buildkit.worker.selinux.enabled:  false
 org.mobyproject.buildkit.worker.snapshotter:      overlayfs
GC Policy rule#0:
 All:            false
 Filters:        type==source.local,type==exec.cachemount,type==source.git.checkout
 Keep Duration:  48h0m0s
 Max Used Space: 488.3MiB
GC Policy rule#1:
 All:            false
 Keep Duration:  1440h0m0s
 Reserved Space: 9.313GiB
 Max Used Space: 93.13GiB
 Min Free Space: 41.91GiB
GC Policy rule#2:
 All:            false
 Reserved Space: 9.313GiB
 Max Used Space: 93.13GiB
 Min Free Space: 41.91GiB
GC Policy rule#3:
 All:            true
 Reserved Space: 9.313GiB
 Max Used Space: 93.13GiB
 Min Free Space: 41.91GiB
[root@anolis ~]#