README

RaspAP是一款功能丰富的无线路由器软件，它只需在许多流行的基于Debian的设备上运行，包括树莓派。我们的热门快速安装程序和Docker容器为所有具有内置无线网络的所有当前树莓派创建了已知良好的默认配置。一个完全响应式、移动友好的界面让您可以控制相关服务和网络选项。包括高级DHCP设置、WireGuard和OpenVPN支持、SSL证书、安全审计、门户集成、主题和多语言选项。

RaspAP已在Instructables、Adafruit、Raspberry Pi Weekly和Awesome Raspberry Pi等网站上展示，并在无数项目中实现。

我们希望您使用RaspAP的体验与我们创造它的体验一样愉快。告诉我们您如何使用自己的项目。

内容

• 先决条件
• 快速安装程序
• 加入内部人员
• WireGuard支持
• OpenVPN支持
• VPN提供商支持
• 广告拦截
• 桥接AP
• 同时AP和WiFi客户端
• 手动安装
• 802.11ac 5GHz支持
• 支持的操作系统
• HTTPS支持
• Docker支持
• 多语言支持
• 如何贡献
• 报告问题
• 许可

先决条件

从Raspberry Pi OS Lite最新版本的干净安装开始。支持32位和64位Lite版本。Raspberry Pi OS桌面发行版不受支持。

1. 更新Raspbian，包括内核和固件，然后重启

sudo apt-get update
sudo apt-get full-upgrade
sudo reboot

1. 在raspi-config的本地化选项中设置“WLAN国家”选项： sudo raspi-config

2. 如果您有一个没有内置无线芯片组的设备，那么Edimax无线802.11b/g/n纳米USB适配器是一个很好的选择——它小巧、便宜，并且有良好的驱动程序支持。

完成先决条件后，您可以按照下面的快速安装程序或手动安装步骤进行。

快速安装程序

从您的设备shell提示符安装RaspAP

curl -sL https://install.raspap.com | bash

安装程序将为您完成下面手动安装的步骤。

在安装结束后的重启后，无线网络将被配置为接入点，如下所示

• IP地址：10.3.141.1
  • 用户名：admin
  • 密码：secret
• DHCP地址范围：10.3.141.50 — 10.3.141.254
• SSID：raspi-webgui
• 密码：ChangeMe

注意：正如其名所示，快速安装程序是快速设置新的接入点的好方法。然而，它不能自动检测您系统的独特配置。通过连接到以太网（eth0）或作为WiFi客户端（也称为管理模式，使用wlan0），可以获得最佳结果。对于后者，请参阅此FAQ。Pi Zero W的特殊说明在这里。

在报告问题之前，请阅读此内容。

加入内部人员

RaspAP是免费软件，但它依赖于您的支持。如果您发现RaspAP对您的个人或商业项目有用，请成为内部人士，并提前获得独家功能，这些功能可在内部人士版中找到。

赞助的一个实际好处是，内部人士能够帮助引导RaspAP的未来发展。这是通过内部人士团队对私人GitHub仓库中的讨论、功能请求、问题等进行访问来完成的。

WireGuard支持

WireGuard®是一个非常简单但快速且现代的VPN，它利用最先进的加密技术。它旨在比OpenVPN性能好得多，并且通常被认为是现代Linux发行版中最安全、最容易使用、最简单的VPN解决方案。

WireGuard可以通过快速安装程序可选安装。完成后，您可以使用RaspAP管理本地（服务器）设置、创建对等配置并控制wg-quick服务。

详细信息在此提供。

OpenVPN支持

OpenVPN可以通过快速安装程序可选安装。完成后，您可以使用RaspAP管理客户端配置和openvpn-client服务。

要配置OpenVPN客户端，上传有效的.ovpn文件，并可选地指定您的登录凭证。RaspAP将存储您的客户端配置，并将防火墙规则添加到将来自OpenVPN的tun0接口的流量转发到您配置的无线接口。

有关更多信息，请参阅我们的OpenVPN文档。

VPN服务提供商支持

几个流行的VPN服务提供商包括Linux命令行界面（CLI），用于与其服务交互。作为一个新的beta功能，您可以选择在RaspAP内部控制这些VPN服务。在您的系统上安装了服务提供商的CLI后，您可以使用RaspAP的UI进行管理。

