宝塔面板官方安装脚本本身为Shell脚本，不区分架构，但会根据uname -m检测到的aarch64或x86_64自动下载对应架构的二进制组件；自v7.9.0起正式支持ARM64，需系统为aarch64且Linux内核≥5.4。
如果您尝试在ARM架构机器上安装宝塔面板，但发现官方脚本无法正常执行或提示架构不兼容，则可能是由于安装脚本未适配ARM指令集。以下是针对不同CPU架构的安装方式说明：
一、官方安装脚本是否区分架构
宝塔面板官方提供的Linux一键安装脚本（如curl -sSO https://download.bt.cn/install/install_panel.sh）本身为Shell脚本，不直接包含二进制指令，因此脚本文件本身无x86或ARM之分。但其内部调用的安装逻辑会根据系统架构自动下载对应平台的二进制组件（如bt主程序、nginx、python插件等）。这些预编译二进制包存在明确的架构绑定。
1、脚本运行时会通过uname -m检测当前CPU架构，识别结果为aarch64（ARM64）或x86_64；
2、随后向宝塔CDN请求对应架构的安装包URL，例如https://download.bt.cn/install/panel/aarch64/bt.tar.gz或https://download.bt.cn/install/panel/x86_64/bt.tar.gz；
3、若目标架构未被官方支持（如早期ARM版本缺失），则可能返回404错误或降级使用通用Python源码模式，导致功能受限或启动失败。
二、ARM架构下可使用的安装方式
当标准脚本在ARM机器上失败时，需采用适配ARM的替代安装路径。宝塔自v7.9.0起正式支持ARM64，但仅限于主流Linux发行版（如Ubuntu 20.04+/Debian 11+/CentOS Stream 9+）且内核版本需≥5.4。
1、确认系统为ARM64架构：执行 uname -m，输出必须为 aarch64；
2、使用宝塔官方ARM专用安装命令：bash （该脚本已内置ARM分支判断逻辑）；
3、若仍失败，可手动指定架构参数：export BT_ARCH=aarch64 && bash ；
三、x86架构机器上的标准安装流程
x86_64环境下的安装脚本行为确定且稳定，所有组件均从x86_64专用路径拉取，无需额外干预。该流程依赖Intel/AMD处理器的CISC指令集特性及glibc ABI兼容性。
1、执行标准命令：curl -sSO https://download.bt.cn/install/install_panel.sh && bash install_panel.sh；
2、脚本自动识别x86_64并下载https://download.bt.cn/install/panel/x86_64/bt.tar.gz；
3、解压后启动服务，所有子进程（如pure-ftpd、nginx、php-fpm）均调用x86_64编译版本。
四、混合架构验证与调试方法
当同一套脚本在不同架构机器上表现不一致时，需定位具体失败环节。关键检查点在于二进制组件的ABI匹配性与动态链接库依赖。
1、查看下载日志：grep -i "arch\|aarch64\|x86_64" /www/server/panel/logs/install.log；
2、验证主程序架构：file /www/server/panel/pyenv/bin/python，输出应含ARM aarch64或ELF 64-bit LSB pie executable, x86-64；
3、检查缺失依赖：ldd /www/server/panel/pyenv/bin/python | grep "not found"，ARM系统中不可使用x86_64的.so文件。
