视频加载失败

个人博客后台

返回项目列表
个人博客后台
已发布
Admin

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

个人博客后台

Firefly Admin Console#

面向 Firefly 博客的开源管理后台

Node.js >= 22
Node.js >= 22
Vue 3.5
Vue 3.5
Fastify 5
Fastify 5
License MIT
License MIT

Stars
Stars
Forks
Forks


🚀 快速导航: 仓库地址 / 问题反馈 / Firefly 主题

⚡ 本地文件优先:直接读写博客仓库里的 Markdown、配置与图片,不引入数据库

🔐 发布可控:Diff 预览、选择性提交、撤销与回滚,推送前始终由你确认

🧩 单进程部署:一个 Node 服务同时托管管理界面与 API,Nginx 只做反向代理

🖥 跨平台启动:Windows 双击 start.bat,Linux / macOS 执行 start.sh,环境缺失自动补

💡 Tip

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 执行:

Terminal window
./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、生产依赖、启动脚本),服务器上无需构建前端。

开发模式#

Terminal window
npm install
npm 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 会自动加载,已存在的系统环境变量优先。

变量默认值说明
HOST127.0.0.1服务监听地址,容器内为 0.0.0.0
PORT5175服务端口
BLOG_REPO_PATHlocal-blog博客仓库路径,相对路径按后台根目录解析
DATA_DIR./data账号、项目配置、操作日志等数据目录
GIT_BINgitGit 可执行文件路径,Windows 可填绝对路径
SESSION_SECRET开发用默认值会话签名密钥,生产环境必须替换
COOKIE_SECURE生产环境为 true直接 HTTP 部署时设为 false
NODE_ENVdevelopment生产部署设为 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/ 中的博客仓库内容
  • 后台会直接修改博客仓库文件,建议先在测试仓库验证,再用于线上仓库

📄 License#

MIT

Profile Image of the Author
L3thargy
Hello, I'm L3thargy.
公告
欢迎来到我的博客!
分类
标签
最新动态
站点统计
文章
1
分类
1
标签
5
总字数
2,556
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
EdgeOne Pages
博客版本
Firefly v6.16.9
文章许可
CC BY-NC-SA 4.0
文章目录