Node.js个人博客

1. 项目介绍

项目演示地址：https://ximingx.org.cn/

项目github：https://github.com/ximingx/blog

想象一下,你是一位热爱写作的程序员小王。每天,你都有很多新的想法和技术心得想要分享。但是,管理你的博客网站却成了一个让你头疼的问题。

周一早晨,你坐在电脑前,准备写一篇关于最新学到的编程技巧的博客文章。然而,你突然想到还要登录到博客管理后台,配置文章类别,调整发布时间,上传图片,等等。这些繁琐的步骤让你感到沮丧,你意识到要花费至少半小时来处理这些技术细节,而不是专注于写作本身。

你心想:“要是我能只管写作,其他的事情都自动完成就好了。我只想用Markdown写下我的想法,然后它们就神奇地出现在我的博客上,那该多好啊!”

这时这个博客系统允许你只需在本地编写Markdown文档,就能自动将内容上传到服务器并发布到你的博客上。有了这个工具,你可以随时随地打开你喜欢的文本编辑器,用Markdown格式写下你的想法。完成后,你只需保存文件,剩下的一切都会自动完成。这样,你就可以将更多的时间和精力投入到真正重要的事情上:分享你的知识和经验。

1. 使用案例

如下是项目目录，你创建一些md文档与目录

posts
├── assets
│   └── image-20240626085241624.png
├── 公务员
│   ├── 常识
│   │   └── 法律
│   │       ├── 公务员法.md
│   │       ├── 刑法.md
│   │       ├── 劳动合同法.md
│   │       ├── 劳动法.md
│   │       ├── 宪法.md
│   │       ├── 民法.md
│   │       └── 行政法.md
│   └── 言语
│       └── 词义解析.md
└── 博客
    └── 博客搭建.md

博客文章存放在 blog/posts 目录下，posts 目录下的每一个文件夹即为分类，文件夹下的 .md 文件即为文章。

• 文件夹代表文章的标签
• 文件的名字为文章标题
• 文件的修改时间为归档时间
• posts下的assets存放md文档的照片

首页面显示：

显示的标签：

显示的归档：

文章样式：

修改项目根目录下的README.md即可直接修改关于页面。

这似乎是一个很平常的博客系统，但是我们可以做一些配置，同步到我们的服务器上，让我们不需要做额外的操作，它自动完成文件的上传。

2. 项目基本配置

项目对新手很友好，只需要修改config.js中配置，即可直接编写md文档使用，在设置ssh后本地posts文件夹中的文件会同步到配置的服务器。

// config.js
const path = require('path');

module.exports = {
    ---
    ssl: {
        // 本地生成ssl证书，测试
        // openssl req -x509 -newkey rsa:4096 -keyout private.key -out certificate.crt -days 365
        darwin: {
            key: './ssl/private.key',
            cert: './ssl/certificate.crt'
        },
        // 服务器上的ssl证书
        linux: {
            key: '/etc/nginx/ssl/ximingx.org.cn.key',
            cert: '/etc/nginx/ssl/ximingx.org.cn.crt'
        }
    },
    ssh: {
        localPosts: path.join(__dirname, './posts'),
        // 服务器ip地址
        remoteHost: '0.0.0.0', //不设置，默认不启动服务器
        user: 'root',
        remotePath: '/root/blog/posts',
        // 需要与服务器配置好ssh免密登录
        privateKey: '/Users/ximingx/.ssh/id_rsa'
    },
    ---
};

2. 博客的搭建

1. 本地部署

打开本地终端，执行以下命令：

git clone https://github.com/ximingx/blog.git
cd blog
npm install
npm run dev

启动成功后，打开浏览器，访问 https://localhost 即可查看博客。

2. 服务器部署

CentOS系统上安装Node.js和npm

curl -sL https://rpm.nodesource.com/setup_14.x | sudo bash - sudo yum install -y nodejs

使用 zip 和 unzip 命令来压缩和解压缩文件。

# 本地操作
# 压缩blog
zip -r blog.zip ./blog
# 复制本地文件到服务器
scp /Users/ximingx/Downloads/blog.zip root@服务器ip地址:/root  #然后输入自己的秘密

# 进入服务器
ssh -p 22 username@remotehost

# 进入到服务器后
unzip blog.zip
# 进入项目
cd blog 
# 安装依赖，启动项目
npm i
pm2 start app.js
# 设置PM2开机自启
pm2 startup systemd
# 保存当前的PM2进程列表，确保重启后能恢复：
pm2 save

# 补充
# sudo rm -r /path/to/your/directory 可以用来删除文件夹目录