schematrix/HAS_Prepper_Disk

项目介绍

这个项目把一套离线知识库打包到树莓派 5 上：底层运行 Internet-in-a-Box 和 Kiwix，由树莓派提供维基百科、地图、医疗参考和维修指南，并通过自带热点让手机或电脑在浏览器中访问。仓库本身提供的不是服务端平台，而是硬件清单、安装脚本、SSD 配置脚本、内容下载脚本、Internet-in-a-Box 配置覆盖和自定义首页（项目说明）。

它适合在无网络或不稳定网络环境下需要一套自包含参考资料、并且熟悉 Linux 命令行和树莓派硬件的人。

硬件与准备

按文档需要：树莓派 5（4 GB 或 8 GB）、带 256 GB 以上 NVMe SSD 的 M.2 HAT、32 GB 以上 microSD 卡（装系统）、5V/5A USB-C 电源、主动散热器，以及安装期间建议使用的网线（硬件清单）。

快速使用

1. 用 Raspberry Pi Imager 刷写 Raspberry Pi OS Lite（64-bit），在设置中开启 SSH 并设定用户名和密码。插上 SSD 启动，用网线连接路由器。
2. 更新系统、安装 Git、克隆仓库并给脚本加执行权限：

sudo apt update && sudo apt full-upgrade -y
sudo apt install -y git
git clone https://github.com/schematrix/HAS_Prepper_Disk.git
cd HAS_Prepper_Disk
chmod +x install.sh scripts/*.sh

3. 用 lsblk 找到 SSD 设备名（通常是 nvme0n1），把它挂载到 /library：

sudo ./scripts/setup-ssd.sh /dev/nvme0n1

非 ext4 磁盘会被格式化，脚本执行前会询问确认（SSD 步骤）。

4. 运行安装脚本，按提示输入 Wi-Fi 名称和密码，随后安装 Internet-in-a-Box，约需 30–60 分钟。若中途重启或安装中断，重新执行同一命令即可从断点继续（安装步骤）：

sudo ./install.sh

5. 编辑 config/content.conf 选择要下载的内容，然后运行脚本。默认列表约 150 GB，下载可能持续数小时；中断后重跑会续传（内容下载）：

sudo ./scripts/download-content.sh

6. 打开 http://<pi-ip>/admin（用户名 iiab-admin），在 Install Content 菜单的地图部分选择需要的区域。
7. 连接树莓派创建的热点，打开首页 http://box.lan/home。

使用约束与已知问题

整套方案面向树莓派 5，内容需要存放在独立的 NVMe 存储上。板载 Wi-Fi 专用于热点；若需要临时上网，需另加一个 USB Wi-Fi 适配器，README 称 MediaTek MT7601U 芯片的适配器免配置即可使用，并警告适配器插着时不要运行 sudo iiab-network，否则热点可能被迁移到该适配器上（可选联网）。

安装后 Internet-in-a-Box 会把主机名改为 box，原来的 hostname.local SSH 地址会失效。Wi-Fi 密码必须是 8–63 个字符。地图服务器 contabostorage.com 在土耳其等国家被屏蔽，文档建议在树莓派上安装 Cloudflare WARP、连接后重试下载、完成后再断开（故障排查）。部分书籍合集依赖浏览器本地数据库，在 iPhone Safari 无痕标签页和强制门户弹窗中会一直加载，需要改用普通标签页。

仓库内脚本和首页使用 MIT 许可证，Internet-in-a-Box、Kiwix 及所有下载内容各自保留原有许可证，项目声明与二者无隶属关系（许可证）。

HotRepo 点评

在 2026-11-01 的新项目榜记录中，该项目在约两小时的观察窗口内从 114 星增至 148 星，当日新增 34 星、14 个 fork。这是单次快照，只能说明出现早期关注，尚无持续趋势，也未被记录到 GitHub 全语言日榜名次。它的实用价值主要集中在 Internet-in-a-Box 之上的具体组装说明和故障排查，尤其是主机名变更、网桥失效和地图下载受阻这些在无头树莓派上难以定位的问题。