有关更多信息，请参阅我们的VPN服务提供商文档。

广告拦截

此功能使用DNS黑名单来阻止对广告、跟踪器和其他不希望的主机的请求。要启用广告拦截，只需在安装过程中响应提示即可。作为一个beta版本，我们鼓励RaspAP用户进行测试和反馈。

详细信息在此提供。

桥接AP

默认情况下，RaspAP为您的客户端配置了一个路由AP供其连接。也可以使用桥接AP配置。在“配置热点”中的“高级”选项卡下，滑动切换到“桥接AP模式”，然后保存并重启热点。

注意：在桥接模式下，所有路由功能都由您的上游路由器处理。由于您的路由器为您的设备热点及其客户端分配IP地址，您可能无法从默认地址10.3.141.1访问RaspAP网页界面。请使用您的RPi主机名后跟.local来访问RaspAP网页界面。在Raspbian默认设置中，这应该看起来像raspberrypi.local。其他方法请参阅这里。

关于桥接AP模式的更多信息，请参阅我们的文档。

同时AP和WiFi客户端

RaspAP允许您创建一个具有WiFi客户端配置的AP，通常称为AP-STA模式。将您的系统配置为管理模式后，通过在“配置热点”的“高级”选项卡中滑动切换到“WiFi客户端AP模式”来启用AP。保存设置并启动热点。管理模式AP无需重启即可正常工作。

注意：此选项在您将系统配置为无线客户端之前处于禁用状态。对于在无eth0连接的情况下以管理模式运行的设备，必须在重启之前启用此配置。

手动安装

详细的设置说明请参阅我们的文档网站。

802.11ac 5GHz支持

RaspAP为支持的硬件（目前为RPi 3B+/4和兼容的Orange Pi型号）以及无线监管域提供了802.11ac无线模式选项。更多信息请参阅这里。

支持的操作系统

RaspAP最初是为Raspbian制作的，但现在也可以安装到以下基于Debian的发行版上。

还鼓励您使用RaspAP由社区领导的Docker容器。请注意，“支持”并不保证。如果您能够改善您首选发行版的支持，我们鼓励您积极贡献到项目中。

HTTPS支持

快速安装程序可以使用mkcert生成SSL证书。安装程序自动化了此处描述的手动步骤，包括配置具有SSL支持的lighttpd。

只需将-c或--cert选项添加到快速安装程序中，例如

curl -sL https://install.raspap.com | bash -s -- --cert

注意：这只会安装mkcert并使用您提供的输入生成SSL证书。它不会（重新）安装RaspAP。

有关SSL证书和HTTPS支持的更多信息，请参阅我们的文档。

Docker支持

作为快速安装程序的替代方案，RaspAP可以在隔离的、可移植的Docker容器中运行。

有关更多信息，请参阅RaspAP-docker存储库。

多语言支持

RaspAP 使用 GNU Gettext 来管理多语言消息。为了使用我们支持的翻译之一，您必须在您的 RPi 上配置相应的语言包。要列出系统上当前安装的语言，请在 shell 提示符中使用 locale -a。要生成新的本地化，运行 sudo dpkg-reconfigure locales 并选择任何其他所需的本地化。详细信息请参阅我们的 文档网站。

查看这个列表，了解由志愿者维护的 支持的语言。如果您的语言不受支持，为什么不 贡献翻译？贡献者将获得原始翻译者的信用。

如何贡献

1. 在您的账户中分叉项目并创建一个新的分支：您的伟大功能。
2. 在仓库中打开一个问题，描述您想要做出的功能贡献。
3. 在功能分支中提交更改。
4. 打开一个 pull request，并在 pull request 消息中引用初始问题。

了解我们的 编码风格指南和推荐工具。

报告问题

在报告错误之前，请 阅读此内容。

贡献者

代码贡献者

这个项目得以存在，多亏了所有投入时间和专业知识的人 贡献。

财务贡献者

RaspAP 的发展得益于赞助软件发布模型。这意味着新功能首先作为 内部人士 的一部分独家发布给赞助商。

了解关于 赞助是如何工作的，以及如何轻松获得内部人士的访问权限。

许可

查看 LICENSE 文件。