This article records how www.sphererapids.com moved from an empty host entry to a static blog.
Project Overview
Astro builds the pages and content collections, Markdown frontmatter stores article metadata, C++ tools validate content and generate the search index, and OpenResty serves static files only.
The site is meant to be a low-maintenance, high-performance personal interests record for project notes, reading fragments, experiments, RSS, search index data, and static content publishing.
Structure
The runtime layer is OpenResty managed by 1Panel. Astro generates HTML, RSS, and sitemap at build time. content-check validates frontmatter, and search-index converts the manifest into a search index.
After publishing, the server returns static files only, keeping runtime dependencies low.
Caching
HTML uses short caching, while hashed CSS, JavaScript, images, and fonts use long immutable caching.
location ~* \.(css|js|webp|woff2)$ {
add_header Cache-Control "public, max-age=31536000, immutable";
}