基于 Astro 的个人博客模板,代码以 MIT 许可发布
hydrogen-astro — Astro 博客模板
作者 statichunt
Hydrogen 是一个基于 Astro 的免费个人博客模板,采用 MIT 许可,提供联系表单、评论、相关文章、MDX 与分类页等博客常用功能。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置联系表单、Disqus 评论与相关文章推荐
支持 MDX 与多个内置自定义组件
提供分类(Taxonomy)页面与 Astro Image 图片优化
生成 llms.txt、llms-full.txt 及逐页 .md 文档
包含全部 SCSS 文件,支持自定义 Logo
模板详细介绍
Hydrogen 是 statichunt 发布的 Astro 个人博客模板,定位为极简且可自定义,适合搭建个人博客站点。仓库以 MIT 许可开放代码,演示站与截图可在 statichunt 主题页查看。
功能层面,模板包含联系表单、Google Tag Manager 集成、Disqus 评论、相关文章推荐、分类(Taxonomy)页面,以及基于 Astro Image 的图片优化;内容支持 MDX,并内置多个自定义组件,同时生成 llms.txt、llms-full.txt 和逐页 .md 等面向 LLM 的文档。样式方面提供全部 SCSS 文件,支持自定义 Logo,并使用语义化 HTML 结构。
使用上需要先安装 Node.js,随后通过 npm install 安装依赖、npm run dev 本地运行、npm run build 生成生产构建。模板预配置了基于 Git 的无头 CMS Sitepins,可通过其克隆入口可视化编辑文本、图片与配置。
限制方面,代码采用 MIT 许可,但演示图片等第三方素材有各自许可,仓库未获授权分享这些图片;域名、托管等外部服务可能另行收费。README 中的 PageSpeed 100% 属于模板方声明,本介绍未做核实。
适合你的项目吗?
适用场景
- 搭建个人博客并发布图文或 MDX 文章
- 为博客接入 Disqus 评论与相关文章推荐
- 通过分类页面组织不同主题的文章
- 使用 Sitepins 可视化编辑站点文本、图片与配置
适合人群
- 希望用 Astro 搭建个人博客的开发者
- 需要 MDX 写作与自定义组件能力的写作者
- 偏好通过 Git 仓库管理内容并可选接入无头 CMS 的用户
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
需先安装 Node.js,建议使用 LTS 版本
- 2
在项目目录执行 npm install 安装依赖
- 3
执行 npm run dev 本地预览,npm run build 生成生产构建
- 4
模板预配置 Sitepins,可通过其克隆入口进行可视化内容编辑
- 5
演示图片等第三方素材需按各自许可核对,不能沿用代码的 MIT 许可
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 演示图片等素材有各自许可,仓库未获授权分享,不能沿用代码的 MIT 许可,需自行核对并替换。
- 可视化内容编辑依赖第三方 Sitepins 无头 CMS 服务,需注册账号并可能产生外部服务费用。
- 联系表单需自行配置后端或第三方表单服务才能实际接收提交。
- Google Tag Manager 集成需自行提供 GTM 容器 ID 等外部账号配置。
- Disqus 评论需注册 Disqus 账号并配置站点短名方可启用。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
README 原文
This template comes pre-configured with [**Sitepins**](https://sitepins.com), a Git-based Headless CMS designed for seamless content management.
README 原文
- Supports Contact Form
README 原文
- Google Tag Manager Integrated
README 原文
https://github.com/statichunt/hydrogen-astro/blob/main/LICENSEhttps://github.com/statichunt/hydrogen-astro/blob/main/README.md- Disqus Comment Support
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-03。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 87 / 100
- 技术栈
- Astro
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-07-09
- 截图检查日期
- 2026-10-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: be94997de1ecbb639ab5ccd6c4377642d0f2c9d808adc3215f7e1aa51247b7c0
2026-10-03T04:44:46.924Z
来源文件 / 仓库<h1 align=center>Hydrogen Astro</h1>
<p align=center>Hydrogen is a minimal & highly customizable free Astro personal blog template ideal for creating personal blog website.
</p>
<h2 align="center"> <a target="_blank" href="https://hydrogen-astro.vercel.app/" rel="nofollow">👀Demo</a> | <a target="_blank" href="https://pagespeed.web.dev/report?url=https%3A%2F%2Fhydrogen-astro.vercel.app%2F&form_factor=desktop">Page Speed (100%)🚀</a>
</h2>
<p align=center>
<a href="https://github.com/withastro/astro/releases/tag/astro%406.3.1" alt="Contributors">
<img src="https://img.shields.io/static/v1?label=ASTRO&message=6.3&color=000&logo=astro" />
</a>
<a href="https://github.com/statichunt/hydrogen-astro/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/statichunt/hydrogen-astro" alt="license"></a>
<img src="https://img.shields.io/github/languages/code-size/statichunt/hydrogen-astro" alt="code size">
<a href="https://github.com/statichunt/hydrogen-astro/graphs/contributors">
<img src="https://img.shields.io/github/contributors/statichunt/hydrogen-astro" alt="contributors"></a>
</p>

## Key Features
- Supports Contact Form
- Google Tag Manager Integrated
- LLM-ready docs generation (llms.txt, llms-full.txt, and per-page .md)
- Disqus Comment Support
- Related Posts Suggestion
- MDX Support with many built-in custom components
- Semantic HTML Document Structure
- Custom Logo Support
- Includes All SCSS Files
- Taxonomy Page Support
- Images Optimized With Astro-Image
<!-- installation -->
## Installation
After downloading the template, you have some prerequisites to install. Then you can run it on your localhost. You can view the package.json file to see which scripts are included.
### Install prerequisites (once for a machine)
- **Node Installation:** [Install node js](https://nodejs.org/en/download/) [Recommended LTS version]
### Local setup
After successfully installing those dependencies, open this template with any IDE [[VS Code](https://code.visualstudio.com/) recommended], and then open the internal terminal of IDM [vs code shortcut <code>ctrl/cmd+\`</code>]
- Install dependencies
```
npm install
```
- Run locally
```
npm run dev
```
After that, it will open up a preview of the template in your default browser, watch for changes to source files, and live-reload the browser when changes are saved.
## Production Build
After finishing all the customization, you can create a production build by running this command.
```
npm run build
```
<!-- edit with sitepins -->
## 📝 Edit Content with CMS
This template comes pre-configured with [**Sitepins**](https://sitepins.com), a Git-based Headless CMS designed for seamless content management. You can update your website’s text, images, and configuration without touching a single line of code.
**How to get started:**
Click the Edit with Sitepins button below and follow the on-screen instructions to start editing your content visually.
<a target="_blank" href="https://app.sitepins.com/new/clone?name=Hydrogen%20Astro&repository=https://github.com/statichunt/hydrogen-astro/">
<img src="https://sitepins.com/button.svg" alt="Edit with Sitepins">
</a>
<!-- reporting issue -->
## Reporting Issues
We use GitHub Issues as the official bug tracker for this Template. Please Search [existing issues](https://github.com/statichunt/hydrogen-astro/issues). It’s possible someone has already reported the same problem.
If your problem or idea has not been addressed yet, feel free to [open a new issue](https://github.com/statichunt/hydrogen-astro/issues).
<!-- licence -->
## License
Copyright (c) 2024 - Present, Designed & Developed by [statichunt](https://statichunt.com)
**Code License:** Released under the [MIT](https://github.com/statichunt/hydrogen-astro/blob/main/LICENSE) license.
**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

astrowind
⭕️ AstroWind: A free template using Astro v7 and Tailwind CSS v4. Astro starter theme.
Astro · 博客

astro-paper
A minimal, accessible and SEO-friendly Astro blog theme.
Astro · 博客

fuwari
✨A static blog template built with Astro.
Astro · 博客

Firefly
Firefly 是一款基于 Astro 的静态博客主题,由 CuteLeaf 在 saicaca 的 Fuwari 模板基础上二次开发,主打清新美观的视觉风格。
Astro · 博客

astro-theme-cactus
A simple Astro theme. Use it to create your blog or website.
Astro · 作品集

astrofy
Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…
Astro · 作品集
