第 11 期 · 2026-11-11
awesome-selfhosted/awesome-selfhosted — 自托管软件的十年总目录
第 11 期介绍的是自托管领域的总目录:awesome-selfhosted,一份从 2015 年维护至今、收录 1,200 多个可自行部署的自由软件的清单。它本身几乎没有代码,却是自托管玩家人手一份的“地图”——想搭什么服务,先来这里查。
一句话定位
一份只收自由软件的自托管应用总目录:95 个分类、1,269 个条目,每个条目都标明许可证、部署方式和源码地址,帮你把“云端订阅”换成“自己服务器上跑的服务”。
源码结构
这是一份清单型仓库,实测拉下来的内容出人意料地小:浅克隆只有 624K、35 个文件,其中真正的内容文件只有 4 个:
README.md:330,821 字节、2,372 行,清单本体non-free.md:28,205 字节、395 行,非自由软件分册LICENSE:21,581 字节,清单本身采用 CC-BY-SA-3.0_static/awesome.png:Awesome 系列徽章图
其余是 .github/ 下的两份模板:PR 模板只有一句话——“不要在这里提 PR,去 awesome-selfhosted-data 仓库”;Issue 模板也指向数据仓库。这揭示了本仓库最关键的结构事实:README.md 是机器生成的构建产物,不是手写文件。最新一次提交信息就是 [bot] build markdown from awesome-selfhosted-data d9b5eb9。
分类本身也在演进:95 个分类里既有 2015 年就有的邮件、Wiki、CMS,也有新近出现的“生成式人工智能(GenAI)”分类——清单跟着自托管领域的热点走,而不是一份定稿后只做加法。
真正的事实来源是姊妹仓库 awesome-selfhosted-data(Star 1,219,创建于 2021-06-27):software/ 目录下 1,360 个 YAML 文件,一个软件一个文件;tags/ 95 个分类定义;platforms/ 35 种语言与部署平台定义。每个软件的 YAML 字段固定:名称、官网、描述、许可证、平台、分类、源码地址、演示地址、图标地址,以及由机器人每天更新的 Star 数、最近更新时间、是否归档、最新发布版本和近 12 个月的逐月提交数。例如 2FAuth 的 YAML 里就记录了它 2026 年 6 月有 104 次提交、当前版本 v9.0.1。
架构图
flowchart TD
A[贡献者提交 YAML] --> B[awesome-selfhosted-data 数据仓库]
B --> C[hecat 构建工具]
C --> D[awesome-selfhosted 清单仓库 README]
C --> E[awesome-selfhosted-html 网站 awesome-selfhosted.net]
B --> F[每日定时任务]
F --> G[死链检查]
F --> H[无人维护检查]
F --> I[元数据更新 Star 版本 提交数]
D --> J[读者按分类选软件]
E --> J
分层设计说明
这套系统分四层,职责很干净:
- 数据层:awesome-selfhosted-data 仓库,一软件一 YAML 文件,字段结构化,机器可读。分类(tag)和平台(platform)也是独立的 YAML 定义,改分类不用动条目。
- 构建层:hecat 工具(nodiscc/hecat 1.8.0)加 Makefile,
make export_markdown生成清单仓库的 README,make export_html生成网站。构建用部署密钥(deploy key)把产物推到另外两个仓库。 - 呈现层:两个产物各司其职。README 顶部明确写着“HTML 版(推荐),Markdown 版(legacy)”——网站带搜索和筛选,Markdown 版只是兼容旧习惯的导出物。
- 治理层:三个每天 22:22 UTC 定时跑的工作流——死链检查、无人维护项目检查、元数据更新(Star 数、版本、提交历史)。另有
pull-request.yml和awesome_lint做投稿校验。条目的图标也不存在仓库里,而是统一走 jsDelivr 上的 homarr-labs/dashboard-icons 图标库,靠icon_url字段引用——清单仓库因此可以一直保持 624K 的轻量体量。
值得注意的是,清单仓库本身的 GitHub API 显示 open issues 为 0:讨论和投稿全部发生在数据仓库,主仓库只保留构建产物,干净得像个发布目录。
技术亮点
亮点一:把“清单”做成数据库,而不是文档。 很多 Awesome 清单就是一个越写越长的 Markdown,改格式要全文搜索替换。这里一软件一 YAML,字段全部结构化,于是能长出 Markdown 版没有的能力:网站可以按许可证、语言、分类筛选;每个条目能自动带上实时 Star 数和 12 个月提交曲线;死链和“无人维护”可以由机器人每天自动巡检。代价是贡献门槛变高——投稿者要按 YAML 字段填表、过 lint,而不是随手加一行 Markdown;但对 1,360 个条目的规模来说,这是唯一能长期维持质量的做法。实测数字:README 里 2,952 个 Markdown 链接,靠人工根本巡检不过来,只能靠自动化。
亮点二:用机器人对抗清单的自然腐烂。 清单类项目最大的敌人是链接失效和项目停更。这个项目把两件事都交给了定时任务:每天检查死链,每天检查无人维护的项目(结合 YAML 里的 archived 字段和提交历史判断),每天刷新各项目的 Star 数和版本。README 里有 70 处 ⚠ 标记,含义在“Anti-features”一节里写明:依赖用户无法控制的专有服务。换句话说,清单不仅收录,还持续给每个条目做“健康体检”并把结果标在条目上。适用边界也很清楚:这些检查只能发现“链接死了”“半年没提交”,发现不了“项目换了许可证”或“演示站挂了但官网还在”这类语义问题。
值得参考的设计或实现
- 一源多端:同一份 YAML 数据同时生成 Markdown 清单和网站,两个产物永不手工改写,改数据只改一处。做任何“清单/目录/导航站”类项目都可以照搬这个模式。
- 条目格式即契约:每个条目固定为“名称 — 一句话描述(演示、源码链接)+ 许可证 + 部署方式”,例如
- [GoatCounter](https://www.goatcounter.com) - Easy web statistics without tracking of personal data. ([Source Code](https://github.com/arp242/goatcounter))EUPL-1.2Go``。格式统一到可以被程序解析,人才敢放心地做自动化。 - 许可证当作一等信息:README 末尾附了一份带 SPDX 链接的许可证总表;条目里的许可证标签直接决定它进主清单还是 non-free 分册(后者 38 个分类、95 条)。“只收自由软件”这条收录红线,是用数据结构而不是用口头约定来执行的。
- 投稿治理写进模板和自动回复:数据仓库的 CONTRIBUTING.md 里有“Curation(策展)”“什么不合格”“罐头回复”几节,包括“没有打过 tag 的发布不收”“首次发布不到 4 个月不收”。清单质量不靠维护者记忆,靠成文规则加机器人执行。
- 分类即产品:95 个分类里既有“邮件完整方案 / 邮件投递代理 / 邮件传输代理 / 邮件列表”这种按技术角色的细分,也有“社区支持农业(CSA)”“族谱”这种长尾分类;每个分类开头还有一句维基式定义和“相关分类”交叉引用。分类体系本身就是一份自托管领域的知识地图。
适合谁
- 想把服务从云端搬回自己服务器的人:先按分类找,再按许可证和部署方式筛。
- 刚有一台 VPS 或 NAS、不知道能拿它干什么的人:从 Miscellaneous(74 条,最多)、CMS(41 条)、社交网络与论坛(40 条)这三个大类逛起。
- 关注隐私、想摆脱 SaaS 订阅的人:清单只收自由软件,且
⚠标记会提醒你哪些条目还依赖外部专有服务。 - 想做自己领域的 Awesome 清单的人:它的“数据仓库 + 生成器 + 定时巡检”是一套可以直接抄走的工程方案。
怎么上手
- 先上网站版 awesome-selfhosted.net(推荐,带搜索和筛选),或直接读 GitHub 清单。
- 按分类定位需求,比如想自建统计就看 Analytics(30 条),想搭笔记看 Note-taking & Editors,想换掉网盘看 File Transfer & Synchronization。
- 读条目三要素:许可证标签(MIT、AGPL-3.0、GPL-3.0 占前三,分别是 355、309、229 条)、平台标签(带
Docker的有 745 条,带K8S的 72 条)、有没有 Demo 链接(383 条带在线演示)。 - 点进源码仓库确认最近更新时间再部署——清单每天更新元数据,但部署前自己看一眼发布记录永远不亏。
- 想贡献:不要给清单仓库提 PR,去 awesome-selfhosted-data 仓库按 CONTRIBUTING.md 加一个 YAML 文件。
数据卡
- 仓库:awesome-selfhosted/awesome-selfhosted
- 网站:awesome-selfhosted.net
- 数据仓库:awesome-selfhosted/awesome-selfhosted-data
- Star:335,825(实时,2026-11-11)
- Fork:15,797
- 关注者:3,384
- 主要语言:无(清单仓库;数据仓库为 YAML)
- 许可证:清单本身 CC-BY-SA-3.0(GitHub API 显示 NOASSERTION)
- 创建时间:2015-06-01
- 最近更新:2026-11-10
- Atlas 分类:学习资源与Awesome
- Atlas 领域:软件开发
- 清单体量:README 330,821 字节、2,372 行,95 个分类、1,269 个条目(另 non-free 分册 38 个分类、95 条)