每日一仓

ONE OPEN-SOURCE REPO A DAY

每天 08:00 更新 数据来源 · Atlas 精选榜 2026 年 11 月 18 日

第 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 清单的人:它的“数据仓库 + 生成器 + 定时巡检”是一套可以直接抄走的工程方案。

怎么上手

  1. 先上网站版 awesome-selfhosted.net(推荐,带搜索和筛选),或直接读 GitHub 清单。
  2. 按分类定位需求,比如想自建统计就看 Analytics(30 条),想搭笔记看 Note-taking & Editors,想换掉网盘看 File Transfer & Synchronization。
  3. 读条目三要素:许可证标签(MIT、AGPL-3.0、GPL-3.0 占前三,分别是 355、309、229 条)、平台标签(带 Docker 的有 745 条,带 K8S 的 72 条)、有没有 Demo 链接(383 条带在线演示)。
  4. 点进源码仓库确认最近更新时间再部署——清单每天更新元数据,但部署前自己看一眼发布记录永远不亏。
  5. 想贡献:不要给清单仓库提 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 条)

← 返回仓库目录