本站网络与技术架构
欢迎来到树莓派中文文档网站！在这里，我们致力于为大家呈现基于树莓派的官方权威信息翻译与技术分享内容。为了充分彰显这一特色，整个网站的内容搭建均依托于 Raspberry Pi 来完成。Raspberry Pi 凭借其出色的性能与强大的功能，为我们提供了稳定且高效的运行环境。无论是各类树莓派使用教程、创意项目展示，还是技术探索心得，都从这一小小的设备上源源不断地传递给各位爱好者。我们希望通过这样的方式，让大家更真切地感受树莓派的魅力，也能在技术交流中共同进步。
网站架构
树莓派中文文档网站架构
服务器配置
公网服务器配置
- 系统：Ubuntu 24.04 LTS
- 核心：2核
- 内存：8G
- 网络：公有云 / BPG / 10Mbps上行、100Mbps下行
- IPv4情况：拥有独立IP
- IPv6情况：可拥有独立v6 IP，未开启
树莓派配置
- 硬件：Raspberry Pi 5
- 系统：Raspberry Pi OS Lite (bookworm)
- 核心：4核
- 内存：4G
- 网络：家庭宽带 / 300Mbps上行、1Gbps下行
- IPv4情况：拥有内网IP，不可提供http/https端口接入
- IPv6情况：拥有公网IP，不可提供http/https端口接入
网站备案
域名解析指向中国内地服务器，且网站需开通并对外提供Web服务时需要备案。域名解析指向非中国内地服务器（例如中国香港等非中国内地）不需要工信备案，仅需完成公安备案。
国内的家用宽带基本不允许进行网站备案，很多地区的家用宽带禁止了80/443端口。请不要在家用宽带上部署网站接入服务。
本站的部署模式是将树莓派作为置于家中的一个存储设备或是一个IoT设备，其网站接入仍然通过国内公有云服务器进行。因此，本站的网站接入服务办理了正常备案手续。
内网穿透
树莓派放置在家用宽带内，无法直接访问。因此，我们使用内网穿透的方式，将树莓派上的网站内容通过公网服务器进行访问。
frp 是一款高性能的反向代理应用，专注于内网穿透。它支持多种协议，包括 TCP、UDP、HTTP、HTTPS 等，并且具备 P2P 通信功能。使用 frp，您可以安全、便捷地将内网服务暴露到公网，通过拥有公网 IP 的节点进行中转。
通过 配置 frp，我们可以将树莓派上的网站内容通过公网服务器进行访问。具体配置方法请参考通过自定义域名访问内网的 Web 服务。
备用网页服务
备用网页服务是一个放置于公网服务器的静态网站，用于在树莓派无法访问时提供备用访问服务。当树莓派无法访问时，备用网页服务将作为树莓派网站的替代方案，提供网站访问服务。
树莓派 + 家用带宽 的稳定性、安全性、性能等各方面都远不及公有云。如果网站部署仅依赖于树莓派，一旦树莓派出现问题，那么网站将无法访问。而公有云则不同，即使树莓派出现问题，我们也可以通过公有云上的备用网页服务继续提供网站访问。
本站是以展现树莓派的能力为目标而搭建的，虽然网站可以全放在公有云服务器。但是，通过动手搭建可以更好地理解树莓派的应用能力，同时也能更好地掌握树莓派的使用方法。
ddns-go服务
ddns-go是一个基于go语言开发的DDNS服务，用于动态更新域名解析记录。通过树莓派上的ddns-go服务，将树莓派的IP地址动态更新到特定域名解析记录中，从而实现通过域名随时访问树莓派的目的。
近几年在相关部门的大力推广下，"网络去NAT"作为深化IPv6部署的重要举措之一，使家用宽带下的设备可以直接获取公网IPv6并从外部访问。在不涉及提供网站服务或开设其他需要前置审批的服务情况下，可结合DDNS+IPv6，进一步发挥设备的使用潜能。
中文翻译版以英文版相同知识授权方式共享：CC-BY-SA 4.0。交流 Q群：498908352