2

Message Board

hanyixuanten edited this page 2026-10-25 12:18:30 +00:00

Table of Contents

• 留言墙（D1）
• 1. 创建数据库
• 2. 绑定到 Pages
• 行为说明

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

留言墙（D1）

首页留言墙由 functions/api/messages.js 提供，数据存在 Cloudflare D1 里。

1. 创建数据库

Dashboard → Storage & Databases → D1 → Create database（名字随意，如 class-history-messages）。

2. 绑定到 Pages

Pages 项目 → Settings → Functions → D1 database bindings：

Variable name	D1 database
DB	刚创建的数据库

绑定名必须是 DB（代码里 env.DB 取的就是它）。

行为说明

• 同一 IP 两条留言间隔至少 20 秒；
• 表结构无需手动创建：首次访问时自动建表，旧表缺失的列也会自动补齐（ensureSchema）；
• 每条留言会记录 IP、User-Agent、国家/地区作审计，仅存库，列表接口不返回；
• 名字最长 12 字，内容最长 120 字，未填名字显示「匿名同学」；
• 列表按时间倒序返回最多 200 条，库内只保留最近 500 条（自动清理）。

不绑定 D1 时：页面其余功能正常，留言墙显示「数据库未绑定」。

班史模板 · 文档

• Home
• Quick-Start
• Content-Format
• Deployment
• CMS-Bot
• Message-Board
• Turnstile

---

仓库 · Issues

class-history-template · 有问题欢迎提 Issue