2026 强推！WikiMoe：一款支持 Nuxt4+Docker 的全栈开源 Node.js 博客系统

核心特点#

• 基于 Node.js + Nuxt4 + MongoDB 架构，现代化全栈技术。

• 内置 管理后台 和博客前台。

• 支持自动解析 Bilibili 视频嵌入。

• 支持深色主题切换、媒体内容展示和日程记录等功能。

• 可通过 Docker 一键部署或手动部署到 VPS。

适合开发者与进阶用户将其作为个人博客站点或创作平台快速搭建，并根据自身需要进行二次开发。

方法一：使用 Docker 一键部署（推荐）#

这是最省心、最标准的部署方式：

1. 准备服务器环境

   • 有 Docker 和 docker-compose 环境（Linux 推荐使用官方安装脚本）。

2. 创建部署目录mkdir wikimoe && cd wikimoe

3. 下载配置与示例环境文件wget -O compose.yml https://raw.githubusercontent.com/eeg1412/wikimoeNodeJSBlog/main/docker-compose.yml wget -O example.env https://raw.githubusercontent.com/eeg1412/wikimoeNodeJSBlog/main/example.env mv example.env .env

4. 编辑 .env 环境变量用 nano .env 或其他编辑器修改配置，比如设置管理员账号、Nuxt API 域名等。

5. 启动服务docker compose up -d

6. 访问站点

   • 博客前台： http://服务器IP:3007

   • 博客后台： http://服务器IP:3006/admin

默认初始用户名和密码为 .env 配置里的 USER_NAME 和自动生成的密码，首次登陆请务必修改。

更新博客系统时：

1
docker compose pull
2
docker compose up -d
3
docker image prune -f
4
``` :contentReference[oaicite:6]{index=6}
5

6
---
7

8
### 🛠 方法二：手动部署到 VPS / 域名服务器
9

10
如果你不使用 Docker，可以根据以下一般流程部署：
11

12
1. 在服务器上安装 **Node.js 20+** 和 **MongoDB** 实例（MongoDB 7/8 兼容更好）。:contentReference[oaicite:7]{index=7}
13
2. 使用 Git 克隆仓库：
14

15
   ```bash
16
   git clone https://github.com/eeg1412/wikimoeNodeJSBlog.git

方法二：自建部署#

1. 进入项目的 server、 admin、 blog 子目录，分别创建 .env 文件，根据文档设置变量。

2. 在各自目录运行依赖安装：yarn install

3. 编译前端：yarn build

4. 使用进程管理工具（如 pm2）启动服务：pm2 start yarn --name wikimoe-server -- run start pm2 start yarn --name wikimoe-blog -- run start

5. 使用 Nginx 反向代理 配置域名访问（如代理 localhost:3007 和 localhost:3006）。

什么是这个系统的架构？#

这个项目分成三个逻辑部分：

• server：博客后端 API。

• admin：管理后台前端。

• blog：前台博客页面。

我该用哪种部署方式？#

• Docker 部署：最简单、最标准，适合初学者和想快速上线的用户。

• 手动部署：适合想优化性能、用自己策略管理服务的用户（如 Nginx、PM2、CI/CD 等）。

如何更新博客内容和版本？#

如果用 Docker，只需在部署目录执行：

1
docker compose pull
2
docker compose up -d
3
``` :contentReference[oaicite:11]{index=11}
4

5
对于手动部署，拉取更新后重新构建和重启服务即可。
6

7
---
8

9
### ❓ 如何创建博客管理员？
10

11
在 Docker 部署模式下，首次创建管理员用户名/密码会在 `.env` 中设定，登录后可修改。若手动部署，一般需要使用提供的命令或后台注册功能创建用户。:contentReference[oaicite:12]{index=12}
12

13
---
14

15
### ❓ 我用 Nginx 做反代需要注意什么？
16

17
如果你反代博客内容与 API 时，建议把 Nuxt 前端的 `/content` 和 `/upload` 路径直接代理到后端 API，防止资源加载异常。:contentReference[oaicite:13]{index=13}
18

19
---
20

21
## 📣 总结
22

23
**WikiMoe NodeJS 博客系统** 是一个现代、可定制化的博客解决方案，适合喜欢自由控制、希望自建博客的开发者们。通过 Docker 或 VPS 手动部署都可以实现上线，并且支持丰富的个性化内容功能。只要按步骤配置环境即可快速拥有自己的博客站点。
24

25
项目仓库👉 https://github.com/eeg1412/wikimoeNodeJSBlog :contentReference[oaicite:14]{index=14}
26

27
---
28

29
如需进一步文章排版、截图示例、部署视频演示等内容，我也可以帮你完善！📄✨
30
::contentReference[oaicite:15]{index=15}
31
0

1. 升级到 Nuxt 4 架构#

新版本前台与后台全面升级到 Nuxt 4：

• 更快的构建速度和运行性能

• 更现代的目录结构和模块机制

• 对 SSR / SSG / SPA 场景支持更完善

• 更友好的未来升级空间

对于打算长期维护博客、持续写作的用户来说，这是一个非常关键的升级点。

2. 管理后台功能完善#

后台不再只是“能用”，而是逐步走向可日常使用：

• 文章管理（新增 / 编辑 / 删除）

• 分类与标签体系

• 媒体资源管理

• 账号与权限基础管理

• 后台与前台样式解耦，互不影响

对于个人博客或小型内容站来说，已经完全够用。

3. 视频内容解析增强（Bilibili 支持）#

新版本中对 Bilibili 视频解析与嵌入做了优化：

• 文章中可直接插入 B 站视频

• 自动识别视频链接并渲染

• 非 iframe 粗暴嵌入，页面结构更干净

非常适合偏 ACG、技术分享、视频笔记类博客。

4. 深色 / 浅色主题切换优化#

主题系统进一步完善：

• 支持深色 / 浅色模式

• 可跟随系统主题

• 前台显示更加统一、护眼

对长时间阅读和夜间写作体验提升明显。

5. 内容结构与数据模型优化#

在新版本中，后端数据结构也进行了调整：

• 文章、分类、标签关系更清晰

• MongoDB 数据模型更规范

• 更方便后期做数据迁移和二次开发

如果你有打算在此基础上二开，这是一个非常友好的改进。

6. Docker 部署流程持续优化#

Docker 相关内容在新版本中越来越“开箱即用”：

• docker-compose.yml 结构更清晰

• .env 配置项更完整

• 默认端口、服务拆分更合理

• 更适合一台 VPS 直接部署上线

即使你 不太熟 Node.js，也能比较轻松地跑起来。

7. 更适合二次开发的项目结构#

新版本整体更偏向「开发者友好」：

• 前台 / 后台 / 服务端职责清晰

• 模块拆分合理

• 配置集中、可读性强

如果你想把它改造成：

• 知识库 / Wiki

• 私人笔记系统

• ACG 资源站

• 小型内容平台

都是完全可行的。