WeKan 在无 AVX / 无 ARMv8.2-A CPU 上运行 MongoDB 的完整方案内置 cpu-exec 与 qemu-user 降级机制【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan导读本文讲解 WeKan 开源看板项目基于 Meteor 构建如何让现代 MongoDB5.0 及以上在不受支持的老旧 CPU 上继续工作。核心是 WeKan 自 9.96 版本起内置的通用cpu-exec辅助工具它检查/proc/cpuinfo中二进制所需的指令集特性缺失时自动通过 qemu-user 用户态模拟透明地重新执行该二进制。读完本文你将掌握 CPU 特性规格--features/WEKAN_REQUIRED_CPU_FEATURES的写法、qemu-user 的查找顺序、Snap 中 MongoDB 与迁移链路的接入方式以及预编译二进制、自行编译、qemu 模拟三条备选路线各自的适用场景。本文对应仓库文档 docs/Databases/MongoDB/avx-qemu.md 及其姊妹篇 docs/Databases/MongoDB/raspi4-qemu.md。背景为什么新版 MongoDB 需要更新款的 CPU从 MongoDB 官方支持政策演变而来的两条硬性约束是本文所有内容的出发点x86_64 需要 AVX 指令MongoDB 5.0 及之后版本的官方 x86_64 二进制要求 CPU 支持 AVXAdvanced Vector Extensions指令。缺少 AVX 的旧 CPU例如 Intel Core 2 Duo以及部分虚拟机/沙箱环境某些 QEMU/KVM/Proxmox 配置会屏蔽 AVX 特性位会在mongod启动瞬间以 SIGILLIllegal instruction退出码 132崩溃。arm64 需要 ARMv8.2-A 微架构从 MongoDB 4.4.19、5.0、6.0 及之后版本起arm64 官方二进制要求 ARMv8.2-A 微架构。两份支持矩阵在仓库文档中的呈现如下场景支持的 CPU典型设备新版 MongoDBx86_64 ≥ 5.0 / arm64 ≥ 4.4.19、5.0、6.0带 AVX 的 x86_64ARMv8.2-A 微架构Raspberry Pi 5、OrangePi 5、Apple Silicon arm64旧版 MongoDB 4.4.18无 AVX 的 Intel Core 2 DuoARMv8.0Cortex A53/A55/A72Raspberry Pi 3Cortex-A53、Raspberry Pi 4Cortex-A72、Orange Pi 3文档同时给出一个真实故障日志样本Raspberry Pi 4 上不借助 qemu 直接运行 MongoDB 8December 06 11:48:49 rpi4b systemd[1]: Started mongod.service - MongoDB Database Server. December 06 11:48:53 rpi4b mongod[3749]: /usr/bin/mongod: line 4: 3750 Illegal instruction (core dumped) /usr/bin/mongodreal --co December 06 11:48:53 rpi4b systemd[1]: mongod.service: Main process exited, codeexited, status132/n/a December 06 11:48:53 rpi4b systemd[1]: mongod.service: Failed with result exit-code.status132即 SIGILL这是CPU 缺少二进制所需指令集的最典型信号。另外还需注意 MongoDB 官方预编译二进制的操作系统支持范围arm64 仅支持 Ubuntu无 Raspberry Pi OS、Alpine Linux不过在 Raspberry Pi 5 上通过安装 .deb 包的方式跑 Raspberry OS 64 位硬件温度可能比 Ubuntu 更低。其余平台请以 MongoDB 官方下载页为准。WeKan 内置方案通用 cpu-exec 辅助工具自 WeKan 9.96对应 issue #6458起WeKan 在每一个 Linux 平台上都内置了通用的cpu-exec辅助工具Snap 中位于$SNAP/bin/cpu-exec每个wekan-version-arch.zip离线包中位于bundle/cpu-exec旁边还附带了同架构的qemu-arch静态二进制Docker 镜像中位于/build/cpu-execSandstorm .spk 中同样包含。它的职责一句话概括检查/proc/cpuinfo中二进制需要的 CPU 特性若缺失则通过 qemu-user实现了完整现代指令集透明地重新执行该二进制。基本用法cpu-exec --features x86_64avx,aarch64atomics mongod --dbpath ...特性规格语法与零开销默认行为--features的参数按架构组织archf1[f2...]多个架构用逗号分隔。运行时会取uname -m对应的那一项与/proc/cpuinfo的flagsx86或FeaturesARM逐项比对只要缺任意一项就进入 qemu 模拟分支。关键设计是默认零开销不带--features或规格为空或没有当前架构对应的条目cpu-exec就是一个纯粹的exec——直接把二进制原地拉起没有任何额外开销因此对任何二进制都安全可以放心地把所有启动都包一层cpu-exec。环境变量覆盖WEKAN_REQUIRED_CPU_FEATURES任何脚本或用户都可以通过环境变量声明 CPU 需求而无需修改命令本身WEKAN_REQUIRED_CPU_FEATURESx86_64avx,aarch64atomics cpu-exec mongod --dbpath ...当该环境变量被设置时它会覆盖--features参数语法相同。这一点在 cpu-exec 实现 中体现先解析--features随后[ -n ${WEKAN_REQUIRED_CPU_FEATURES:-} ] FEATURES_SPEC${WEKAN_REQUIRED_CPU_FEATURES}。qemu-user 查找顺序当判定 CPU 缺少特性后cpu-exec按以下顺序查找第一个可执行的同架构 qemu-user见 cpu-exec 实现$WEKAN_QEMU_USER显式覆盖与脚本同目录的qemu-arch即离线包 bundle 内自带、Docker/build下$SNAP/qemu-arch、$SNAP/bin/qemu-archSnap 的$SNAP/migratemongo/avx/qemu-x86_64现有 Snap amd64 包$PATH上的qemu-arch/qemu-arch-static可通过sudo apt install qemu-user-static安装。如果完全找不到 qemu脚本会打印清晰错误并仍然直接运行二进制让真实的 SIGILL 故障浮现在日志中而不是被掩盖并在日志中提示安装 qemu 或迁移到 FerretDB。arm64 特性代理aarch64atomicsaarch64atomicsLSEARMv8.1是 MongoDB ARMv8.2-A 需求在/proc/cpuinfo上的实用代理Raspberry Pi 3/4Cortex-A53/A72ARMv8.0没有该特性而 ARMv8.2-A 核心都有。所以完整的特性规格写成x86_64avx,aarch64atomics一份规格同时覆盖两种架构。实现原理从 /proc/cpuinfo 到透明重执行cpu-exec是一个 bash 脚本见 snap-src/bin/cpu-exec核心判定逻辑如下解析特性规格仅保留与uname -m匹配的当前架构条目L58-L68对每个所需特性在/proc/cpuinfo中匹配flagsx86或FeaturesARM行L73-L80一个都不缺 →exec $零开销直启L82-L84缺特性 → 按查找顺序定位 qemu把目标二进制解析为绝对路径后交给 qemu 执行L104-L119。这里有一个容易踩的坑脚本注释写得很清楚qemu-user 不搜索 PATH它直接打开给它的文件。裸命令名如mongod、echo到达 qemu 时是相对路径、不存在qemu 会以Could not open退出。因此cpu-exec先用type -P只搜 PATH避免command -v对 shell 内建命令误答解析出绝对路径再传给 qemu。为了便于测试脚本还支持WEKAN_CPUINFO环境变量覆盖/proc/cpuinfo路径。配套的纯 Node 行为测试 tests/cpuExec.test.cjs 正是利用这一钩子用假 cpuinfo 文件与假 qemu 覆盖了 8 类场景特性存在时直启、特性缺失时走 qemu、绝对路径原样透传、无特性规格时纯 exec、缺 qemu 时仍运行并打印错误、其他架构需求被忽略、环境变量覆盖--features、多特性规格任一缺失即模拟、WEKAN_QEMU_USER显式覆盖生效。配套的接线测试 tests/cpuExecWiring.test.cjs 则钉死了交付管道每个 Linux bundle 都内嵌cpu-exec及其同架构 qemuamd64 带qemu-x86_64arm64 会用qemu-aarch64替换继承的 amd64 qemuppc64le/s390x/riscv64 通过 releases/install-node-for-arch.sh 容忍式安装Windows/macOS bundle 会剥离这两个 Linux 专用文件Sandstorm 的构建脚本 sandstorm-src/build-deps.sh 与启动器 sandstorm-src/start.js 会把所有内置二进制Node、FerretDB、mongo CLI 等都路由经cpu-execSnap 的ferretdb-control、wekan-control以及 Docker 入口点 releases/ferretdb/wekan-entrypoint.sh、bundle 启动器 releases/ferretdb/start-wekan.sh 都在cpu-exec存在时优先使用、缺失时回退直启兼容旧包。Snap 集成mongod 7 与 MongoDB → FerretDB 迁移在 Snap 里cpu-exec不是可选项而是 MongoDB 服务与迁移链路的必经之路snap-src/bin/mongodb-control 定义MONGOD_CPU_FEATURESx86_64avx,aarch64atomicsL390临时初始化实例与最终前台实例都以bash $CPU_EXEC --features $MONGOD_CPU_FEATURES $SNAP/bin/mongod ...方式启动L446、L523snap-src/bin/migration-control 中用于读取现有 MongoDB 数据的临时 mongod 7 探针同样以--features x86_64avx,aarch64atomics通过cpu-exec启动L597-L601因此在无 AVX 的 CPU 上也能读取现代 MongoDB 数据完成迁移虽然慢但这是一次性读取mongod 5.0 探针也是如此L644snapcraft.yaml 通过helpers部件把snap-src整体 dump 到$SNAP从而让$SNAP/bin/cpu-exec可用。mongodb-control在启动前还会检测 CPU 并给出明确提示如果uname -m是 x86_64 且/proc/cpuinfo无avx打印 MongoDB 7 will run through qemu-user emulation (slower)并提示原生速度的替代方案 FerretDBsnap run wekan.migrateL392-L397。若 mongod 最终以 132 退出SIGILLhandle_mongod_start_failure会明确解释原因并引导到 FerretDB 或修复路径L279-L287。综上Snap 的mongodb-control和migration-control把每一次mongod 7调用都经过 cpu-exec所以 WeKan 的 MongoDB 在无 AVX 的 CPU 上包括屏蔽了 AVX 特性的虚拟机/沙箱也能运行只是更慢MongoDB → FerretDB 迁移在这些 CPU 上同样可以读取现代 MongoDB 数据。FerretDB不需要特殊 CPU 特性的原生速度替代FerretDB纯 Go SQLite不需要任何特殊 CPU 特性是原生速度的替代方案。在 Snap 上执行snap run wekan.migrate即可把 MongoDB 数据迁移到 FerretDB。这也是cpu-exec在所有日志提示中反复出现的建议模拟比原生慢考虑迁移到 FerretDB。仓库默认数据库已经是 FerretDB v1见 docs/Databases/MongoDB/README.mddocker-compose 与 bundle 启动器均默认走 FerretDB。无内置方案时的三条备选路线cpu-exec是 WeKan 生态内的自动化方案对于 WeKan 之外的、系统级安装的 MongoDB例如 Raspbian 全系统 mongod文档还给出了三条手工路线a) 使用预编译二进制针对 RasPi4 及更老设备有 MongoDB 7.3.4 的 ARMv8.0 预编译版本可供下载alpha 版可直接绕开官方二进制需要 ARMv8.2-A的限制。b) 自行编译 MongoDB耗时较长从 x86_64 交叉编译到 ARMv8.0 Cortex A53/A55/A72RasPi4 及更老设备从 x86_64 编译到不支持 AVX 的 x86_64 CPU对应 Dockerfile 中移除 AVX 相关编译选项的做法。该路线成本高、耗时长适合对二进制有强定制需求或无法接受 qemu 性能损失的场景。c) 用 qemu-user 运行 MongoDBqemu-user 可以为多种架构运行单个 Linux 可执行文件不模拟完整操作系统区别于 qemu-system在不支持 AVX 的 x86_64 CPU如 Intel Core 2 Duo上运行 MongoDB在较老 arm64如 RasPi4 及更老树莓派上运行 MongoDB。手工操作步骤系统级、非 WeKan 内置可归纳为安装qemu-user→ 把/usr/bin/mongod改名为mongodreal→ 新建一个包装脚本/usr/bin/mongod内容为#!/bin/bash\n/usr/bin/qemu-arm64 /usr/bin/mongodreal --config /etc/mongod.conf透传全部命令行参数→ 赋予执行权限 →sudo systemctl enable mongod与sudo systemctl start mongod。完整逐步操作见 docs/Databases/MongoDB/raspi4-qemu.md该文档还说明WeKan 9.96 起这些手工包装已被内置的 cpu-exec 替代手工步骤仅适用于 WeKan 之外的系统级 MongoDB。如何检测 CPU 是否支持所需特性x86_64 检测 AVXgrep -w avx /proc/cpuinfo或grep --color -m1 avx /proc/cpuinfo有输出即支持。这也是 snap-src/bin/mongodb-control 中grep -qw avx /proc/cpuinfo的判据以及 tests/cpuExec.test.cjs 中假 cpuinfo 文件flags : fpu vme avx sse2vsflags : fpu vme sse2所验证的匹配逻辑。arm64 检测 LSE/atomics查看/proc/cpuinfo的Features行是否包含atomicsARMv8.1 LSE作为 MongoDB ARMv8.2-A 需求的实用代理。参考资料与延伸阅读本文主体文档docs/Databases/MongoDB/avx-qemu.md树莓派场景姊妹篇docs/Databases/MongoDB/raspi4-qemu.mdMongoDB 数据库索引页docs/Databases/MongoDB/README.mdcpu-exec 实现snap-src/bin/cpu-exec行为测试tests/cpuExec.test.cjs交付接线测试tests/cpuExecWiring.test.cjsSnap 集成snap-src/bin/mongodb-control、snap-src/bin/migration-controlDocker 与 bundle 接入releases/ferretdb/wekan-entrypoint.sh、releases/ferretdb/start-wekan.sh关于在不受支持的 CPU 上使用 MongoDB的更多行业背景Meteor 播客、MongoDB 社区论坛讨论、CPU 检测方法等可参考上述仓库文档中记录的相关 issue#4321、#6458 等与 MongoDB 社区资料自行检索。总结WeKan 用一个通用辅助工具 平台级接线的方式系统性解决了现代 MongoDB 对 CPU 指令集的要求与老旧硬件/虚拟化环境之间的矛盾cpu-exec默认零开销、按架构声明特性、缺失时透明降级到 qemu-user并被打包进 Snap、离线 bundle、Docker 与 Sandstorm 的每一个启动路径且有完整的测试保障行为测试 交付接线测试。对追求原生性能的部署FerretDB纯 Go SQLite则提供了完全不受 CPU 特性限制的默认数据库路线。若你在 WeKan 之外手工管理 MongoDB预编译二进制、自行编译、qemu-user 包装三条路线也各有清晰的适用场景。【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WeKan 在无 AVX / 无 ARMv8.2-A CPU 上运行 MongoDB 的完整方案内置 cpu-exec 与 qemu-user 降级机制【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan导读本文讲解 WeKan 开源看板项目基于 Meteor 构建如何让现代 MongoDB5.0 及以上在不受支持的老旧 CPU 上继续工作。核心是 WeKan 自 9.96 版本起内置的通用cpu-exec辅助工具它检查/proc/cpuinfo中二进制所需的指令集特性缺失时自动通过 qemu-user 用户态模拟透明地重新执行该二进制。读完本文你将掌握 CPU 特性规格--features/WEKAN_REQUIRED_CPU_FEATURES的写法、qemu-user 的查找顺序、Snap 中 MongoDB 与迁移链路的接入方式以及预编译二进制、自行编译、qemu 模拟三条备选路线各自的适用场景。本文对应仓库文档 docs/Databases/MongoDB/avx-qemu.md 及其姊妹篇 docs/Databases/MongoDB/raspi4-qemu.md。背景为什么新版 MongoDB 需要更新款的 CPU从 MongoDB 官方支持政策演变而来的两条硬性约束是本文所有内容的出发点x86_64 需要 AVX 指令MongoDB 5.0 及之后版本的官方 x86_64 二进制要求 CPU 支持 AVXAdvanced Vector Extensions指令。缺少 AVX 的旧 CPU例如 Intel Core 2 Duo以及部分虚拟机/沙箱环境某些 QEMU/KVM/Proxmox 配置会屏蔽 AVX 特性位会在mongod启动瞬间以 SIGILLIllegal instruction退出码 132崩溃。arm64 需要 ARMv8.2-A 微架构从 MongoDB 4.4.19、5.0、6.0 及之后版本起arm64 官方二进制要求 ARMv8.2-A 微架构。两份支持矩阵在仓库文档中的呈现如下场景支持的 CPU典型设备新版 MongoDBx86_64 ≥ 5.0 / arm64 ≥ 4.4.19、5.0、6.0带 AVX 的 x86_64ARMv8.2-A 微架构Raspberry Pi 5、OrangePi 5、Apple Silicon arm64旧版 MongoDB 4.4.18无 AVX 的 Intel Core 2 DuoARMv8.0Cortex A53/A55/A72Raspberry Pi 3Cortex-A53、Raspberry Pi 4Cortex-A72、Orange Pi 3文档同时给出一个真实故障日志样本Raspberry Pi 4 上不借助 qemu 直接运行 MongoDB 8December 06 11:48:49 rpi4b systemd[1]: Started mongod.service - MongoDB Database Server. December 06 11:48:53 rpi4b mongod[3749]: /usr/bin/mongod: line 4: 3750 Illegal instruction (core dumped) /usr/bin/mongodreal --co December 06 11:48:53 rpi4b systemd[1]: mongod.service: Main process exited, codeexited, status132/n/a December 06 11:48:53 rpi4b systemd[1]: mongod.service: Failed with result exit-code.status132即 SIGILL这是CPU 缺少二进制所需指令集的最典型信号。另外还需注意 MongoDB 官方预编译二进制的操作系统支持范围arm64 仅支持 Ubuntu无 Raspberry Pi OS、Alpine Linux不过在 Raspberry Pi 5 上通过安装 .deb 包的方式跑 Raspberry OS 64 位硬件温度可能比 Ubuntu 更低。其余平台请以 MongoDB 官方下载页为准。WeKan 内置方案通用 cpu-exec 辅助工具自 WeKan 9.96对应 issue #6458起WeKan 在每一个 Linux 平台上都内置了通用的cpu-exec辅助工具Snap 中位于$SNAP/bin/cpu-exec每个wekan-version-arch.zip离线包中位于bundle/cpu-exec旁边还附带了同架构的qemu-arch静态二进制Docker 镜像中位于/build/cpu-execSandstorm .spk 中同样包含。它的职责一句话概括检查/proc/cpuinfo中二进制需要的 CPU 特性若缺失则通过 qemu-user实现了完整现代指令集透明地重新执行该二进制。基本用法cpu-exec --features x86_64avx,aarch64atomics mongod --dbpath ...特性规格语法与零开销默认行为--features的参数按架构组织archf1[f2...]多个架构用逗号分隔。运行时会取uname -m对应的那一项与/proc/cpuinfo的flagsx86或FeaturesARM逐项比对只要缺任意一项就进入 qemu 模拟分支。关键设计是默认零开销不带--features或规格为空或没有当前架构对应的条目cpu-exec就是一个纯粹的exec——直接把二进制原地拉起没有任何额外开销因此对任何二进制都安全可以放心地把所有启动都包一层cpu-exec。环境变量覆盖WEKAN_REQUIRED_CPU_FEATURES任何脚本或用户都可以通过环境变量声明 CPU 需求而无需修改命令本身WEKAN_REQUIRED_CPU_FEATURESx86_64avx,aarch64atomics cpu-exec mongod --dbpath ...当该环境变量被设置时它会覆盖--features参数语法相同。这一点在 cpu-exec 实现 中体现先解析--features随后[ -n ${WEKAN_REQUIRED_CPU_FEATURES:-} ] FEATURES_SPEC${WEKAN_REQUIRED_CPU_FEATURES}。qemu-user 查找顺序当判定 CPU 缺少特性后cpu-exec按以下顺序查找第一个可执行的同架构 qemu-user见 cpu-exec 实现$WEKAN_QEMU_USER显式覆盖与脚本同目录的qemu-arch即离线包 bundle 内自带、Docker/build下$SNAP/qemu-arch、$SNAP/bin/qemu-archSnap 的$SNAP/migratemongo/avx/qemu-x86_64现有 Snap amd64 包$PATH上的qemu-arch/qemu-arch-static可通过sudo apt install qemu-user-static安装。如果完全找不到 qemu脚本会打印清晰错误并仍然直接运行二进制让真实的 SIGILL 故障浮现在日志中而不是被掩盖并在日志中提示安装 qemu 或迁移到 FerretDB。arm64 特性代理aarch64atomicsaarch64atomicsLSEARMv8.1是 MongoDB ARMv8.2-A 需求在/proc/cpuinfo上的实用代理Raspberry Pi 3/4Cortex-A53/A72ARMv8.0没有该特性而 ARMv8.2-A 核心都有。所以完整的特性规格写成x86_64avx,aarch64atomics一份规格同时覆盖两种架构。实现原理从 /proc/cpuinfo 到透明重执行cpu-exec是一个 bash 脚本见 snap-src/bin/cpu-exec核心判定逻辑如下解析特性规格仅保留与uname -m匹配的当前架构条目L58-L68对每个所需特性在/proc/cpuinfo中匹配flagsx86或FeaturesARM行L73-L80一个都不缺 →exec $零开销直启L82-L84缺特性 → 按查找顺序定位 qemu把目标二进制解析为绝对路径后交给 qemu 执行L104-L119。这里有一个容易踩的坑脚本注释写得很清楚qemu-user 不搜索 PATH它直接打开给它的文件。裸命令名如mongod、echo到达 qemu 时是相对路径、不存在qemu 会以Could not open退出。因此cpu-exec先用type -P只搜 PATH避免command -v对 shell 内建命令误答解析出绝对路径再传给 qemu。为了便于测试脚本还支持WEKAN_CPUINFO环境变量覆盖/proc/cpuinfo路径。配套的纯 Node 行为测试 tests/cpuExec.test.cjs 正是利用这一钩子用假 cpuinfo 文件与假 qemu 覆盖了 8 类场景特性存在时直启、特性缺失时走 qemu、绝对路径原样透传、无特性规格时纯 exec、缺 qemu 时仍运行并打印错误、其他架构需求被忽略、环境变量覆盖--features、多特性规格任一缺失即模拟、WEKAN_QEMU_USER显式覆盖生效。配套的接线测试 tests/cpuExecWiring.test.cjs 则钉死了交付管道每个 Linux bundle 都内嵌cpu-exec及其同架构 qemuamd64 带qemu-x86_64arm64 会用qemu-aarch64替换继承的 amd64 qemuppc64le/s390x/riscv64 通过 releases/install-node-for-arch.sh 容忍式安装Windows/macOS bundle 会剥离这两个 Linux 专用文件Sandstorm 的构建脚本 sandstorm-src/build-deps.sh 与启动器 sandstorm-src/start.js 会把所有内置二进制Node、FerretDB、mongo CLI 等都路由经cpu-execSnap 的ferretdb-control、wekan-control以及 Docker 入口点 releases/ferretdb/wekan-entrypoint.sh、bundle 启动器 releases/ferretdb/start-wekan.sh 都在cpu-exec存在时优先使用、缺失时回退直启兼容旧包。Snap 集成mongod 7 与 MongoDB → FerretDB 迁移在 Snap 里cpu-exec不是可选项而是 MongoDB 服务与迁移链路的必经之路snap-src/bin/mongodb-control 定义MONGOD_CPU_FEATURESx86_64avx,aarch64atomicsL390临时初始化实例与最终前台实例都以bash $CPU_EXEC --features $MONGOD_CPU_FEATURES $SNAP/bin/mongod ...方式启动L446、L523snap-src/bin/migration-control 中用于读取现有 MongoDB 数据的临时 mongod 7 探针同样以--features x86_64avx,aarch64atomics通过cpu-exec启动L597-L601因此在无 AVX 的 CPU 上也能读取现代 MongoDB 数据完成迁移虽然慢但这是一次性读取mongod 5.0 探针也是如此L644snapcraft.yaml 通过helpers部件把snap-src整体 dump 到$SNAP从而让$SNAP/bin/cpu-exec可用。mongodb-control在启动前还会检测 CPU 并给出明确提示如果uname -m是 x86_64 且/proc/cpuinfo无avx打印 MongoDB 7 will run through qemu-user emulation (slower)并提示原生速度的替代方案 FerretDBsnap run wekan.migrateL392-L397。若 mongod 最终以 132 退出SIGILLhandle_mongod_start_failure会明确解释原因并引导到 FerretDB 或修复路径L279-L287。综上Snap 的mongodb-control和migration-control把每一次mongod 7调用都经过 cpu-exec所以 WeKan 的 MongoDB 在无 AVX 的 CPU 上包括屏蔽了 AVX 特性的虚拟机/沙箱也能运行只是更慢MongoDB → FerretDB 迁移在这些 CPU 上同样可以读取现代 MongoDB 数据。FerretDB不需要特殊 CPU 特性的原生速度替代FerretDB纯 Go SQLite不需要任何特殊 CPU 特性是原生速度的替代方案。在 Snap 上执行snap run wekan.migrate即可把 MongoDB 数据迁移到 FerretDB。这也是cpu-exec在所有日志提示中反复出现的建议模拟比原生慢考虑迁移到 FerretDB。仓库默认数据库已经是 FerretDB v1见 docs/Databases/MongoDB/README.mddocker-compose 与 bundle 启动器均默认走 FerretDB。无内置方案时的三条备选路线cpu-exec是 WeKan 生态内的自动化方案对于 WeKan 之外的、系统级安装的 MongoDB例如 Raspbian 全系统 mongod文档还给出了三条手工路线a) 使用预编译二进制针对 RasPi4 及更老设备有 MongoDB 7.3.4 的 ARMv8.0 预编译版本可供下载alpha 版可直接绕开官方二进制需要 ARMv8.2-A的限制。b) 自行编译 MongoDB耗时较长从 x86_64 交叉编译到 ARMv8.0 Cortex A53/A55/A72RasPi4 及更老设备从 x86_64 编译到不支持 AVX 的 x86_64 CPU对应 Dockerfile 中移除 AVX 相关编译选项的做法。该路线成本高、耗时长适合对二进制有强定制需求或无法接受 qemu 性能损失的场景。c) 用 qemu-user 运行 MongoDBqemu-user 可以为多种架构运行单个 Linux 可执行文件不模拟完整操作系统区别于 qemu-system在不支持 AVX 的 x86_64 CPU如 Intel Core 2 Duo上运行 MongoDB在较老 arm64如 RasPi4 及更老树莓派上运行 MongoDB。手工操作步骤系统级、非 WeKan 内置可归纳为安装qemu-user→ 把/usr/bin/mongod改名为mongodreal→ 新建一个包装脚本/usr/bin/mongod内容为#!/bin/bash\n/usr/bin/qemu-arm64 /usr/bin/mongodreal --config /etc/mongod.conf透传全部命令行参数→ 赋予执行权限 →sudo systemctl enable mongod与sudo systemctl start mongod。完整逐步操作见 docs/Databases/MongoDB/raspi4-qemu.md该文档还说明WeKan 9.96 起这些手工包装已被内置的 cpu-exec 替代手工步骤仅适用于 WeKan 之外的系统级 MongoDB。如何检测 CPU 是否支持所需特性x86_64 检测 AVXgrep -w avx /proc/cpuinfo或grep --color -m1 avx /proc/cpuinfo有输出即支持。这也是 snap-src/bin/mongodb-control 中grep -qw avx /proc/cpuinfo的判据以及 tests/cpuExec.test.cjs 中假 cpuinfo 文件flags : fpu vme avx sse2vsflags : fpu vme sse2所验证的匹配逻辑。arm64 检测 LSE/atomics查看/proc/cpuinfo的Features行是否包含atomicsARMv8.1 LSE作为 MongoDB ARMv8.2-A 需求的实用代理。参考资料与延伸阅读本文主体文档docs/Databases/MongoDB/avx-qemu.md树莓派场景姊妹篇docs/Databases/MongoDB/raspi4-qemu.mdMongoDB 数据库索引页docs/Databases/MongoDB/README.mdcpu-exec 实现snap-src/bin/cpu-exec行为测试tests/cpuExec.test.cjs交付接线测试tests/cpuExecWiring.test.cjsSnap 集成snap-src/bin/mongodb-control、snap-src/bin/migration-controlDocker 与 bundle 接入releases/ferretdb/wekan-entrypoint.sh、releases/ferretdb/start-wekan.sh关于在不受支持的 CPU 上使用 MongoDB的更多行业背景Meteor 播客、MongoDB 社区论坛讨论、CPU 检测方法等可参考上述仓库文档中记录的相关 issue#4321、#6458 等与 MongoDB 社区资料自行检索。总结WeKan 用一个通用辅助工具 平台级接线的方式系统性解决了现代 MongoDB 对 CPU 指令集的要求与老旧硬件/虚拟化环境之间的矛盾cpu-exec默认零开销、按架构声明特性、缺失时透明降级到 qemu-user并被打包进 Snap、离线 bundle、Docker 与 Sandstorm 的每一个启动路径且有完整的测试保障行为测试 交付接线测试。对追求原生性能的部署FerretDB纯 Go SQLite则提供了完全不受 CPU 特性限制的默认数据库路线。若你在 WeKan 之外手工管理 MongoDB预编译二进制、自行编译、qemu-user 包装三条路线也各有清晰的适用场景。【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
