宝塔面板在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></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 仍偶发插件加载失败,这点容易被忽略。











