宝塔官方脚本在树莓派上大概率失败是因为默认不下载arm64二进制包，需确保系统为aarch64架构、内核≥5.4，并推荐使用社区arm64专用脚本bt-arm.sh安装。

宝塔官方脚本在树莓派上大概率直接失败，不是因为命令写错了，而是它默认不下载 ARM 版二进制包——除非你手动干预架构识别逻辑。

确认你的树莓派确实是 ARM64（aarch64）架构

宝塔只支持 ARM64，不支持 32 位的 armv7l（比如树莓派 3B 默认系统、旧版 Raspbian）。执行：

uname -m

必须输出 aarch64 才能继续。如果输出 armv7l，说明你跑的是 32 位系统，此时：

• 重刷 Raspberry Pi OS 64-bit（Bookworm 或 Bullseye）镜像，这是最稳妥的路径
• 不要试图 patch 官方脚本去“骗过”32 位检测——自 v9.0.0 起，宝塔已彻底移除对 32 位 Linux 的支持

用社区验证过的 ARM 专用安装脚本（推荐新手）

官方脚本在 ARM 上常卡在下载 bt.tar.gz 阶段，因为 CDN 返回 404。社区维护的 bt-arm.sh 直接指向预编译好的 ARM64 包，跳过架构探测环节。

操作步骤：

• 确保已安装 curl、python3 和 wget：sudo apt update && sudo apt install -y curl wget python3
• 下载并运行脚本：curl -o bt-arm.sh http://github.com/kevintangcn/bt-arm/raw/main/install.sh && sudo bash bt-arm.sh
• 安装完成后，终端会输出类似 http://192.168.x.x:8888 的地址、用户名和初始密码，请立即记录

该脚本内部已硬编码 ARCH=aarch64，且依赖包全部来自 ARM64 兼容源，绕开了官方脚本中易出错的自动判别逻辑。

手动指定架构参数让官方脚本“勉强可用”

如果你坚持用官方脚本（例如想保持更新通道一致），必须强制它走 ARM64 分支：

• 先设环境变量：export BT_ARCH=aarch64
• 再运行官方命令：curl -sSO https://download.bt.cn/install/install_panel.sh && sudo bash install_panel.sh

注意两点：

• 这个 BT_ARCH 变量只在当前 shell 有效，不能写进 /etc/environment —— 宝塔服务启动时不读它
• 即使成功安装，后续通过面板「软件商店」安装 Nginx、PHP 等组件时，仍可能因插件未同步 ARM64 版本而失败；建议安装后立刻检查 /www/server/panel/install 下各组件的 arch 字段是否为 aarch64

为什么不用 Docker 方案？

有人提议用 docker pull arm64v8/nginx 搭个轻量 WebUI 替代宝塔，这确实能跑，但本质是绕开问题：它不等于「安装宝塔面板」，只是用别的工具模拟部分功能。如果你需要的是宝塔的「一键部署」、「数据库管理」、「SSL 申请」、「防火墙图形配置」等完整能力，Docker 容器无法替代面板主程序 bt 的核心调度逻辑。

真正容易被忽略的点是：ARM64 支持从宝塔 v7.9.0 开始才稳定，但仅限内核 ≥5.4 的系统。树莓派 Bookworm 默认内核是 6.1+，Bullseye 是 5.10+，都满足；而旧版 Buster（内核 5.4 以下）即使架构正确，也可能在 systemctl start bt 阶段静默退出——此时得看 /tmp/panelBoot.pl 日志里有没有 Failed to mmap /proc/self/exe 类错误，那是内核 ABI 不兼容的典型表现。