机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

i博客

基于 Node.js 的开源个人博客系统，现代化的 UI 和用户体验。支持桌面端和移动端访问，支持深色模式，支持 Docker 部署。 不仅仅是博客，更是 Demo，是适合新人入门学习的完整项目。

界面预览

• 博客首页
• 后台管理
• 移动端

在线实例

我的博客 https://skysun.name/

分支说明

• 当前分支 (v2.0.0) 基于 TypeScript + NuxtJS
• v1.0.0 分支基于 JavaScript + ExpressJS
• iBlog.Net 基于 C# + ASP.NET

技术构成

• 开发语言 TypeScript
• 服务端 Node.js
• SSR框架 NuxtJS
• 前端框架 Vue
• 组件库 Ant Design of Vue
• Web字体 Font Awesome
• 持久化 MongoDB
• 身份验证 @nuxtjs/auth

快速开始

准备条件

安装 Node.js (v8 以上版本)、MongoDB。 推荐安装 Yarn 而非 npm 以进行包管理。

安装依赖

$ yarn

启动站点

• 开发模式

$ yarn run dev

• 生产模式

先编译项目

$ yarn run build

再启动站点

$ yarn start

打开浏览器，访问 http://localhost:9000/

调试

• 要启动前端代码调试，请直接在 Chrome Dev Tools - Sources 面板中进行。

• 要启动服务端代码调试，请以如下命令启动服务，然后点击 Chrome Dev Tools 左上角的 Node.js 按钮，就可以像调试前端代码一样调试服务端了。

$ node --inspect node_modules/.bin/nuxt-ts

享受它！:smile:

系统设置

根据实际情况修改 /blog.config.ts 配置文件，修改后需要重启服务器才能生效。 参数说明：

主机

String 类型，主机名，配置为 0.0.0.0 表示监听任意主机。

端口

Number 类型，端口号。

启用HTTPS

Boolean 类型，是否启用 HTTPS。

Mongo地址

String 类型，MongoDB 链接。

JWT密钥

String 类型，JWT 秘钥。

线上部署

使用PM2

推荐使用 pm2 进行 Node.js 的进程管理和持久运行。

安装

$ yarn global add pm2

启动

$ pm2 start pm2.json

使用noginx

noginx 是基于 Node.js 的 HTTP 及反向代理服务器（类似 nginx），如果你有多台 iBlog 服务器实例，你可以使用 noginx 进行代理转发和负载均衡。

Docker

iBlog 支持使用 Docker 容器快速部署并启动项目。

安装Docker

在 官方下载页面 选择对应平台的 Docker Desktop 下载并安装。

制作镜像

在项目根目录下执行如下命令创建镜像文件：

$ yarn run dockerImage

如果创建成功，你可以使用如下命令查看到生成的镜像：

$ docker image ls

创建容器

执行如下命令创建容器：

$ yarn run dockerRun

容器管理

通过 Docker Desktop 执行启动、停止、查看日志等操作。

更新日志

请直接查看 Commit 记录。

待办事项

项目的后续更新计划，欢迎提交 PR。

许可协议

MIT 许可证

版权所有 (c) 2020 Sky.Sun 孙正华

特此免费授予任何获得本软件及相关文档文件（“软件”）副本的人无限制权利，包括但不限于使用、复制、修改、合并、发布、分发、再授权和/或销售本软件的副本，并允许向其提供本软件的人这样做，但须遵守以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或重要部分中。

本软件按“原样”提供，不附带任何形式的明示或暗示的担保，包括但不限于对适销性、特定用途适用性和非侵权的担保。在任何情况下，无论是在合同诉讼、侵权或其他方面，作者或版权持有人均不对因本软件或使用本软件或其他交易而引起的任何索赔、损害或其他责任承担责任。