Raspberry Pi自动接入点（autoAP）安装与配置指南

一、项目基础介绍

autoAP是一个开源项目，旨在将Raspberry Pi在没有连接到已知WiFi网络时自动转换为接入点（AP）。该项目适用于需要在外出时通过其他设备配置或使用Raspberry Pi的场景。autoAP基于轻量级设计，易于安装，且不需要额外的软件依赖。项目的主要编程语言是Shell脚本。

二、项目使用的关键技术和框架

autoAP使用的关键技术包括：

• systemd-networkd：用于网络配置的守护进程。
• hostapd：用于创建和管理接入点的守护进程（尽管autoAP本身不是基于hostapd的）。
• wpa_supplicant：用于WiFi客户端连接的守护进程。

三、项目安装和配置准备工作

在开始安装autoAP之前，请确保您的Raspberry Pi满足以下条件：

1. 运行的是Raspbian Buster或更新版本的操作系统。
2. 已连接到以太网或已配置好的WiFi网络，以便下载必要的安装文件。
3. 具有sudo权限的用户账户。

安装步骤

1. 下载安装脚本

   打开终端，使用curl命令下载以下三个脚本文件到/usr/local/bin目录下：

   sudo curl -L https://github.com/gitbls/autoAP/raw/master/autoAP.sh -o /usr/local/bin/autoAP.sh
   sudo curl -L https://github.com/gitbls/autoAP/raw/master/install-autoAP -o /usr/local/bin/install-autoAP
   sudo curl -L https://github.com/gitbls/autoAP/raw/master/rpi-networkconfig -o /usr/local/bin/rpi-networkconfig
   

2. 设置文件权限

   为下载的脚本文件设置执行权限：

   sudo chmod 755 /usr/local/bin/autoAP.sh /usr/local/bin/install-autoAP /usr/local/bin/rpi-networkconfig
   

3. 运行安装脚本

   运行install-autoAP脚本来配置autoAP：

   sudo /usr/local/bin/install-autoAP
   

   安装脚本会提示您输入接入点的SSID和密码，同时也会尝试从现有的/etc/wpa_supplicant/wpa_supplicant.conf或/etc/wpa_supplicant/wpa_supplicant-wlan0.conf文件中获取当前的WiFi配置信息。

4. 配置网络

   如果系统中未启用systemd-networkd，安装脚本会提醒您启用它。您可以通过以下命令切换到systemd-networkd：

   sudo /usr/local/bin/rpi-networkconfig
   

   此命令会帮助您进行网络配置，确保以太网设备使用DHCP，并设置WiFi设备。

5. 重启系统

   完成安装和配置后，重启Raspberry Pi以应用所有更改：

   sudo reboot
   

安装完成后，autoAP将根据配置自动在无法连接到已知WiFi网络时启动接入点模式。如果您需要手动启用或禁用该服务，可以使用以下命令：

• 启用服务：

  sudo systemctl enable wpa-autoap@wlan0
  

• 禁用服务：

  sudo systemctl disable wpa-autoap@wlan0
  

确保在修改服务状态后重启系统以使更改生效。