还在本地写博客？来试试基于worker的博客后台 零成本叫你打造一个不用服务器的后台 - UpXuu's blog

发布于 2026-05-04 07:06:00

Blog Admin Worker

基于 Cloudflare Workers 的博客管理后台与图床系统，一worker通吃 一个worker解决你的所有博客编辑问题！ 使用 Vditor 作为 Markdown 编辑器。

::github{repo=“imupxuu/blog-admin-workers”} image.png

功能特性

技术栈

仓库结构

你需要准备 两个 GitHub 仓库：

1. 博客仓库（myblog）

存放文章和旧图片：

myblog/
├── src/
│   ├── content/
│   │   └── posts/          # 文章目录
│   ├── layouts/
│   │   └── Layout.astro    # 布局文件
│   └── config.ts           # 博客配置
└── public/
    ├── images/             # 旧图片（可选）
    └── data/
        └── friends.json    # 友链配置

2. 图片仓库（photo）

专门存放新上传的图片：

photo/
└── images/
    ├── index.json          # 根索引（自动生成）
    ├── 2026/
    │   ├── 4/
    │   │   ├── index.json  # 月份索引（自动生成）
    │   │   ├── 5/          # 日期目录
    │   │   └── 6/
    │   └── 5/
    └── ...

部署

环境要求

部署步骤

1. 克隆项目
git clone https://github.com/ImUpXuu/blog-admin-workers.git
cd admin-worker
2. 安装依赖
npm install
3. 配置环境变量

编辑 wrangler.toml 文件：

[vars]
# 博客仓库配置
GITHUB_OWNER = "ImUpXuu"           # 你的 GitHub 用户名
GITHUB_REPO = "myblog"             # 博客仓库名
GITHUB_BRANCH = "main"             # 分支名
POSTS_PATH = "src/content/posts"   # 文章目录路径
IMAGE_PATH = "public/images"       # 旧图片路径（可选）
BLOG_URL = "https://upxuu.com"     # 博客域名

# 图片仓库配置
PHOTO_OWNER = "ImUpXuu"            # 图片仓库所有者
PHOTO_REPO = "photo"               # 图片仓库名
PHOTO_BRANCH = "main"              # 图片仓库分支
PHOTO_PATH = "images"              # 图片根目录
PROXY_BASE = "https://img.upxuu.lcrworld.xyz/images/img"  # 图片代理基础 URL
4. 设置 Secrets
# 设置 GitHub Token（需要 repo 权限）
wrangler secret put GITHUB_TOKEN

# 设置管理员密码
wrangler secret put ADMIN_PASSWORD
5. 部署到 Cloudflare
npm run deploy

部署成功后会显示 Worker URL，例如：https://blog-admin.upxuu.workers.dev

本地开发

# 设置 Secrets（首次）
wrangler secret put GITHUB_TOKEN
wrangler secret put ADMIN_PASSWORD

# 启动开发服务器
npm run dev

项目结构

admin-worker/
├── src/
│   ├── index.js        # Cloudflare Workers 主入口
│   ├── html.js         # 管理后台 HTML 和 JavaScript
│   └── gallery.js      # 公开图库页面
├── scripts/
│   ├── typora-upload.py    # Typora 图片上传脚本（Python）
│   └── typora-upload.bat   # Windows 批处理入口
├── .github/
│   └── workflows/
│       └── generate-index.yml  # GitHub Action（图片索引生成）
├── wrangler.toml       # Wrangler 配置文件
├── package.json        # 项目依赖配置
└── README.md          # 项目说明文档

API 接口

文章管理

图片管理

友链管理

设置

Typora 图片上传配置

1. 安装 Python

确保已安装 Python 3.8+ 并添加到系统 PATH。

2. 安装依赖

pip install requests

3. 配置 Typora

打开 Typora → 文件 → 偏好设置 → 图像 → 上传服务配置：

4. 测试

在 Typora 中粘贴图片，应该会自动上传并返回 URL。

GitHub Action 自动索引

工作流文件位置：image-proxy/.github/workflows/generate-index.yml

配置步骤

1. 复制工作流文件

将 image-proxy/.github/workflows/generate-index.yml 复制到你的 photo 仓库 的 .github/workflows/ 目录下。

2. 修改代理 URL

编辑工作流文件，将 PROXY_BASE 改为你自己的 Worker 代理地址：

const PROXY_BASE = 'https://img.upxuu.lcrworld.xyz/images/img';  // 改为你的地址
3. 工作原理
4. 索引格式

根索引 (images/index.json)：

[
  {
    "year": 2026,
    "month": 4,
    "count": 15,
    "url": "https://img.upxuu.lcrworld.xyz/images/2026/4/index.json"
  }
]

月份索引 (images/2026/4/index.json)：

[
  {
    "name": "1234567890_123.webp",
    "url": "https://img.upxuu.lcrworld.xyz/images/2026/4/5/1234567890_123.webp",
    "date": "2026-4"
  }
]

IndexNow 自动提交

保存文章时自动提交到 Bing 搜索引擎：

安全认证

移动端优化

许可证

MIT

鸣谢

前往 upxuu.com 阅读完整版本（含交互功能）