如何部署kaz-blog

功能特性

• Notion 作为主内容源，支持本地 Markdown 回退
• Markdown 渲染基于 remark + remark-gfm + remark-html
• 支持用户注册、登录、多作者写作与作者管理
• 支持归档、友链、标签、搜索、说说、相册、关于页、评论（Twikoo）
• 支持明暗主题切换
• 自动生成 Atom、Sitemap、Robots
• 支持部署到 EdgeOne Page

适用场景

• 想要使用基础的线上写作与内容管理功能的个人/多用户博客
• 需要多作者写作、基础后台和轻量管理能力的内容站点
• 希望部署在 EdgeOne Page 上

快速开始

生产部署目前支持 EdgeOne Page，本地开发与调试可正常进行。

一键部署

您可以通过 腾讯云 EdgeOne Pages 一键部署。

直接点击此按钮一键部署：

查看 腾讯云 EdgeOne Pages 文档 了解更多详情。

之后，你需要

• 创建一个 KV 空间，用于储存用户信息，变量名称设置为 AUTH_KV

• 创建 Notion 数据库

• 在新建的数据库中添加以下属性（属性名称可自定义，但类型必须对应）：
• Slug（文本）
• Published（复选框）
• Date（日期）
• Description（文本）
• Author（文本）
• Keywords（多选）
• Cover（网址）
• 创建新的内部集成，关联的工作空间选择之前创建数据库的工作空间并给予数据库访问权限

• 复制数据库 ID 和集成 Token，分别填入环境变量 NOTION_DATABASE_ID 和 NOTION_TOKEN
• 当前数据库网址格式为 https://www.notion.so/[Page ID]?v=[View ID]，其中 Page ID 即为 NOTION_DATABASE_ID
• 进入刚建立的内部集成，其中的内部 API 集成密钥即为 NOTION_TOKEN
• 如你想开启上传本地图片的功能，需要去 7bu 图床 注册账号并获取 token，填入环境变量 IMAGE_HOST_TOKEN

更多环境变量详见 .env.example里的说明

本地调试

• 克隆项目

git clone https://github.com/jeoor/kaz-blog.git

• 进入项目目录

cd kaz-blog

• 安装依赖

npm install

• 复制 .env.example 为 .env.local并配置必要的环境变量，或者直接在部署平台的环境变量设置中添加：

cp .env.example .env.local

• 启动开发服务器

npm run dev

• 或构建生产版本

npm run build && npm run start

• 访问 http://localhost:3000 查看站点

配置

站点信息配置

在 site-config.ts 配置站点基础信息

目前关于页和友链页还未支持直接链接数据库编辑，仍需要在content/about.md和content/links.config.ts中编辑🙏

环境变量

详见 .env.example 里的注释说明。下面列出最常用配置：

项目结构

• app/: App Router 页面、布局、路由与元信息（含 sitemap/robots/atom）
• components/: 复用 UI 组件（布局、文章、评论、相册、说说等）
• lib/: 内容加载与适配层（Notion、本地回退）及通用工具
• cloud-functions/cfapi/: EdgeOne Cloud Functions（管理 API、会话与文章管理）
• content/: 本地内容与配置（about、links、photos、shuoshuo、posts 回退）
• public/: 站点静态资源
• scripts/: 辅助脚本（如 Notion 配置检查）
• site-config.ts: 站点信息与导航等全局配置
• edgeone.json: EdgeOne Pages/Functions 部署配置

当前能力

• Notion 主内容源 + 本地回退
• 基础 md 渲染
• 多作者注册/登录
• 发布、加载、删除文章
• 归档、标签、搜索
• 说说、相册、文章线上配置
• 代码高亮与 Lightbox
• 搜索功能
• 本地图片上传至图床
• 文章封面功能
• Atom Feed、Sitemap、Robots
• twikoo 评论系统
• 明暗主题切换
• EdgeOne Page 部署
• 网站设置线上配置
• 关于页线上配置
• 友链线上配置

内容来源优先级

1. Notion Database
2. content/posts/*.md 本地回退

常用命令

• npm run notion:check 检查 Notion 配置
• npm run dev: 本地开发
• npm run dev:stable: 稳定启动
• npm run clean: 清理 .next 缓存
• npm run lint: 代码检查
• npm run build: 生产构建
• npm run start: 生产启动

许可证

MIT