RaspAP 是功能丰富的无线路由器软件，适用于许多流行的基于 Debian 的设备，包括 Raspberry Pi。我们流行的快速安装程序和Docker 容器为所有当前具有板载无线功能的 Raspberry Pi 创建了一个已知良好的默认配置。完全响应式、移动就绪的界面使您可以控制相关服务和网络选项。包括高级 DHCP 设置、WireGuard 和 OpenVPN 支持、SSL 证书、安全审核、强制门户集成、主题和多语言选项。
RaspAP 已在Instructables、Adafruit、Raspberry Pi Weekly和Awesome Raspberry Pi等网站上得到推荐，并在无数项目中实施。
我们希望您像我们创建 RaspAP 一样喜欢使用 RaspAP。告诉我们您如何在自己的项目中使用它。
- 先决条件
- 快速安装程序
- 加入业内人士
- WireGuard 支持
- OpenVPN 支持
- VPN 提供商支持
- 广告拦截
- 桥接接入点
- 同时 AP 和 Wifi 客户端
- 手动安装
- 802.11ac 5GHz 支持
- 支持的操作系统
- HTTPS 支持
- Docker 支持
- 多语言支持
- 如何贡献
- 报告问题
- 执照
从全新安装最新版本的 Raspberry Pi OS Lite开始。支持 32 位和 64 位 Lite 版本。 Raspberry Pi OS 桌面发行版不受支持。
- 更新 Raspbian，包括内核和固件，然后重新启动：
sudo apt-get update
sudo apt-get full-upgrade
sudo reboot
-
在本地化选项
raspi-config中设置“WLAN国家”选项：sudo raspi-config -
如果您的设备没有板载无线芯片组，Edimax 无线 802.11b/g/n 纳米 USB 适配器是一个绝佳的选择 - 它体积小、价格便宜并且具有良好的驱动程序支持。
满足先决条件后，您可以继续执行下面的快速安装程序或手动安装步骤。
从设备的 shell 提示符中安装 RaspAP：
curl -sL https://install.raspap.com | bash安装程序将为您完成手动安装（如下）中的步骤。
安装结束重新启动后，无线网络将被配置为接入点，如下所示：
- IP地址：10.3.141.1
- 用户名： 管理员
- 密码：秘密
- DHCP 范围：10.3.141.50 — 10.3.141.254
- 服务集标识符：
raspi-webgui - 密码： 更改我
注意：顾名思义，快速安装程序是快速设置新 AP 的好方法。但是，它不会自动检测系统的独特配置。通过使用 .连接到以太网 ( eth0) 或作为 WiFi 客户端（也称为托管模式）可以获得最佳结果wlan0。对于后者，请参阅此常见问题解答。有关 Pi Zero W 的特别说明可在此处获取。
请在报告问题之前阅读本文。
RaspAP 是免费软件，但需要您的支持。如果您发现 RaspAP 对您的个人或商业项目有用，请成为 Insider并尽早访问Insiders Edition中的独家功能。
赞助的一个切实的附带好处是内部人士能够帮助引导 RaspAP 的未来发展。这是通过内部人员团队访问私有 GitHub 存储库中的讨论、功能请求、问题等来完成的。
WireGuard® 是一种极其简单但快速且现代化的 VPN，采用最先进的加密技术。它的目标是比 OpenVPN 具有更高的性能，并且通常被认为是现代 Linux 发行版中最安全、最易于使用且最简单的 VPN 解决方案。
WireGuard 可以选择通过快速安装程序进行安装。完成此操作后，您可以管理本地（服务器）设置、创建对等配置并wg-quick使用 RaspAP 控制服务。
此处提供了详细信息。
OpenVPN 可以选择通过快速安装程序进行安装。完成此操作后，您可以使用 RaspAP管理客户端配置和openvpn-client服务。
要配置 OpenVPN 客户端，请上传有效的 .ovpn 文件，并可以选择指定您的登录凭据。 RaspAP 将存储您的客户端配置并添加防火墙规则，以将流量从 OpenVPNtun0接口转发到您配置的无线接口。
请参阅我们的OpenVPN 文档以获取更多信息。
一些流行的 VPN 提供商包括用于与其服务交互的 Linux 命令行界面 (CLI)。作为一项新的测试版功能，您可以选择从 RaspAP 内控制这些 VPN 服务。在您的系统上安装提供商的 CLI 后，您可以使用 RaspAP 的 UI 对其进行管理。
有关更多信息，请参阅我们的VPN 提供商文档。
此功能使用 DNS 黑名单来阻止对广告、跟踪器和其他不良主机的请求。要启用广告拦截，只需在安装过程中响应提示即可。作为测试版，我们鼓励 RaspAP 用户进行测试并提供反馈。
此处提供了详细信息。
默认情况下，RaspAP 会配置一个路由 AP 供您的客户端连接。桥接 AP 配置也是可能的。在配置热点的高级选项卡下滑动桥接 AP 模式开关，然后保存并重新启动热点。
注意：在桥接模式下，所有路由功能均由上游路由器处理。由于您的路由器将 IP 地址分配给设备的热点及其客户端，因此您可能无法从默认地址访问 RaspAP Web 界面10.3.141.1。而是使用 RPi 的主机名，后跟.local访问 RaspAP Web 界面。使用 Raspbian 默认设置，这应该看起来像raspberrypi.local.这里讨论替代方法。
我们的文档中提供了有关桥接 AP 模式的更多信息。
RaspAP 允许您创建具有 Wifi 客户端配置的 AP，通常称为AP-STA 模式。将系统配置为托管模式后，通过滑动Wifi 客户端 AP 模式开关，从配置热点的高级选项卡启用 AP 。保存设置并启动热点。管理模式 AP 无需重启即可正常工作。
注意：在您将系统配置为无线客户端之前，此选项将被禁用。对于在没有连接的受管模式下运行的设备，必须在重新启动之前eth0启用此配置。
我们的文档网站上提供了详细的手动设置说明。
RaspAP 为支持的硬件（当前为 RPi 3B+/4 和兼容的 Orange Pi 型号）和无线监管域提供 802.11ac 无线模式选项。请参阅此了解更多信息。
RaspAP 最初是为 Raspbian 制作的，但现在也安装在以下基于 Debian 的发行版上。
| 分配 | 发布 | 建筑学 | 支持 |
|---|---|---|---|
| 树莓派操作系统 | （64 位）精简版书虫 | 手臂 | 官方的 |
| 树莓派操作系统 | （32 位）Lite Bookworm | 手臂 | 官方的 |
| 树莓派操作系统 | （64 位）精简版 Bullseye | 手臂 | 官方的 |
| 树莓派操作系统 | （32 位）精简版 Bullseye | 手臂 | 官方的 |
| 阿姆比安 | 23.11（杰米） | 手臂 | 官方的 |
| 德班 | 书呆子 | ARM/x86_64 | 贝塔 |
| 乌班图 | 服务器 23.04（农历） | ARM/x86_64 | 贝塔 |
我们还鼓励您使用 RaspAP 社区主导的Docker 容器。请注意，“支持”并不是保证。如果您能够改善对您喜欢的发行版的支持，我们鼓励您积极为该项目做出贡献。
快速安装程序可用于生成带有mkcert.安装程序会自动执行此处描述的手动步骤，包括配置具有 SSL 支持的 lighttpd。
只需将-c或--cert选项附加到快速安装程序中，如下所示：
curl -sL https://install.raspap.com | bash -s -- --cert注意：这只会安装 mkcert 并使用您提供的输入生成 SSL 证书。它不会（重新）安装 RaspAP。
有关 SSL 证书和 HTTPS 支持的更多信息，请参阅我们的文档。
作为快速安装程序的替代方案，RaspAP 可以在隔离的便携式Docker 容器中运行。
有关更多信息，请参阅RaspAP-docker 存储库。
RaspAP 使用GNU Gettext来管理多语言消息。为了将 RaspAP 与我们支持的翻译之一一起使用，您必须在 RPi 上配置相应的语言包。要列出系统上当前安装的语言，请locale -a在 shell 提示符下使用。要生成新的区域设置，请运行sudo dpkg-reconfigure locales并选择任何其他所需的区域设置。我们的文档网站上提供了详细信息。
请参阅由志愿者翻译人员积极维护的受支持语言列表。如果您的语言不受支持，为什么不贡献翻译呢？贡献者将获得作为原始翻译者的荣誉。
- 在您的帐户中分叉该项目并创建一个新分支：
your-great-feature。 - 在存储库中打开一个问题，描述您想要做出的功能贡献。
- 在您的功能分支中提交更改。
- 打开拉取请求并在拉取请求消息中引用初始问题。
了解有关我们的编码风格指南和推荐工具的更多信息。
请在报告错误之前阅读本文。
这个项目的存在要感谢所有贡献时间和专业知识的杰出人士。
由于赞助软件发布模型，RaspAP 的开发成为可能。这意味着新功能首先作为Insiders的一部分独家发布给赞助商。
详细了解赞助的运作方式以及如何轻松接触 Insider。
请参阅许可证文件。