宝塔面板可在树莓派Raspberry Pi OS上安装，但需适配旧版Buster系统或使用定制镜像；推荐方案为烧录2020-08-24-raspios-buster-arm64-lite镜像，更换阿里云APT源，再执行带ed8484bec参数的ARM64专用安装脚本。
宝塔面板可在树莓派Raspberry Pi OS上安装，但存在系统版本兼容性限制。官方未正式适配所有Raspberry Pi OS发行版，部分64位新版本（如2023年后发布的bullseye或bookworm）在执行标准安装脚本时会因依赖缺失、架构识别异常或Python环境不匹配而中断。以下是可行的安装路径与对应适配方案：
一、使用兼容性验证过的旧版Raspberry Pi OS（推荐）
该方法基于已实测成功的系统镜像，规避新版内核与宝塔安装脚本的兼容冲突。核心在于锁定Debian Buster基础环境，确保apt源、Python 3.7+及systemd服务行为与宝塔Ubuntu/Debian安装逻辑一致。
1、下载并烧录指定镜像：2020-08-24-raspios-buster-arm64-lite.zip（来自https://downloads.raspberrypi.org/raspios_arm64/images/raspios_arm64-2020-08-24/）。
2、首次启动后启用SSH：在boot分区新建空文件名为ssh。
3、通过SSH登录，默认用户为pi，密码为raspberry。
4、切换至root用户并设置密码：sudo passwd root，按提示输入两次新密码。
5、执行重启：sudo reboot。
二、更换国内APT源并更新系统基础组件
树莓派默认源响应慢且可能缺失关键签名，导致apt update失败或安装包校验错误，进而中断宝塔依赖安装流程。更换为阿里云或清华源可确保deb包完整拉取与gpg密钥自动导入。
1、编辑主源列表：sudo nano /etc/apt/sources.list。
2、清空原内容，粘贴以下阿里云Bullseye源配置：
deb https://mirrors.aliyun.com/debian/bullseye main non-free contrib
deb-src https://mirrors.aliyun.com/debian/bullseye main non-free contrib
deb https://mirrors.aliyun.com/debian-security/bullseye-security main
deb-src https://mirrors.aliyun.com/debian-security/bullseye-security main
deb https://mirrors.aliyun.com/debian/bullseye-updates main non-free contrib
deb-src https://mirrors.aliyun.com/debian/bullseye-updates main non-free contrib
deb https://mirrors.aliyun.com/debian/bullseye-backports main non-free contrib
deb-src https://mirrors.aliyun.com/debian/bullseye-backports main non-free contrib
3、保存退出（Ctrl+O → Enter → Ctrl+X）。
4、编辑树莓派专属源：sudo nano /etc/apt/sources.list.d/raspi.list。
5、替换为：deb http://mirrors.aliyun.com/raspberrypi/ buster main ui。
6、执行更新：sudo apt-get update && sudo apt-get upgrade -y。
三、采用适配ARM64架构的宝塔安装脚本
官方通用install-ubuntu_6.0.sh在树莓派ARM64环境下可能跳过关键架构检测，导致Nginx或PHP模块编译失败。必须使用带明确aarch64支持标识的安装命令，或强制指定Python解释器路径以绕过版本误判。
1、以root身份登录终端。
2、执行安装命令（任选其一）：
选项A（推荐）：wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh ed8484bec。
选项B（备用）：wget -O install.sh http://download.bt.cn/install/install-ubuntu.sh && sudo bash install.sh。
3、安装过程中若提示“是否继续”，输入y并回车。
4、等待完成，终端将输出包含IP地址、端口、用户名及初始密码的访问信息。
四、使用预集成宝塔的定制系统镜像
该方式跳过手动安装环节，直接加载已预装宝塔面板的Raspberry Pi OS镜像，适用于无网络环境或对Linux命令不熟悉的操作者。镜像内部已完成服务注册、端口开放与开机自启配置，首次启动即进入可用状态。
1、下载镜像：bt-7.2.0-py3-buster-aarch64.tar.xz（解压后获得img文件）。
2、使用Raspberry Pi Imager或BalenaEtcher烧录至SD卡或SSD。
3、插入树莓派启动，等待约3分钟完成初始化。
4、SSH连接后执行：sudo bt default，获取面板地址与凭证。
5、在局域网浏览器中访问显示的IP加端口（如http://192.168.1.100:8888）。
