Cloudflare Workers 从零搭建个人博客（CF-blog 完整部署教程）

六、敏感信息改用 Secrets 管理

⚠️ 重要：不要把密码硬编码在代码里！

1. 修改代码，从环境变量读取

打开 src/index.js，找到配置区，把原来的 ACCOUNT 常量改成函数：

// ========== 从环境变量读取敏感配置 ==========
function buildAccount(env) {
  return {
    user: env.ADMIN_USER || "admin",
    password: env.ADMIN_PASSWORD || "",
    third_token: env.THIRD_TOKEN || "cfblog",
    cacheZoneId: env.CACHE_ZONE_ID || "",
    cacheToken: env.CACHE_TOKEN || "",
    sessionSecret: env.SESSION_SECRET || "",
    sessionMaxAge: parseInt(env.SESSION_MAX_AGE || "604800", 10)
  };
}

// 运行时会被 handlerRequest 重新赋值
let CONFIG = { ...OPT, privateBlog: OPT.privateBlog || false };
let ACCOUNT = null;

在 handlerRequest 函数开头初始化：

async function handlerRequest(request, env, ctx) {
  // ★ 运行时初始化敏感配置
  ACCOUNT = buildAccount(env);
  CONFIG = { ...OPT, privateBlog: OPT.privateBlog || false };
  if (env.SITE_DOMAIN) CONFIG.siteDomain = env.SITE_DOMAIN;

  // ★ 校验必需 secret
  if (!ACCOUNT.password || !ACCOUNT.sessionSecret) {
    return new Response(
      '服务未正确配置：请在 Workers 中设置 ADMIN_PASSWORD 和 SESSION_SECRET 环境变量。',
      { status: 500, headers: { 'content-type': 'text/plain;charset=UTF-8' } }
    );
  }

  const db = env.CFBLOG;
  // ... 下面保持不变
}

2. 写入 Secrets

# 后台登录密码
wrangler secret put ADMIN_PASSWORD
# 输入密码，回车（不显示输入内容，正常）

# 会话签名密钥（随机字符串）
wrangler secret put SESSION_SECRET
# 输入 openssl rand -hex 32 生成的值

# Cloudflare API Token（用于清缓存）
wrangler secret put CACHE_TOKEN
# 输入从 Cloudflare 创建的 API Token

3. 获取 API Token

1. 访问 https://dash.cloudflare.com/profile/api-tokens
2. 点「创建令牌」→「创建自定义令牌」
3. 权限添加：区域 → 缓存清除 → 清除
4. 区域资源：选择你的域名
5. 创建后立刻复制 Token（只显示一次）

4. 验证 Secrets

wrangler secret list

输出应该包含：

[
  { "name": "ADMIN_PASSWORD", "type": "secret_text" },
  { "name": "SESSION_SECRET", "type": "secret_text" },
  { "name": "CACHE_TOKEN", "type": "secret_text" }
]

5. 本地开发用 .dev.vars

ADMIN_USER=admin
ADMIN_PASSWORD=本地测试密码
SESSION_SECRET=本地随机串
CACHE_ZONE_ID=你的区域ID
CACHE_TOKEN=你的token
THIRD_TOKEN=cfblog
SITE_DOMAIN=你的域名
SESSION_MAX_AGE=604800

七、部署到 Cloudflare

wrangler deploy

输出类似：

Total Upload: 290.81 KiB / gzip: 60.14 KiB
Your Worker has access to the following bindings:
Binding                                                       Resource
env.CFBLOG (cfblog-db)                                        D1 Database
env.ADMIN_USER ("admin")                                      Environment Variable
env.SITE_DOMAIN ("你的域名")                                   Environment Variable
...
Deployed cfblog triggers (1.31 sec)
  https://cfblog.your-account.workers.dev

访问 https://cfblog.your-account.workers.dev 就能看到博客首页了。

八、绑定自定义域名

1. 登录 Cloudflare 后台
2. 进入 Workers & Pages → 点 cfblog
3. 设置 → 域和路由 → 添加 → 自定义域
4. 输入你的域名（如 blog.example.com）
5. 点「添加域」，如果域名在同账号会自动配置 DNS

等 1-2 分钟，访问 https://blog.example.com 即可。

九、登录后台并初始化

1. 登录

访问 https://你的域名/admin/login：

• 用户名：admin（对应 ADMIN_USER）
• 密码：你 wrangler secret put ADMIN_PASSWORD 时设置的

2. 初始配置

登录后进入后台，依次配置：

3. 分类示例

["经验分享", "干货分享", "软件分享", "收集整理"]

4. 顶部菜单示例

[
  {"title": "home|首页", "url": "/"},
  {"title": "book|经验分享", "url": "/category/经验分享"},
  {"title": "link|关于本站", "url": "/article/000001.html"}
]

home| 是图标前缀，支持 home、book、list、monitor、folder、cloud、cap、link、tag。

5. 幻灯片示例

[
  {"img": "https://example.com/1.jpg", "url": "https://example.com"},
  {"img": "https://example.com/2.jpg", "url": "https://example.com"}
]

6. 写完文章记得「发布站点」

后台 → 发布站点 → 「立即发布」，清一次缓存，前台才会生效。

十、数据库备份与恢复

导出备份

wrangler d1 export cfblog-db --remote --output=./backup.sql

恢复数据

wrangler d1 execute cfblog-db --remote --file=./backup.sql

清空数据

# 只清数据，保留表结构
wrangler d1 execute cfblog-db --remote --command "DELETE FROM articles; DELETE FROM system_config; DELETE FROM comments;"

彻底重置

# 删表
wrangler d1 execute cfblog-db --remote --command "DROP TABLE IF EXISTS articles; DROP TABLE IF EXISTS system_config; DROP TABLE IF EXISTS comments;"

# 重建表
wrangler d1 execute cfblog-db --remote --file=./schema.sql

十一、常用命令速查

# 本地开发预览
wrangler dev

# 部署
wrangler deploy

# 查看实时日志
wrangler tail

# 列出 Secrets
wrangler secret list

# 删除 Secret
wrangler secret delete ADMIN_PASSWORD

# 查看当前登录账号
wrangler whoami

# D1 查询
wrangler d1 execute cfblog-db --remote --command "SELECT COUNT(*) FROM articles;"

# D1 导出
wrangler d1 export cfblog-db --remote --output=./backup.sql

# D1 导入
wrangler d1 execute cfblog-db --remote --file=./backup.sql

十二、安全建议

1. 必须改默认密码：ADMIN_PASSWORD 别用默认的
2. SESSION_SECRET 用随机值：openssl rand -hex 32
3. 敏感信息用 Secret：密码、Token 一律 wrangler secret put
4. 不要提交 .dev.vars：加进 .gitignore
5. .wrangler/ 目录不要提交：包含本地状态
6. 定期备份 D1：wrangler d1 export

十三、进阶玩法

• 文章加密：后台编辑文章时设置「文章访问密码」
• 评论可见：文章内用 #reply]内容#/reply] 包裹，评论后才显示
• 折叠块：文章内用 #collapse=标题]内容#/collapse]
• 自定义分类样式：修改代码里的 CATEGORY_STYLE 对象
• 绑定自定义域名：见第八节