blog_api

是时候给 memos / fcircle / 随机图 api 扔到 土立土及木甬 里面去了

一个基于 Go + Gin + SQLite + Vue3 的博客周边 API 服务，覆盖：memos（动态）、fcircle（友链与 RSS 聚合）、随机图 API（图片仓库与图片直链）。

我有我的便利，你有你的自由

后端 API 可独立运行，不依赖内置 web 面板；你也可以完全自己做一个面板对接这些接口。

这项目到底做了啥

• memos：动态内容（moments）增删改查、媒体绑定、点赞/取消点赞。
• fcircle：友链管理、友链 RSS 拉取、RSS 文章列表对外输出。
• 随机图 API：图片入库、更新、删除、公开访问（/api/public/image/*id）。
• 资源管理：支持本地资源上传/删除，也支持 OSS 上传/删除。
• 管理后台：内置 web/（Vue3 + Element Plus）仅作为默认实现，可不用或自行替换。
• 反机器人能力：支持 Turnstile、指纹签发、邮箱验证码（按配置启用）。

快速启动

1. 准备配置

• 复制 .env.example 到 .env 并按需修改。
• 复制 system_config.example.json 为 data/config/system_config.json。
• 可选：复制 friend_list.example.json 为 data/config/friend_list.json（用于初始化友链）。

2. 启动后端

go run main.go

默认监听：0.0.0.0:10024。

通过管理面板保存公开 API 功能开关后会立即热生效。监听地址、数据库路径、机器人集成、OSS 等启动型配置仍可能需要重启；保存接口会返回 restart_required_keys 提示。

3. 启动前端管理面板（可选）

cd web
npm install
npm run dev

开发访问：http://localhost:5173/panel/login。

构建发布：

cd web
npm run build

构建产物输出到 data/panel，由后端统一托管。

公开 API 功能开关

公开业务 API 默认全部关闭。可在管理面板的“系统设置 → 功能开关”中选择启用，或编辑 data/config/system_config.json：

{
  "system_conf": {
    "safe_conf": {
      "enabled_public_apis": ["moments", "image", "friend", "rss", "email"]
    }
  }
}

支持以下 key：

• moments：动态读取及 reaction 接口。
• image：随机图和指定图片公开接口。
• friend：公开友链读取及邮箱 token 自助管理接口。
• rss：公开 RSS 文章读取接口。
• email：发送/验证邮箱验证码及签发邮箱 token 的接口。

未启用的接口统一返回 HTTP 404。未知 key（包括错误拼写）会被忽略；管理接口、管理员登录、Turnstile、指纹和公开验证配置不受此列表影响。通过管理面板保存该列表可立即生效，无需重启。

关键接口（示例）

• 公共接口（需在 enabled_public_apis 中启用对应 key）：

  • GET /api/public/moments/
  • GET /api/public/rss/
  • GET /api/public/friend/
  • GET /api/public/image/*id

• 管理接口（JWT）：

  • GET /api/action/moments
  • POST /api/action/rss
  • POST /api/action/image
  • POST /api/action/resource/local

• 认证相关：

  • POST /api/verify/passwd
  • POST /api/verify/email（需启用 email）
  • POST /api/verify/turnstile
  • POST /api/verify/fingerprint

• 邮箱友链自助管理（邮箱 token）：

  • GET /api/public/friend/self：分页查询当前邮箱名下的友链
  • POST /api/public/friend：新增友链
  • PUT /api/public/friend/:id：修改自己的友链资料
  • DELETE /api/public/friend/:id：删除自己的友链

目录结构（简版）

.
├── main.go                # 程序入口
├── src/                   # 后端源码
├── migrations/            # SQLite SQL 迁移文件
├── data/config/           # JSON 配置
└── web/                   # 管理后台（Vue3）