Self-Hosting-Guide

mikeroyal/Self-Hosting-Guide — GitHub 明星级自托管知识百科全书，588KB 单文件 README 覆盖 30+ 技术领域。

一款让极客欲罢不能的运维百科全书

想象一下：深夜里，你的家庭服务器突然宕机，Nextcloud 无法访问，WireGuard VPN 也断了。你翻遍了 Stack Overflow、CSDN、知乎，却越查越迷糊——每个教程的路径都不一样，每个人的配置都仅供参考。这时，如果你 star 了这个仓库，只需要 Ctrl+F 搜索 Nextcloud 或 WireGuard，就能找到一份结构严谨、持续更新的操作指南，从安装到排错一站式搞定。

这就是 mikeroyal/Self-Hosting-Guide——GitHub 上最大的自托管软件知识库之一，截至 2025 年已积累 20,946 个 Star，被全球极客、家庭服务器爱好者、IT 运维人员广泛引用。

图1：项目首页 Banner，展示 Self-Hosting 全景生态

这个仓库到底是什么

严格来说，这不是一个代码项目，而是一份用 Markdown 写成的活体技术百科全书。

项目作者 mikeroyal（GitHub ID: 45159366）从 2021 年开始维护这份指南，至今已更新至 2024 年。README.md 文件本身就有 588KB，包含超过 56 个二级章节，覆盖了自托管领域的几乎所有主流技术方向：

领域	包含内容
容器化	Docker、Podman、容器编排
网络与安全	WireGuard VPN、Tailscale、pfSense、OpenWRT
私有云存储	Nextcloud、MinIO、Backblaze B2
数据库	PostgreSQL、MongoDB、Redis、SQL/NoSQL 全系列
监控运维	Grafana、Prometheus、Zabbix、ELK Stack
Home Automation	Home Assistant、ESPHome、Homebridge、Zigbee2MQTT
AI 与大模型	Ollama、llama.cpp、LocalAI、GPT4All、text-generation-webui、OpenLLM
LLMOps	vLLM、LangChain、Yeager AI Agent、OpenLLM
DevOps 工具链	Ansible、Kubernetes、Helm、Terraform
树莓派生态	全系列 Raspberry Pi 操作系统、工具与升级方案

这份指南不是简单的链接收藏——每个工具词条都附有作者亲自撰写的功能描述、安装步骤、使用场景说明，以及多个工具的对比分析。

图2：AI/ML 工具章节内容，涵盖从训练框架到本地大模型部署的全栈工具

为什么它是 AI 领域的宝藏

尽管项目被归类为 Dockerfile 语言仓库（因为 Dockerfile 用于将 README 转换为 PDF），但它在 AI/ML 自托管 领域的实用价值远超多数纯代码仓库。

本地大模型（Local LLM）章节是这个项目最令人惊喜的部分。它不是泛泛推荐几个工具，而是系统性地收录了几乎所有主流本地大模型部署方案：

• ollama：一键安装运行 Llama 2/3、Gemma、Mistral 等模型，项目作者专门写了与 Home Assistant 的集成方法
• llama.cpp / llama2.c：C/C++ 原生实现，CPU 可跑，适合低配置设备
• LocalAI：OpenAI API 兼容层，在消费级硬件上跑 GGML 模型，无需 GPU
• GPT4All：Nomic AI 维护的生态，聚合多个开源聊天模型
• text-generation-webui（oobabooga）：最流行的 Web UI，支持 transformers、GPTQ、GGML/GGUF
• OpenLLM：BentoML 出品的生产级 LLM Serving 平台
• Yeager AI Agent：基于 LangChain 的 AI Agent 创建工具

此外还有 ML 框架章节，覆盖 TensorFlow、PyTorch、MXNet、ONNX、AutoGluon，以及 数据处理与可视化工具：Jupyter Notebook、Apache Spark、Apache Airflow。

图3：DevOps 与监控工具章节截图，展示 Grafana 等工具的配置指南

知识库的组织哲学

这份指南的编写方式非常值得称道。不同于大多数 awesome-list 的链接堆砌，mikeroyal 的每个章节都遵循统一结构：

1. 概念定义：先用一段文字解释这个技术是什么，解决什么问题
2. 工具列表：每个工具附链接 + 作者亲写的功能描述
3. 学习资源：配套的书籍、播客、YouTube 频道
4. 实操指南：针对树莓派、Linux 等特定平台的详细操作步骤

这使得它既可以作为入门者的系统教科书，也可以作为老手的速查手册。

局限性与使用建议

需要诚实地指出几个局限性：

① 更新节奏依赖作者个人时间。虽然维护日志显示持续更新（2024 年仍有活跃维护），但作为个人项目，在快速迭代的 AI 领域，部分工具描述可能滞后于最新版本。

② 没有互动式搜索。588KB 的单文件在 GitHub 上浏览效率不高，推荐 clone 后用本地编辑器（VSCode + Markdown All in One）的 Ctrl+P 搜索，或配合 Raycast/Alfred 做全文检索。

③ 部分章节深度有限。像 Kubernetes、Ansible 等复杂领域，指南只能点到为止，详细学习仍需参考官方文档和专项教程。

但瑕不掩瑜——对于任何想要系统掌握自托管技术栈的人，这个仓库是 GitHub 上性价比最高的起点之一。

行业意义

mikeroyal/Self-Hosting-Guide 的走红，折射了一个更大的趋势：去中心化自托管的复兴。

2023-2024 年，随着隐私焦虑、订阅费涨价、AI 监管趋严，越来越多的人开始把数据和服务从云端收回来。Nextcloud、Immich、Paperless-ngx、Ollama……这些工具不再只是极客玩具，而是普通用户也会接触的数字基础设施。

mikeroyal 的指南恰好填补了系统化中文自托管教育资源的空白——而 GitHub 作为全球最大的开发者知识库，让这份指南触达了英语世界之外的广大用户群体。

快速上手

# 克隆仓库
git clone https://github.com/mikeroyal/Self-Hosting-Guide.git
cd Self-Hosting-Guide

# VSCode 打开，利用 Ctrl+P 快速搜索
code .

# 或使用项目自带的 Dockerfile 导出 PDF：
docker build -f "Getting Started  with Self-Hosting.dockerfile" .

最常用的方式是直接在 GitHub 页面搜索关键词，或 clone 到本地配合 IDE 使用。项目配套的 Dockerfile 仅用于生成 PDF 版本，不提供任何运行服务。

总结

维度	评分
内容广度	★★★★★（30+ 技术领域全覆盖）
内容深度	★★★☆☆（入门到中级，高级内容需配合专项文档）
维护活跃度	★★★★☆（2024 年持续更新）
实用性	★★★★★（即查即用，工具描述质量高）
AI 领域价值	★★★★★（Local LLM 工具链收录极为全面）

如果你关注 AI 自托管（本地大模型部署）、Home Automation、或任何形式的私有化部署，这个仓库值得加入你的 GitHub Star 列表。