个人博客后台
Firefly 博客的开源管理后台。可视化编辑文章、相册与配置,Git 提交和推送由你确认后执行;支持一键本地运行、自动安装 Node/Git,也可打包上传服务器。

🚀 快速导航: 仓库地址 / 问题反馈 / Firefly 主题
⚡ 本地文件优先:直接读写博客仓库里的 Markdown、配置与图片,不引入数据库
🔐 发布可控:Diff 预览、选择性提交、撤销与回滚,推送前始终由你确认
🧩 单进程部署:一个 Node 服务同时托管管理界面与 API,Nginx 只做反向代理
🖥 跨平台启动:Windows 双击 start.bat,Linux / macOS 执行 start.sh,环境缺失自动补
Firefly Admin Console 不是博客主题,而是配套的管理端。它读取一个普通的 Markdown 博客仓库,可以直接用于 Firefly,也适用于其他基于文件的内容结构。
所有内容、配置和提交记录都留在你自己的服务器和 Git 仓库里,不依赖任何云端服务。
✨ 功能特性
内容管理
- 文章管理 - 新建、编辑、发布/转草稿、置顶、标签与分类、加密文章、批量操作
- 内容模块 - 动态、相册、媒体库、单页、项目展示、友链、音乐、主页图片
- Markdown 编辑 - Vditor 驱动,支持 IR、所见即所得与源码三种模式
- 图片处理 - 上传后由 sharp 压缩,按文章归档到对应目录
发布流程
- 变更预览 - 提交前查看完整 Diff
- 选择性提交 - 只提交需要的文件,支持撤销单个变更
- 回滚与同步 - 回滚历史提交,拉取远程更新并推送
- 多项目 - 在同一个后台里管理多个博客仓库
配置与安全
- 配置中心 - 结构化表单与源码(TS/JSON)双模式编辑
- 初始化向导 - 首次启动选择本地仓库;空目录可填远程地址与访问令牌完成克隆
- 安全机制 - 单管理员、scrypt 密码哈希、会话签名、CSRF 同源校验、操作审计日志
- 界面 - Firefly 文档站风格,响应式布局,支持深色模式
🚀 快速开始
环境要求
- Node.js ≥ 22
- Git
方式一:本地一键运行
Windows 双击 start.bat,Linux / macOS 执行:
./start.sh脚本会自动检查环境、安装依赖、首次构建,然后打开 http://127.0.0.1:5175/admin/。
- 缺少 Node.js 22+ 时,会询问是否从 npmmirror、华为云、清华、官方源依次尝试下载,并校验 SHA256,安装到项目下
.runtime/node,不改动系统环境 - 缺少 Git 时,Windows 自动下载 PortableGit 解压到
.runtime/git,Linux / macOS 走系统包管理器 - 端口
5175被占用时会直接提示并退出,不会静默失败
方式二:构建部署包
Windows 双击 build-upload.bat,Linux / macOS 执行 ./build-upload.sh。脚本会构建前后端,并在 release/ 下生成:
firefly-admin-<version>/:可直接复制到服务器的部署目录firefly-admin-<version>.zip:可在宝塔「文件」中上传解压
部署包只包含运行时文件(web/dist、server/dist、生产依赖、启动脚本),服务器上无需构建前端。
开发模式
npm installnpm run dev前端 http://127.0.0.1:5174/admin/,后端 http://127.0.0.1:5175。
首次启动会自动创建管理员账号,初始凭据保存在 server/data/initial-credentials.txt。首次登录会强制修改账号与密码,成功后凭据文件自动删除。
登录后按向导完成初始化:填写博客仓库的本地绝对路径;目录为空时可填远程地址(私有仓库需 HTTPS 访问令牌,仅用于本次克隆)与分支、提交身份。
📦 服务器部署
博客本身是静态站,可以托管在腾讯云 EdgeOne 这类平台上;后台需要长期运行 Node 进程并读写本地文件,放在一台轻量应用服务器上即可。
宝塔面板中的关键配置:
- 启动命令:使用
node server/dist/index.js,或用 PM2 托管 - 反向代理:
/代理到127.0.0.1:5175 - 请求头:必须原样透传 Host,否则同源校验会 403
proxy_set_header Host $http_host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;启用 HTTPS 后,记得放行云厂商安全组与宝塔防火墙的 443 端口,并把 COOKIE_SECURE 设为 true。
⚙️ 环境变量
后台根目录下的 .env 会自动加载,已存在的系统环境变量优先。
| 变量 | 默认值 | 说明 |
|---|---|---|
HOST | 127.0.0.1 | 服务监听地址,容器内为 0.0.0.0 |
PORT | 5175 | 服务端口 |
BLOG_REPO_PATH | local-blog | 博客仓库路径,相对路径按后台根目录解析 |
DATA_DIR | ./data | 账号、项目配置、操作日志等数据目录 |
GIT_BIN | git | Git 可执行文件路径,Windows 可填绝对路径 |
SESSION_SECRET | 开发用默认值 | 会话签名密钥,生产环境必须替换 |
COOKIE_SECURE | 生产环境为 true | 直接 HTTP 部署时设为 false |
NODE_ENV | development | 生产部署设为 production |
📁 目录结构
firefly-admin/├── server/ # Fastify API 服务│ └── src/│ ├── routes/ # 接口路由│ ├── services/ # Git、内容、配置、初始化等业务逻辑│ └── store/ # 账号、项目配置、操作日志├── web/ # Vue 3 管理界面(base 为 /admin/)├── scripts/ # 构建、安装与冒烟测试脚本├── local-blog/ # 默认博客仓库目录(仅保留 .gitkeep)├── .env.example # 环境变量示例└── package.json # npm workspaces 根配置🔒 安全说明
- 访问令牌保存在
data/git-credential.json(权限0600),仅在执行 Git 命令时临时注入,不写入博客仓库配置或日志 - 生产环境必须设置强随机
SESSION_SECRET - 不要提交或公开
data/、.env以及local-blog/中的博客仓库内容 - 后台会直接修改博客仓库文件,建议先在测试仓库验证,再用于线上仓库















Gitee