GrtBlog v2

现代化博客系统 — 静态先行、实时注水、联合社交

GrtBlog 是一个面向创作者的博客系统，以纯静态 HTML 分发实现极致首屏速度，通过 WebSocket 实现毫秒级实时更新，并内置联合社交协议让博客不再是孤岛。

联合协议仍在内测和修复中，将在 v2.1.0 正式发布。 旧版已归档至 https://github.com/grtsinry43/grtblog-legacy

特性

• 极速加载 — 页面以纯静态 HTML 分发，首屏 < 0.5s，Go 后端宕机时 Nginx 仍可降级只读服务
• 实时更新 — WebSocket 驱动的内容热更新，修改文章后读者无需刷新即可看到最新内容
• 联合社交 — 自有联合协议 + ActivityPub 兼容，Mastodon 等 Fediverse 平台可关注你的博客
• 丰富内容 — 文章、手记 (Moments)、思考 (Thinking)、友链、时间线，满足多种表达需求
• 管理后台 — 美观且功能完备的 Vue 3 后台，Markdown 实时预览、评论管理、数据统计
• 一键部署 — Docker Compose 一键启动，多架构镜像 (amd64/arm64) 自动打包，方便拉取

截图

架构

                      ┌──────────┐
                      │  用户/CDN │
                      └────┬─────┘
                           │
                      ┌────▼─────┐
                      │  Nginx   │  静态文件优先，回退到 SSR
                      └────┬─────┘
                           │
             ┌─────────────┼─────────────┐
             │             │             │
       ┌─────▼─────┐ ┌────▼────┐ ┌──────▼──────┐
       │ 静态 HTML  │ │ Go API  │ │  Admin SPA  │
       │           │ │  :8080  │ │  (Vue 3)    │
       └───────────┘ └────┬────┘ └─────────────┘
                          │
             ┌────────────┼────────────┐
             │            │            │
       ┌─────▼─────┐ ┌───▼───┐ ┌──────▼──────┐
       │ PostgreSQL │ │ Redis │ │  SvelteKit  │
       │            │ │       │ │  Renderer   │
       └────────────┘ └───────┘ └─────────────┘

三个平面：

ISR (Incremental Static Regeneration)： 内容变更时，Go 后端计算受影响路径 → 请求 SvelteKit 渲染 → 原子写入静态文件 → WebSocket 广播实时更新。

技术栈

快速开始

使用预构建镜像部署（推荐）

一键安装（推荐）：

bash <(curl -fsSL https://raw.githubusercontent.com/grtsinry43/grtblog/main/deploy/install.sh)
# 国内：
bash <(curl -fsSL https://cnb.cool/grtsinry43/grtblog/-/git/raw/main/deploy/install.sh)

脚本会自动检测环境、选择镜像源、生成密钥、下载配置并启动服务。

# 创建部署目录
mkdir -p grtblog && cd grtblog

# 下载部署配置（国际）
BASE_URL="https://raw.githubusercontent.com/grtsinry43/grtblog/main"
# 国内加速：
# BASE_URL="https://cnb.cool/grtsinry43/grtblog/-/git/raw/main"
curl -fsSL "$BASE_URL/deploy/docker-compose.yml" -o docker-compose.yml
curl -fsSL "$BASE_URL/deploy/.env.example"       -o .env
mkdir -p nginx
curl -fsSL "$BASE_URL/deploy/nginx/nginx.conf"    -o nginx/nginx.conf

# 编辑 .env：设置 IMAGE_REPO_PREFIX、APP_VERSION、密码和密钥
#   IMAGE_REPO_PREFIX=ghcr.io/grtsinry43/
#   APP_VERSION=2.0.2              # 查看 Releases 页面获取最新版本
#   POSTGRES_PASSWORD=<强密码>
#   AUTH_SECRET=<openssl rand -hex 32>
# 国内服务器推荐使用 CNB 镜像源：
#   IMAGE_REPO_PREFIX=docker.cnb.cool/grtsinry43/grtblog/

# 启动
mkdir -p storage/html storage/uploads storage/geoip
docker compose up -d

首次启动会自动拉取镜像、运行数据库迁移。

• 博客首页: http://your-server-ip
• 管理后台: http://your-server-ip/admin/

本地构建部署

git clone https://github.com/grtsinry43/grtblog.git
# 国内加速：
# git clone https://cnb.cool/grtsinry43/grtblog.git
cd grtblog/deploy
cp .env.example .env
# 编辑 .env：设置密码和密钥（IMAGE_REPO_PREFIX 留空）

mkdir -p storage/html storage/uploads storage/geoip
docker compose up -d --build

详细部署说明见 部署文档。

升级

# 修改 .env 中的 APP_VERSION，然后：
docker compose pull server renderer
docker compose up -d server renderer

Nginx 无需重启，自动发现新容器。

本地开发

# 1. 后端
cd server && cp .env.example .env && make migrate-up && make run   # :8080

# 2. 管理后台
cd admin && pnpm i && pnpm dev   # :5799

# 3. 前台
cd web && pnpm i && pnpm dev     # :5173

详细开发说明见 CONTRIBUTING.md。

项目结构

grtblog-v2/
├── server/         # Go 后端（控制平面）
├── web/            # SvelteKit 前台（渲染平面）
├── admin/          # Vue 3 管理后台
├── shared/         # 前端共享代码（Markdown 组件等）
├── deploy/         # Docker Compose 部署配置
├── scripts/        # 工具脚本（发布、迁移等）
└── docs/           # 文档（VitePress）

文档

数据迁移（v1 -> v2）

已提供 API 迁移脚本：scripts/migrate-v1-to-v2.mjs 使用说明见：scripts/migrate-v1-to-v2.md

Star History

致谢

本项目的许多设计灵感与交互理念来源于 Innei 的 Shiro，包括布局、文章手记、创作律动等模块的视觉风格与体验设计均深受其启发，万分感谢 Innei 大佬为开源社区带来的优秀作品！

本项目包含第三方开源软件，详见 THIRD_PARTY_NOTICES.md。

License

MIT