Fqzlrのblog

环境要求#

• Node.js 22.12 或更高：去 nodejs.org 下载 LTS 版本，装完用 node -v 验证
• pnpm 9：推荐用 corepack 启用（Node 自带，不用另装）：corepack enable
• 一个 GitHub 账号（用于存放代码与内容仓库）

路线一：克隆主题源码（推荐折腾党）#

适合想深度定制、参与主题开发的人，本站就是这么跑的。

1
git clone https://github.com/LyraVoid/Shirone.git my-blog
2
cd my-blog
3
pnpm install
4
pnpm dev

打开 http://localhost:4321 就能看到带示例内容的完整站点。常用脚本还有：

1
pnpm build    # 构建静态站点到 dist/
2
pnpm preview  # 本地预览构建产物
3
npx astro check   # .astro 文件类型检查

路线二：安装 npm 包（推荐省心党）#

适合只想写文章、不碰主题源码的人。在一个空目录里：

1
pnpm init
2
pnpm install shirones
3
pnpm exec shirone init

init 命令会生成 astro.config.mjs、最小配置目录和内容骨架，之后同样用 pnpm dev 启动。主题升级只需 pnpm update shirones，你的配置和内容完全不受影响。

内容与配置分离（双仓模式）#

Shirone 官方提供 Shirone-Content 内容模板仓库，把”文章 + 媒体 + 配置覆盖”放进独立仓库。这是本站采用的模式：

1. Fork 或克隆 Shirone-Content 到自己的账号下（建议设为私有，毕竟里面的草稿和友链数据是你自己的）
2. 在主题仓库根目录创建 shirone.content.json，指向你的内容仓：

1
{
2
  "source": {
3
    "type": "git",
4
    "remote": "https://github.com/你的用户名/你的内容仓.git",
5
    "branch": "main"
6
  }
7
}

3. 运行 pnpm content:sync，内容会被物化到主题的 src/content/、src/data/ 等目录
4. pnpm content:status 检查连接状态，pnpm content:validate 校验内容合法性

1
CONTENT_DIR=../my-content

部署#

pnpm build 产出的 dist/ 是纯静态文件，扔到哪都能跑：

• Vercel / Netlify：导入 GitHub 仓库，构建命令 pnpm build，输出目录 dist，之后 push 即自动部署
• Cloudflare Pages：同样支持，注意 Node 版本选 22+
• 自己的服务器：nginx 指向 dist/ 目录即可

装完之后#

站点能跑起来只是开始。接下来建议按顺序做三件事：改站点身份（标题、头像、社交链接），删掉示例文章换成自己的内容，然后配置导航和侧栏。这些正是后面两篇文章的主题——设置篇和使用篇，见本站分类目录。