芯耀
与非AI
150
多年来我一直手动配置 Linux 服务器，于是很好奇 YunoHost 究竟能实现什么功能。它仅需几分钟就能将一台树莓派搭建为自建私有服务器，一键部署 WordPress、Nextcloud、Jellyfin 等各类应用。
YunoHost 是一套专为自建私有服务打造的 Linux 发行版。将其安装到树莓派后，你无需逐个手动配置服务，只需通过网页管理面板就能部署、管理所有应用。
本文将完整演示：在树莓派上安装 YunoHost、完成初始化配置、分三步部署第一个应用。
YunoHost 简介
想在树莓派上架设 WordPress 网站这类应用，传统流程繁琐复杂：要完成系统安装、服务配置，再把应用部署到内网或公网，全程难题不断。
YunoHost 的核心作用就是简化整套流程：它基于 Debian 系统打造，提供一站式平台，所有应用均可一键安装、一键上线。
YunoHost 相对小众，设计思路也很独特：你可以把它理解成应用容器管理器，每一款应用都会独立隔离运行。
了解完 YunoHost 是什么，我们正式开始实操教程。安装前先核对软硬件所需条件。
软硬件要求
想要跟着教程完成搭建，你需要准备以下设备：
硬件：
树莓派主板：YunoHost 现已支持树莓派 5、树莓派 4、树莓派 3
Micro SD 卡或 U 盘：二选一即可，存储空间至少 16GB，系统镜像文件超 7GB
有线网线：本教程全程使用有线以太网连接家庭局域网
键鼠显示器（可选）：若无网线、无法配置 WiFi 时，可外接显示器键鼠，在系统桌面完成初始化
软件：
YunoHost 树莓派专用镜像（下文会说明下载方式）
烧录工具：树莓派官方烧录工具 Raspberry Pi Imager 或 Balena Etcher，任选其一，我整理了完整的树莓派烧录工具使用指南，有需要可以查看。
条件准备完毕，开始安装流程。
树莓派安装配置 YunoHost 完整教程
本节分步讲解树莓派部署 YunoHost 全流程，本次演示使用树莓派 4。
下载 YunoHost 系统镜像
第一步下载适配树莓派的最新 YunoHost 镜像，全程不超过 5 分钟：
打开 YunoHost官方安装页面，页面会列出全部支持硬件，硬件分类选择”Raspberry Pi”
https://yunohost.org/en/install下滑找到”Download the YunoHost Image”下载区域，点击下载按钮（版本号会持续更新） 本次教程使用镜像版本：12.0.16
注意：树莓派 Zero、一代、二代操作流程不同，这三款机型需先安装树莓派官方系统，再参考对应教程部署 YunoHost。
将镜像烧录至存储卡
电脑下载好镜像压缩包后，使用 Raspberry Pi Imager 烧录到 SD 卡：
启动Raspberry PiImager，并进行以下选择。
设备–选择您的树莓派(例如，Pi 5、Pi 4或Pi 3)。
操作系统–向下滚动到列表底部，并选择使用自定义。
在弹窗选中刚下载的镜像文件（文件名类似 yunohost-bookworm-12.0.16-rpi-stable.img.gz，无需解压，直接使用压缩包）
存储设备：选中 SD 卡 / U 盘，务必确认盘符无误，工具会清空所选磁盘全部数据
自定义设置：默认跳过即可
点击「写入」，启动烧录流程
等待数分钟烧录完成，弹出提示后拔出存储卡，插入树莓派。
首次开机初始化
存储卡就绪后按以下步骤操作：
将 SD 卡插入树莓派
接通电源开机
插上网线，有线连接家庭路由器
若无网线，可外接显示器键鼠操作；也能配置 WiFi，开启 SSH 远程登录。
提示：有线网络配置远比 WiFi 简单。如果只能用无线，可查阅《Debian 系统 WiFi 配置教程》文末命令。
https://raspberrytips.com/configure-wifi-debian/硬件连接正常后，局域网内任意设备均可访问地址：http://yunohost.local 访问失败则直接输入树莓派局域网 IP 地址。
首次打开页面会弹出隐私安全警告，属于正常现象，点击「高级」→「继续访问」，进入 YunoHost 后台。
同意服务条款，点击“开始配置”。
设置域名（自有域名 / 免费域名 / 本地测试域名三选一）
配置第一步为服务器绑定域名：
提供三种方案：
使用自己已购买的域名（通常付费）
申请 YunoHost 项目提供的免费二级域名
保留本地内网测试域名
选择第二种免费域名会展开弹窗，填写自定义域名与找回密码（用于域名丢失找回），其余解析、证书工作由 YunoHost 自动处理。
填写完成点击底部“下一步”，进入管理员账号创建页面。
创建管理员账号
弹窗填写用户名、全名、登录密码（遵循页面密码规范），完成后点击“下一步”。
填写表格(遵循密码指南)并单击“下一步”继续。
在开始后安装过程(创建我们的新域、新用户并进行设置)之前，您会收到一条警告:
按OK按钮，安装后过程将开始。请耐心等待，因为这需要几分钟才能完成。部署完成后会跳转登录界面，使用刚才创建的管理员账号密码登录。
至此，整套系统初始化全部完成！接下来我们熟悉管理后台。
管理后台初览
登录后你会看到全套后台管理功能：用户管理、多域名管理、应用商店、系统维护（系统更新、工具套件等），操作界面简单易上手。
重点讲解两大核心模块：用户管理、域名管理。
用户管理
管理员可在「用户」面板管理服务器内所有账号，账号分为两类：
管理员账号：拥有全部权限，可管理普通用户、应用、域名
普通用户：由管理员创建，仅能访问管理员分配权限的应用
后台可实现操作：
1.查看全部用户列表：点击账号可编辑信息、调整权限、删除账号
2.用户搜索栏：适合多账号场景，快速筛选目标用户
3.新建用户；支持跨服务器导入 / 导出用户数据，迁移服务器时非常方便
4.用户分组与权限管控：可将家人等用户归类分组，单独或批量分配各应用访问权限
域名管理
域名相当于所有应用的访问入口，后台可绑定多个域名，支持同一服务器不同域名指向不同应用。
您可以选择将同一服务器上的两个不同的域重定向到不同的应用程序。参考下面的图片，更好地理解我的意思:
主屏幕上的域选项卡下提供了域管理选项。
从上面的快照中可以看出，您可以添加一个新域或更改现有域的配置。
配置域是一个非常复杂的主题，需要大量的网络知识，所以我们现在跳过这一部分。请记住，如果您感兴趣并且是高级用户，您可以使用该选项(查看本文了解更多详细信息)。
https://raspberrytips.com/install-no-ip-raspberry-pi/系统更新
和所有操作系统一样，定期更新核心组件是保障服务器安全稳定的关键。YunoHost 后台提供可视化更新面板： 主菜单进入「系统更新」，点击底部「升级全部软件包」，更新完成建议重启服务器。
同时该面板也能统一管理所有应用更新，保证自建应用始终运行最新安全版本。后台功能介绍完毕，下面实操部署第一款自建应用。
使用 YunoHost 搭建第一个自建应用
本次教程选用 WordPress 搭建个人博客，你也可以按需选择其他应用。
应用安装：WordPress
后台一键安装应用流程：
首先进入管理界面主页，然后切换至应用程序选项卡。
页面会刷新跳转，你将看到当前已安装的全部应用。点击页面右上角的「安装应用」按钮。
页面会展示 YunoHost 提供的应用商店目录。你可以在当前界面任选一款可用应用。这里以 WordPress 为例，在搜索框输入 “WordPress”，待应用条目出现后点击选中它。
页面将跳转至待安装应用的详情页面。建议你先浏览页面信息，了解该应用相关说明，随后滚动至页面底部，填写并完成安装配置项。
大部分选项保持默认设置即可。我仅将应用标识修改为 “PersonalBlog”，其余参数均维持原样。
最后点击安装按钮，系统将开始部署该应用。安装耗时取决于所选应用，整个过程可能需要几分钟。
应用安装完成后，你就能在「应用」选项卡的已安装应用列表中看到它。恭喜！你已经借助 YunoHost 完成第一款应用的安装与部署（没错，它已经可以直接访问使用了！）。
现在，让我们看看如何访问我们的WordPress博客。
访问应用的方式
管理员、普通用户、外网访客拥有不同访问渠道：
选项1:通过管理界面(Admins)
选项2:通过用户界面(用户)
选项3:通过应用程序URL(访问者)
现在让我们来探讨一下每个选项。
方式 1：管理员后台直达（管理员专用）
打开「应用」面板，点击 WordPress 程序卡片，右上角点击「打开应用」。
新窗口进入博客页面，默认搭载 YunoHost 预设模板
方式2：用户面板访问（普通授权用户）
如果您创建了一个用户并允许其访问该应用程序，他们可以通过YunoHost提供的交互式用户界面来访问该应用程序。要访问它，请单击管理界面中的蓝色用户界面按钮。
这将打开您的个性化用户界面。或者，您甚至可以输入您的基本域，它将打开用户界面登录屏幕，您可以在其中使用您的凭据登录到您的用户界面页面。
要访问一个应用程序，点击应用程序窗格(在这种情况下是WordPress网站)。
这将在一个新窗口中打开您的博客页面。和以前一样，你会看到一个由YunoHost开发者创建的预创建模板站点。
方式 3：公网链接访问（外网访客）
最后，如果你想让你的博客对公众开放，你需要一个任何人都可以访问你的网站的链接。这通常被称为您的应用程序URL。它将采用以下格式:“https://<您的域>/<路径>”(路径是您在应用程序安装期间配置的)。
本次示例地址：https://rpitips.nohost.me/blog
任意浏览器打开链接即可浏览博客。
本教程到此结束。你已经掌握极简流程，通过 YunoHost 在树莓派上自建各类网络应用。YunoHost 还有更多高阶功能，感兴趣推荐查阅官方完整文档。
https://doc.yunohost.org/admin/
