Astro Ink部署指南Vercel上SSR还是纯静态4步转换法彻底讲明白【免费下载链接】astro-inkCrisp, minimal, personal blog theme for Astro项目地址: https://gitcode.com/gh_mirrors/as/astro-inkAstro Ink 是一款专为个人博客打造的极简 Astro 主题模板。很多新手在部署时都会困惑到底该选 Vercel 上的 SSR服务端渲染还是更简单的纯静态托管本文用 4 步转换法把这个问题彻底讲明白帮你根据自己的需求快速完成 Astro Ink 部署。先搞清楚Astro Ink 为什么默认是 SSR打开项目根目录的 astro.config.mjs 文件你会看到两个关键配置第 20 行output: server—— 声明本项目以服务端渲染模式构建第 55 行adapter: vercel()—— 接入 Vercel 官方适配器天然支持一键部署到 Vercel之所以默认 SSR是因为主题内置了两个依赖服务端的能力文章浏览量统计src/pages/api/blog/views/[slug].json.ts中有一个 API 路由配合 Redisioredis或 Turso 数据库为每篇文章提供动态的浏览计数功能Decap CMS 管理后台通过/admin路径即可在网页上写文章、改文章省去本地编辑 Markdown 的麻烦 简单记忆你需要在线看文章数据、在线写文章 → 选 SSR只想把博客发出去 → 选纯静态。SSR vs 纯静态一张表帮你做决定对比项SSR默认纯静态部署平台Vercel / Netlify Functions任意静态托管GitHub Pages、Cloudflare Pages 等浏览量统计✅ 支持需配 Redis/Turso❌ 需移除CMS 在线写文章✅ 支持部分受限访问速度极快极快CDN 直出最快成本有 Serverless 用量基本免费配置难度需配置环境变量最简单开箱即用新手建议如果你只是想快速拥有一个漂亮的个人博客纯静态是更省心的选择3 分钟搞定如果你想要浏览量统计或在线编辑文章保留默认的 SSR 即可。4 步转换法从 SSR 切换到纯静态构建整个过程只涉及两个文件的改动跟着做就行第 1 步修改 output 为 static打开 astro.config.mjs将第 20 行的output: server改为output: static。第 2 步移除 Vercel 适配器删除同文件第 55 行的adapter: vercel()连同第 8 行的 vercel 导入语句一起删除。没有适配器构建产物就是纯 HTML 文件可以扔到任何静态托管平台。第 3 步删除浏览量统计 API删除src/pages/api/blog/views/[slug].json.ts文件。静态模式下不存在 API 路由保留它会导致构建报错。相关的数据库实现位于src/utils/views/目录包含 in-memory、ioredis、turso 三种方案静态模式下同样用不到。第 4 步关闭浏览量统计开关打开 src/config.ts将第 58 行的USE_VIEW_STATS true改为false页面上就不会再发起浏览量请求。完成以上 4 步后运行npm run build构建产物输出到dist/目录直接把dist/交给任意静态托管平台即可。Vercel 部署要点保留 SSR 时如果你决定保留默认的 SSR 模式部署前还需要注意环境变量配置。参考根目录的 .env.example需要准备的变量有SITE_URI你的站点地址OAUTH_GITHUB_CLIENT_ID/OAUTH_GITHUB_CLIENT_SECRETCMS 后台的 OAuth 凭据REDIS_URI或TURSO_DB_URLTURSO_DB_AUTH_TOKEN浏览量统计的数据库连接在 Vercel 控制台的项目设置中配置好这些环境变量后连接你的代码仓库Vercel 会自动识别 Astro 项目并完成部署。本地开发时先把.env.example复制为.env并填入SITE_URIhttp://localhost:4321即可。常见问题Q纯静态模式下还能用深色模式、客户端搜索吗可以。这些功能全部由前端实现Svelte 组件 Lunr.js 搜索索引构建时由scripts/search/prepare-index.js生成与 SSR 无关。Q以后想从静态切回 SSR 怎么办把上面 4 步逆向操作即可恢复output: server、加回adapter: vercel()、恢复 API 文件和USE_VIEW_STATS true。总结Astro Ink 部署的核心决策只有一个要不要浏览量统计和在线 CMS。要就用默认的 SSR Vercel 适配器配置环境变量即可不要就按本文的 4 步转换法改为纯静态享受最快的访问速度和最简单的部署流程。两种方式都很快选对适合自己的那一个你的个人博客就能在几分钟内上线 【免费下载链接】astro-inkCrisp, minimal, personal blog theme for Astro项目地址: https://gitcode.com/gh_mirrors/as/astro-ink创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
