🔥 全网最细!从零搭建+本地调试+服务器部署+域名上线全套流程,全程复刻、无废话、零踩坑,小白看完直接拥有属于自己的专属博客网站!
很多程序员、计算机专业学生、技术爱好者,一直都想拥有一个属于自己的个人技术博客。
不管是用来记录学习笔记、沉淀项目实战、展示个人技术履历,还是用来求职加分、打造个人IP,独立博客都是性价比最高的方式。
但绝大多数人都卡在这几个问题上:
不会搭建项目、不懂环境配置、服务器部署报错不断、域名解析不会操作、上线后各种bug无法解决。
网上的教程要么步骤残缺、要么版本老旧、要么只讲搭建不讲部署,新手跟着做百分百踩坑。
今天这篇2026最新完整版个人博客系统部署教学,我从环境准备、源码搭建、本地调试、云服务器部署、Nginx配置、HTTPS证书配置、域名上线、全站优化避坑全流程手把手教学。
全程无跳过步骤,所有代码、配置、命令均可直接复制运行,零基础小白也能一次性部署成功,轻松拥有专属个人博客!
一、项目简介与部署效果展示
1.1 项目介绍
本次部署的是轻量化高颜值个人博客系统,适配学生、职场开发者个人使用,也是目前CSDN、GitHub热度最高的开源博客项目。
项目优势非常适合个人搭建:
轻量高效:占用服务器资源极低,低配学生机即可流畅运行
界面美观:自适应移动端+电脑端,自带暗黑模式、文章分类、标签归档、搜索功能
功能齐全:支持文章发布、评论、留言、权限管理、数据备份、访问统计
部署简单:兼容性极强,Windows、Mac、Linux系统均可本地调试,腾讯云、阿里云服务器通用
免费开源:无版权限制,可自由二次修改、商用、个人展示
1.2 最终实现效果
✅ 本地完美运行,支持实时修改调试
✅ 服务器云端永久上线,外网可直接访问
✅ 自定义域名访问,配置HTTPS安全证书,浏览器绿色安全标识
✅ 自动适配手机、电脑、平板所有设备
✅ 支持SEO优化,百度搜索引擎快速收录
二、前期环境准备(2026适配版)
部署之前必须配齐所有环境,环境配置出错是90%部署失败的核心原因,严格按照本文版本安装,完美兼容无报错。
2.1 本地环境所需工具
Git:用于拉取开源源码、版本管理(最新版即可)
Node.js:v16-v18稳定版(重点!过高版本会出现兼容报错)
代码编辑器:VS Code(免费好用,适配项目修改调试)
2.2 服务器环境要求
服务器系统:CentOS 7.9 / Ubuntu 20.04(本文以CentOS为例,最稳定、适配性最强)
服务器配置:1核2G低配即可,学生机完全够用
必备环境:Nginx、Node.js、Git、PM2进程守护工具
2.3 所需资源准备
一台云服务器(阿里云/腾讯云/华为云均可)
一个域名(可选,不想备案可直接用IP访问)
完整开源博客源码(文末免费领取)
三、本地项目搭建与调试教学(零报错)
先在本地调试成功,再上传服务器部署,能极大规避线上报错,新手务必按照这个顺序操作!
3.1 源码拉取
新建一个空文件夹,右键打开Git终端,输入以下命令拉取源码:
git clone 源码地址
cd blog-project3.2 依赖安装
终端输入安装命令,自动加载项目所有依赖包:
npm install避坑重点:如果出现npm报错、依赖安装失败,执行清理缓存命令后重新安装:
npm cache clean --force npm install3.3 本地启动项目
依赖安装完成后,启动本地服务:
npm run dev启动成功后,终端会输出本地访问地址http://localhost:端口号,浏览器打开即可看到博客首页。
3.4 项目打包(部署必备)
本地调试无误后,执行打包命令,生成可上线的静态文件:
npm run build打包完成后,项目目录会多出dist文件夹,这就是我们需要上传到服务器的核心文件。
四、云服务器环境搭建教学(全程命令复制)
服务器初始化环境是部署核心步骤,我整理好所有一键安装命令,直接复制执行即可,无需手动复杂配置。
4.1 服务器连接准备
使用Xshell、FinalShell等工具连接服务器,输入服务器公网IP、账号密码,成功登录终端。
4.2 安装Git
yum install git -y4.3 安装Node.js环境
curl -sL https://rpm.nodesource.com/setup_18.x | bash - yum install nodejs -y安装完成后,输入以下命令验证版本,出现版本号即为成功:
node -v npm -v4.4 安装PM2进程守护工具
PM2可以保证项目后台永久运行,关闭终端网站也不会掉线:
npm install pm2 -g4.5 安装Nginx服务
yum install nginx -y systemctl start nginx systemctl enable nginx启动成功后,浏览器输入服务器IP,出现Nginx默认页面即为环境搭建完成。
五、项目服务器正式部署教学(上线核心步骤)
5.1 上传项目文件
在服务器新建博客项目文件夹,将本地打包好的dist文件夹所有文件上传至服务器对应目录。
5.2 Nginx核心配置修改
打开Nginx配置文件,替换为以下适配博客项目的配置:
server { listen 80; server_name 你的域名/服务器IP; root /usr/local/blog/dist; index index.html; location / { try_files $uri $uri/ /index.html; } # 配置缓存优化,提升网站访问速度 location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ { expires 30d; } }5.3 检查配置并重启Nginx
配置完成后,校验配置是否有误:
nginx -t显示success即为配置正确,重启Nginx生效:
systemctl restart nginx5.4 放行服务器防火墙端口
很多新手部署成功无法访问,就是因为端口未放行,执行以下命令放行80、443端口:
firewall-cmd --permanent --add-port=80/tcp firewall-cmd --permanent --add-port=443/tcp firewall-cmd --reload此时浏览器输入服务器公网IP,即可成功访问个人博客网站!
六、域名解析+HTTPS证书配置
想要网站更正规、方便记忆,可配置自定义域名+免费HTTPS证书,实现全网安全访问。
6.1 域名解析设置
进入域名服务商后台,添加解析记录:
主机记录:www / @
记录类型:A记录
记录值:填写服务器公网IP
TTL:默认10分钟
解析生效时间一般为1-10分钟,生效后即可通过域名访问网站。
6.2 免费HTTPS证书配置
借助宝塔/阿里云免费证书,下载证书文件上传至服务器,修改Nginx配置,开启HTTPS加密访问,解决浏览器不安全提示,配置完成后网站自带绿色安全标识。
七、全网高频报错排查与终极避坑指南
我整理了部署过程中99%新手会遇到的报错问题,附带精准解决方案,遇到问题直接对照排查。
7.1 依赖安装失败、npm报错
原因:Node版本过高、网络波动、缓存冲突
解决方案:降级至Node18稳定版,清理缓存后重新安装依赖
7.2 部署成功无法外网访问
原因:服务器防火墙端口未放行、安全组未开放80端口
解决方案:服务器后台放行端口,云服务器控制台安全组添加80、443端口放行规则
7.3 页面空白、刷新404
原因:Nginx路由配置缺失
解决方案:添加
try_files $uri $uri/ /index.html;路由适配配置
7.4 网站访问卡顿、加载慢
原因:静态资源未缓存、资源压缩未开启
解决方案:配置Nginx静态资源缓存,开启gzip压缩
八、网站后期优化与运维教学
8.1 项目后台常驻运行
通过PM2工具托管项目,实现服务器重启自动上线、异常自动重启,保证网站24小时稳定运行。
8.2 数据备份教学
定期备份博客文章、配置文件,避免服务器异常导致数据丢失,简单一键备份命令,新手可直接定时执行。
8.3 SEO收录优化
配置网站sitemap、robots文件,提交百度收录,让自己的博客文章被搜索引擎抓取,获取免费搜索流量。
九、总结与源码领取
本篇教程从环境准备、本地搭建、项目打包、服务器部署、Nginx配置、域名上线、HTTPS加密、报错避坑、后期运维全覆盖,是目前全网最完整、适配2026版本的个人博客系统部署教学。
全程无套路、无删减、无跳步,零基础小白只要跟着步骤操作,百分百可以成功搭建上线自己的专属技术博客。
拥有个人博客不仅可以用来日常学习记录,还能丰富个人简历、提升技术影响力,是程序员、计算机学生必备的实战项目。