宝塔面板在ARM架构上可安装，但必须确保系统为aarch64架构（uname -m输出aarch64），否则无法运行；推荐使用社区验证的bt-arm.sh脚本（curl -o bt-arm.sh http://github.com/kevintangcn/bt-arm/raw/main/install.sh && sudo bash bt-arm.sh），它硬编码ARM64支持、绕过CDN探测，避免官方脚本因404失败。
宝塔面板在 ARM 架构上能装，但不能直接套用 x86_64 的安装命令——官方脚本虽支持自动识别 aarch64，但实际运行中极易因 CDN 路径未命中、环境变量失效或组件插件缺失而卡住或失败。
确认系统架构是否为 ARM64（aarch64）
这是所有操作的前提。树莓派 3B 默认是 armv7l（32 位），甲骨文实例若选错镜像也可能跑在旧版内核上。执行：
uname -m
输出必须是 aarch64 才可继续。如果是 armv7l，说明你正在运行 32 位系统，宝塔 v9.0.0+ 已彻底不支持，重刷 Raspberry Pi OS 64-bit 或 Ubuntu 22.04 ARM64 镜像是唯一可靠路径。
其他常见误判点：
-
dpkg --print-architecture输出arm64是辅助验证，但以uname -m为准 - 甲骨文实例创建时必须选择 “Ubuntu 22.04 LTS (Arm64)” 或 “Oracle Linux 8 (aarch64)”，选错会导致
glibc版本过低，后续面板服务无法启动
优先使用社区验证的 bt-arm.sh 脚本
官方脚本在 ARM 上失败的主因是 CDN 返回 404（比如请求 https://download.bt.cn/install/panel/aarch64/bt.tar.gz 但该路径未及时同步）。bt-arm.sh 绕开了全部自动探测逻辑，硬编码指向已预编译并长期维护的 ARM64 包。
执行步骤（树莓派 / 甲骨文通用）：
sudo apt update && sudo apt install -y curl wget python3<br>curl -o bt-arm.sh http://github.com/kevintangcn/bt-arm/raw/main/install.sh && sudo bash bt-arm.sh
该脚本内部已设 ARCH=aarch64，且所有依赖源都替换为 ARM64 兼容地址。安装完成后会输出类似 http://192.168.x.x:8888/xxxxx 的地址、用户名和初始密码——请立即复制保存，面板首次登录后不会再次显示。
注意：
- 不要用
sh bt-arm.sh，必须用bash，否则部分语法报错 - 若提示
command not found: curl，先执行sudo apt install -y curl - 该脚本不修改系统原有 Web 服务（如 Apache/Nginx），但若端口 8888 已被占用，需手动停掉再重试
坚持用官方脚本时必须强制 BT_ARCH 环境变量
如果你需要保持与宝塔官方更新通道一致（例如后续通过面板升级），可尝试官方脚本，但必须干预其架构判断逻辑。仅设置 export BT_ARCH=aarch64 不够，因为该变量只在当前 shell 生效，而安装过程中子进程会丢失它。
正确做法是将变量注入执行上下文：
BT_ARCH=aarch64 bash install_panel.sh
而不是分两行写：
export BT_ARCH=aarch64<br>bash install_panel.sh
此外，还需提前确保：
- 系统无残留
nginx、apache2或pure-ftpd进程，否则面板初始化会卡在端口绑定阶段 - SELinux 在 Oracle Linux 上必须禁用：
sudo setenforce 0并注释/etc/selinux/config中的SELINUX=enforcing - 安装完成后，立刻检查
/www/server/panel/install/下各组件目录名是否含aarch64字样（如nginx-aarch64），否则「软件商店」里点安装会静默失败
甲骨文 ARM 实例的 SSH 与权限特殊点
甲骨文 Ampere A1 Flex 实例默认不允许密码登录，且 root 用户不可直接 SSH。很多用户卡在第一步就连接不上，或连上后因权限不足导致安装中断。
关键动作：
- 创建实例时，必须在 “Add SSH Keys” 栏粘贴本地
id_rsa.pub公钥；私钥路径不能有空格，连接命令为：ssh -i /path/to/id_rsa opc@<public-ip> - 登录后立即切换为 root：
sudo -i，不要用su -（可能因 PAM 配置缺失失败） - 甲骨文 Ubuntu 镜像默认禁用 root 密码，
sudo -i是唯一可行方式；若执行sudo bash install_panel.sh提示权限错误，说明没切到 root - 安全组必须放行入方向 TCP 8888 端口，且面板 URL 后缀（如
/59f2e058）不能省略，否则返回 404
最后提醒：ARM 上的宝塔不是“装完就能用”。MySQL、PHP 等组件在「软件商店」中是否显示为可用，取决于宝塔后台是否已同步该架构的插件包——目前 v9.3.0+ 对 Ubuntu/Debian ARM64 支持最稳，Oracle Linux 和 CentOS Stream 仍偶发插件加载失败，这点容易被忽略。
