树莓派安装宝塔面板需绕过x86/x64限制，可选四种方法：一、用社区ARM镜像快速部署；二、手动编译ARM64核心服务；三、Docker运行轻量替代方案；四、旧版5.9降级适配ARMHF。
如果您尝试在树莓派等ARM架构的小型硬件上安装宝塔面板，但安装脚本报错或面板无法启动，则可能是由于宝塔官方安装脚本默认仅适配x86/x64架构的Linux服务器。以下是适用于树莓派（Raspberry Pi OS，基于Debian ARM64/ARMHF）的多种可行安装路径：
一、使用社区维护的ARM兼容版宝塔镜像
该方法直接采用已编译适配ARM架构的宝塔二进制文件与依赖包，避免源码编译风险，适合大多数树莓派用户快速部署。
1、确保系统为Raspberry Pi OS 64-bit（推荐Bullseye或Bookworm），执行uname -m确认输出为aarch64或armv7l。
2、更新系统并安装必要依赖：sudo apt update && sudo apt install -y curl wget vim python3 python3-pip。
3、下载并运行ARM适配版安装脚本（由非官方但广泛验证的社区项目提供）：curl -o bt-arm.sh http://github.com/kevintangcn/bt-arm/raw/main/install.sh && sudo bash bt-arm.sh。
4、等待安装完成，终端将输出面板登录地址、用户名与初始密码（请立即记录）。
二、手动构建并安装宝塔核心服务（适用于ARM64）
该方法绕过官方脚本限制，通过本地编译关键组件（如bt-panel、nginx-arm64、pure-ftpd-arm）实现可控部署，适合具备基础Linux编译能力的用户。
1、克隆ARM优化版宝塔核心仓库：git clone https://github.com/kevintangcn/bt-panel.git && cd bt-panel。
2、执行编译准备脚本：sudo python3 tools.py build，该过程将自动下载ARM适配的Nginx源码并打补丁。
3、安装面板主体：sudo python3 tools.py install，脚本会检测架构并调用make ARCH=arm64编译。
4、启动服务：sudo systemctl start bt，验证状态：sudo systemctl is-active bt应返回active。
三、通过Docker容器运行轻量宝塔替代方案（LAMP+WebUI）
该方法不直接安装宝塔，而是利用Docker在树莓派上运行功能相近的可视化运维环境（如aaPanel轻量版或自定义LNMP容器），规避架构兼容性问题。
1、安装Docker及docker-compose：curl -sSL https://get.docker.com | sh && sudo usermod -aG docker pi，重启终端生效。
2、拉取已预编译ARM64镜像：docker pull arm64v8/nginx:alpine && docker pull arm64v8/php:8.2-apache。
3、创建docker-compose.yml，集成phpMyAdmin与Web控制台，端口映射至8888。
4、执行docker-compose up -d后，浏览器访问http://树莓派IP:8888即可进入管理界面。
四、降级使用宝塔5.9旧版本（仅限ARMHF系统）
宝塔5.9系列曾部分支持ARMHF（32位树莓派OS），虽功能受限且停止更新，但在老旧Pi 3B等设备上仍可稳定运行基础站点管理。
1、切换至Raspberry Pi OS Legacy（32-bit，Buster），确认uname -m输出为armv7l。
2、下载旧版安装包：wget http://download.bt.cn/install/install-ubuntu_5.9.sh。
3、修改脚本中架构检测逻辑：将if [ "$is64bit" = "true" ]替换为if [ "1" = "1" ]以跳过x86强制检查。
4、执行安装：sudo bash install-ubuntu_5.9.sh，安装完成后需手动替换/www/server/panel/class/common.py中的SSL校验段落以启用HTTPS支持。
