惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

IT之家
IT之家
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
大猫的无限游戏
大猫的无限游戏
美团技术团队
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
博客园_首页
MyScale Blog
MyScale Blog
N
Netflix TechBlog - Medium
I
InfoQ
Jina AI
Jina AI
Martin Fowler
Martin Fowler
Recent Announcements
Recent Announcements
量子位
月光博客
月光博客
罗磊的独立博客
雷峰网
雷峰网
The Cloudflare Blog
V
V2EX
小众软件
小众软件
人人都是产品经理
人人都是产品经理
博客园 - Franky
T
Tailwind CSS Blog
有赞技术团队
有赞技术团队
S
SegmentFault 最新的问题

Dejavu's Blog

甲骨文 ARM 实例部署 Gemma 4 模型 Headscale + Tailscale 组建虚拟专用网 在 Linux 上使用 Yubikey OpenPGP 应用 BuyVM VPS 块存储挂载教程 Alpine Linux 服务器配置指南 Alpine Linux 安装 Cloudflared Docker 多容器共享中心数据库 安装 Komari 服务器监控工具 Scaleway VPS 安装 Debian Linux Debian 13 下部署 AsmBB 论坛 使用 Kopia 自动化备份服务器数据 给 Docker 启用 IPv6 支持 Netcup 服务器安装自定义 ISO 镜像 烽火 HG5582A 光猫开启桥接模式 Docker 自托管 Shlink 短链服务 部署 Obsidian LiveSync 实时同步服务指南 我的 2025 年不完全回顾 Linux 下 Intel 核显驱动配置与硬件加速 Fedora Linux 安装配置记录 2025 年优雅地自托管 RSS 服务 Woodpecker CI 和 Gitea 实现 Hugo 自动部署 Gitea/Forgejo 集成 Woodpecker CI/CD 在 Blinko 中使用 Ollama 作为 AI 供应商 Docker 部署 Gitea/Forgejo Plausible CE 启用城市级地理位置识别 Blinko 开源 AI 知识库 Docker 部署指南 Netcup 免税账号注册及购买服务器全记录 Docker 自托管 Cloudreve Pro 私有网盘服务 GiffGaff SIM 卡使用体验和注意事项 简体中文互联网在变得糟糕吗?
使用 Vercel 免费部署 Giscus 评论系统
Dejavu Moe · 2022-03-21 · via Dejavu's Blog

前言

Giscus 项目源码是开源的,按照官方说明1,我们可以自托管 Giscus 在其他支持部署 Next.js 应用和 Serverless 函数的平台,本文以 Vercel 为例,详细记录下自己的部署过程2

注册 GitHub App

点击 注册 GitHub App ,输入 App 名称和描述等信息。然后填应用回调地址 Callback URL ,格式为:https://[your-giscus-domain]/api/oauth/authorized

注册 GitHub App

注意取消勾选 Webhook,因为我们注册的 GitHub App 不需要这个

Config App

接下来选择存储库权限 Repository permissions ,只需要 Discussions 的读写权限和 Metadata 的只读权限

Enable Permission

Organization permissions 无需任何配置,最后选择允许应用安装的类型

  • Only on this account

    只允许自己的账户安装这个App

  • Any account

    允许任何用户或组织安装这个 App

Install App

点击 Create GitHub App 完成创建过程,复制 AppIDClientID 保存备用

Get Private Key

然后点击 Generate a new client secret 生成新的 Client Secret,复制保存备用

Get Client Secret

点击 Genaration a private key 生成私钥,生成完成后会自动下载密钥文件,保存备用

Install GitHub App

切换到 Install App 选项卡,安装 App(建议只选择用于评论的 GitHub 存储库)

Install Giscus

Supabase 缓存令牌【可选】

安装的 GitHub App 的 Access Token(访问令牌)有 60 分钟的有效期,我们可以让 Giscus 把 App Access Token 通过 Supbase 数据库缓存,这样可以减少 GitHub App Access Token 的请求量,降低应用达到访问限制的可能性

使用 GitHub 账号登录 Supabase ,先创建一个组织

Register Supabse

然后创建一个项目:

  • 名称随便填
  • 密码要强一点
  • 区域选择 日本、新加坡或韩国都行
  • 计划选择免(bai)费(piao)计划就好了

Config Supabase

稍等片刻,等待项目部署完成,出现下面界面代表部署完成了

Edit Table

点击 Table editor 给项目新建一个表

NameTypeDefault ValuePrimarySettings
installation_idint8NULL勾选取消勾选 Is Unique
tokenvarcharNULL不勾选取消勾选 Is Nullable
expires_attimestamptzNULL不勾选取消勾选 Is Nullable
created_attimestamptznow()不勾选取消勾选 Is Nullable
updated_attimestamptznow()不勾选取消勾选 Is Nullable

编辑完成后点击 Save 保存

Add Table

回到项目设置 API 里,生成 service_role secretURL 一起复制保存备用

Copy Secrets

克隆 Giscus 源码

git clone https://github.com/giscus/giscus.git --depth=1

编辑环境变量

自己随便生成一个 32-64 位的随机字符串,用于加密 User Token(用于后面的环境变量 ENCRYPTION_PASSWORD)。然后进入 giscus 文件夹,将 .env.example 重命名为 .env.local,编辑里面的环境变量

NEXT_PUBLIC_GISCUS_APP_HOST=https://giscus.app # your selfhost giscus website
GITHUB_APP_ID=123456
GITHUB_CLIENT_ID=Iv1.abcd1234wxyz5678
GITHUB_CLIENT_SECRET=abcd1234wxyz5678abcd1234wxyz5678abcd1234
GITHUB_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n将私钥的密钥内容部分去掉空行复制到这里\n-----END RSA PRIVATE KEY-----"
ENCRYPTION_PASSWORD=iwefiwehfiIHuhOIuiIOHUIgUu8767866fTTFHg # 自己生成的随机字符串
SUPABASE_KEY=eyYlM4o.eyyH3Ll4534dsfsdfsGYYFTF0oW0rLD # Supabase service_role secret
SUPABASE_URL=https://xxx.supabase.co # Supabase URL
SUPABASE_INSTALLATION_ACCESS_TOKENS_TABLE=installation_access_tokens
ORIGINS=["https://giscus.app", "https://giscus.vercel.app"] # 根据实际填写
ORIGINS_REGEX=["http://localhost:[0-9]+"]

部署到 Vercel

将修改后的项目推送源码到你的 GitHub 存储库3,登录 Vercel ,点击 New Project,将刚刚上传源码的存储库导入

Deploy App

Vercel 会自动识别你使用的框架,直接点击 Deploy 等待部署完成即可。之后可以在 Vercel 绑定自己的域名,部署过程就完成啦~

使用自己部署的 Giscus

Hugo 配置 Giscus 评论系统 为例,访问你刚刚部署完成的页面生成你的配置,注意 client.js 为自己托管 Giscus 的域名即可

Enable Giscus