Nginx + Hexo 二级域名部署完整指南

┌─────────────────────────────────────────────────────────────┐
│                    部署方式对比                             │
├──────────────────┬──────────────────┬───────────────────────┤
│     特性         │   二级域名        │      子目录           │
├──────────────────┼──────────────────┼───────────────────────┤
│ 示例             │ blog.example.com │ example.com/blog/     │
│ SEO 权重         │ 独立权重          │ 共享主域名权重         │
│ Cookie 隔离      │ ✅ 完全隔离       │ ❌ 共享 Cookie         │
│ 部署灵活性       │ ✅ 可部署在不同服务器│ ❌ 必须在同一服务器   │
│ 配置复杂度       │ 中等             │ 简单                  │
│ SSL 证书         │ 泛域名证书覆盖    │ 单证书即可            │
│ 推荐场景         │ 独立业务/博客     │ 简单子页面            │
└──────────────────┴──────────────────┴───────────────────────┘

必备条件:
  - 已备案的主域名（如：zysicyj.top）
  - 域名 DNS 管理权限
  - 一台 Linux 服务器（CentOS/Ubuntu/TencentOS）
  - 服务器公网 IP 地址

软件环境:
  - Node.js 16+ 
  - Nginx 1.20+
  - Git
  - Certbot（SSL 证书工具）

# 检查 Node.js 版本
node --version
# 预期输出：v16.x.x 或更高

# 检查 Nginx 版本
nginx -v
# 预期输出：nginx version: nginx/1.20.x 或更高

# 检查 Git
git --version

# 检查域名解析
ping zysicyj.top

# 检查服务器公网 IP
curl ifconfig.me

┌─────────────────────────────────────────────────────────────┐
│                    本文示例环境                             │
├─────────────────────────────────────────────────────────────┤
│  主域名：zysicyj.top                                        │
│  二级域名：blog.zysicyj.top                                 │
│  服务器 IP: [你的服务器公网 IP]                               │
│  操作系统：TencentOS Server 4                               │
│  Nginx 版本：1.26.3                                         │
│  Node.js 版本：v24.13.1                                     │
│  Hexo 版本：7.x                                             │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    DNS 记录类型说明                         │
├──────────────┬──────────────────────────────────────────────┤
│  记录类型     │  说明与用途                                  │
├──────────────┼──────────────────────────────────────────────┤
│  A 记录       │  将域名指向 IPv4 地址（最常用）                │
│  AAAA 记录    │  将域名指向 IPv6 地址                         │
│  CNAME 记录   │  将域名指向另一个域名（别名）                 │
│  TXT 记录     │  文本记录（用于 SSL 验证、SPF 等）            │
│  MX 记录      │  邮件交换记录（用于邮箱）                     │
│  NS 记录      │  域名服务器记录                               │
└──────────────┴──────────────────────────────────────────────┘

用户访问流程：
┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│  用户     │ ──→ │ DNS 服务器 │ ──→ │  服务器   │ ──→ │  Hexo    │
│ 浏览器   │     │  解析     │     │  Nginx   │     │  博客    │
└──────────┘     └──────────┘     └──────────┘     └──────────┘
     │                │                │                │
     │ 1. 输入        │                │                │
     │    blog.       │                │                │
     │    zysicyj.top │                │                │
     │                │                │                │
     │────────────────→ 2. 查询 DNS    │                │
     │                │                │                │
     │                │ 3. 返回服务器 IP │                │
     │←───────────────│                │                │
     │                │                │                │
     │ 4. 访问服务器 IP │───────────────→│                │
     │    (Host: blog)│                │                │
     │                │                │                │
     │                │                │ 5. Nginx 根据   │
     │                │                │    Host 转发    │
     │                │                │    到 Hexo      │
     │                │                │                │
     │ 6. 显示博客页面 │←───────────────│←───────────────│
     │                │                │                │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    添加 DNS 记录                            │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  记录类型：A                                                 │
│                                                             │
│  主机记录：blog        ← 这就是二级域名的前缀                │
│                                                             │
│  线路类型：默认        ← 所有用户都解析到此 IP               │
│                                                             │
│  记录值：[你的服务器公网 IP]  ← 填写你的服务器 IP             │
│                                                             │
│  TTL：600 秒           ← 缓存时间，越短生效越快              │
│                                                             │
│  [确认添加]                                                  │
│                                                             │
└─────────────────────────────────────────────────────────────┘

# 方法 1：使用 ping 命令
ping blog.zysicyj.top

# 预期输出：
# PING blog.zysicyj.top (你的服务器 IP) 56(84) bytes of data.

# 方法 2：使用 dig 命令
dig blog.zysicyj.top

# 预期输出中的 ANSWER 部分：
# ;ANSWER:
# blog.zysicyj.top.    600    IN    A    你的服务器 IP

# 方法 3：使用 nslookup
nslookup blog.zysicyj.top

# 预期输出：
# Name:   blog.zysicyj.top
# Address: 你的服务器 IP

# 使用在线工具检查全球 DNS 传播状态
# 访问以下网站输入你的域名：

# 1. DNS Checker
https://dnschecker.org/

# 2. WhatsMyDNS
https://www.whatsmydns.net/

# 3. 站长工具
http://tool.chinaz.com/dns/

┌─────────────────────────────────────────────────────────────┐
│                    DNS 传播时间参考                         │
├──────────────────┬──────────────────────────────────────────┤
│  服务商          │  预计生效时间                           │
├──────────────────┼──────────────────────────────────────────┤
│  腾讯云 DNSPod    │  1-5 分钟                                │
│  阿里云 DNS      │  1-10 分钟                               │
│  Cloudflare     │  即时 -5 分钟                             │
│  GoDaddy        │  5-30 分钟                               │
│  其他小服务商    │  最长 72 小时                             │
└──────────────────┴──────────────────────────────────────────┘

# Windows
ipconfig /flushdns

# macOS
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

# Linux (systemd-resolved)
sudo systemd-resolve --flush-caches

# Linux (nscd)
sudo systemctl restart nscd

# 使用 NVM 安装 Node.js（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

source ~/.bashrc

nvm install --lts
nvm use --lts

# 验证安装
node --version
npm --version

/root/blog/
├── _config.yml          # 站点配置文件
├── _config.landscape.yml # 主题配置文件
├── scaffolds/           # 文章模板
│   ├── draft.md
│   ├── page.md
│   └── post.md
├── source/              # 源文件目录
│   ├── _posts/          # 文章目录
│   ├── _drafts/         # 草稿目录
│   └── favicon.png      # 网站图标
├── themes/              # 主题目录
│   └── landscape/       # 默认主题
├── public/              # 生成的静态文件（部署时使用）
└── package.json         # 项目配置

# 站点配置
title: 我的技术博客
subtitle: 记录技术成长的点点滴滴
description: 专注于 Web 开发、运维技术、安全实践
keywords: 技术博客，Web 开发，运维，安全，Hexo
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai

# URL 配置
url: https://blog.zysicyj.top
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:

# 目录配置
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: download/code
i18n_dir: :lang
skip_render:

# 写作配置
new_post_name: :title.md
default_layout: post
titlecase: false
external_link:
  enable: true
  field: site
  exclude: ''
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
syntax_highlighter: highlight.js
highlight:
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false

# 首页配置
index_generator:
  path: ''
  per_page: 10
  order_by: -date

# 日期格式
date_format: YYYY-MM-DD
time_format: HH:mm:ss
updated_option: mtime

# 分页配置
per_page: 10
pagination_dir: page

# 扩展配置
include:
exclude:
ignore:

---
title: 我的第一篇博客文章
date: 2026-03-04 12:00:00
tags:
  - Hexo
  - 博客
categories:
  - 生活
cover: /images/first-post.jpg
---

这是文章正文内容...

# 生成静态文件到 public 目录
hexo generate

# 或简写
hexo g

# 生成并部署
hexo generate --deploy

# 查看生成的文件
ls -la public/

┌─────────────────────────────────────────────────────────────┐
│                    反向代理架构说明                         │
│                                                             │
│  用户 → Nginx(443) → 反向代理 → Hexo(4000)                  │
│                                                             │
│  优势：                                                      │
│  • SSL 终止：Nginx 处理 HTTPS，Hexo 只需处理 HTTP            │
│  • 静态文件缓存：Nginx 直接提供静态文件                      │
│  • 安全隔离：Hexo 不直接暴露在公网                         │
│  • 灵活扩展：可以轻松添加多个二级域名                        │
│  • 权限简化：Nginx 用户无需访问 Hexo 目录                     │
└─────────────────────────────────────────────────────────────┘

# HTTP - 自动跳转 HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name blog.zysicyj.top;
    
    # ACME 挑战目录（用于 SSL 证书续签）
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
    }
    
    # 所有 HTTP 请求跳转到 HTTPS
    location / {
        return 301 https://$host$request_uri;
    }
    
    # 日志
    access_log /var/log/nginx/blog.zysicyj.top_access.log;
    error_log /var/log/nginx/blog.zysicyj.top_error.log;
}

# HTTPS - Hexo 博客
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name blog.zysicyj.top;
    
    # SSL 证书配置
    ssl_certificate /etc/letsencrypt/live/zysicyj.top/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/zysicyj.top/privkey.pem;
    
    # SSL 优化配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    ssl_session_tickets off;
    
    # 安全头
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    
    # 反向代理到 Hexo
    location / {
        proxy_pass http://127.0.0.1:4000;
        proxy_set_header Host $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;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_cache_bypass $http_upgrade;
        proxy_read_timeout 90;
    }
    
    # 日志
    access_log /var/log/nginx/blog.zysicyj.top_access.log;
    error_log /var/log/nginx/blog.zysicyj.top_error.log;
}

# 测试 Nginx 配置
sudo nginx -t

# 预期输出：
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

# 重载 Nginx
sudo nginx -s reload

# 检查 Nginx 状态
sudo systemctl status nginx

# 进入博客目录
cd /root/blog

# 后台启动 Hexo
nohup hexo server --port 4000 > /var/log/hexo.log 2>&1 &

# 查看日志
tail -f /var/log/hexo.log

# 预期输出：
# INFO  Hexo is running at http://localhost:4000/

# 测试 HTTP 跳转
curl -I http://blog.zysicyj.top

# 预期输出：HTTP/1.1 301 Moved Permanently
#          Location: https://blog.zysicyj.top/

# 测试 HTTPS 访问
curl -I https://blog.zysicyj.top

# 预期输出：HTTP/2 200
#          content-type: text/html

# 检查续签配置
cat /etc/letsencrypt/renewal/zysicyj.top.conf

# 测试续签
sudo certbot renew --dry-run

# 启用自动续签定时任务
sudo systemctl enable --now certbot-renew.timer

# 查看定时任务状态
systemctl list-timers | grep certbot

# OCSP Stapling（提升 SSL 握手速度）
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/zysicyj.top/chain.pem;
resolver 8.8.8.8 8.8.4.4 valid=300s;
resolver_timeout 5s;

# DH 参数（提升密钥交换安全性）
# 生成命令：openssl dhparam -out /etc/nginx/dhparam.pem 2048
ssl_dhparam /etc/nginx/dhparam.pem;

# HSTS（强制 HTTPS）
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;

# ==================== blog.zysicyj.top ====================
server {
    listen 80;
    server_name blog.zysicyj.top;
    location /.well-known/acme-challenge/ { root /var/www/certbot; }
    location / { return 301 https://$host$request_uri; }
}

server {
    listen 443 ssl http2;
    server_name blog.zysicyj.top;
    
    ssl_certificate /etc/letsencrypt/live/zysicyj.top/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/zysicyj.top/privkey.pem;
    
    location / {
        proxy_pass http://127.0.0.1:4000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    
    access_log /var/log/nginx/blog_access.log;
    error_log /var/log/nginx/blog_error.log;
}

# ==================== docs.zysicyj.top ====================
server {
    listen 80;
    server_name docs.zysicyj.top;
    location /.well-known/acme-challenge/ { root /var/www/certbot; }
    location / { return 301 https://$host$request_uri; }
}

server {
    listen 443 ssl http2;
    server_name docs.zysicyj.top;
    
    ssl_certificate /etc/letsencrypt/live/zysicyj.top/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/zysicyj.top/privkey.pem;
    
    root /root/docs/public;
    index index.html;
    
    location / {
        try_files $uri $uri/ =404;
    }
    
    access_log /var/log/nginx/docs_access.log;
    error_log /var/log/nginx/docs_error.log;
}

# ==================== wiki.zysicyj.top ====================
# 类似配置...

#!/bin/bash

# Hexo 多实例管理脚本

ACTION=$1
SITE=$2

case "$ACTION" in
    start)
        case "$SITE" in
            blog)
                cd /root/blog && nohup hexo server --port 4000 > /var/log/hexo-blog.log 2>&1 &
                echo "Blog started on port 4000"
                ;;
            docs)
                cd /root/docs && nohup hexo server --port 4001 > /var/log/hexo-docs.log 2>&1 &
                echo "Docs started on port 4001"
                ;;
            *)
                echo "Usage: $0 start {blog|docs}"
                exit 1
                ;;
        esac
        ;;
    stop)
        case "$SITE" in
            blog)
                pkill -f "hexo.*4000"
                echo "Blog stopped"
                ;;
            docs)
                pkill -f "hexo.*4001"
                echo "Docs stopped"
                ;;
            *)
                echo "Usage: $0 stop {blog|docs}"
                exit 1
                ;;
        esac
        ;;
    restart)
        $0 stop $SITE
        sleep 2
        $0 start $SITE
        ;;
    status)
        echo "=== Hexo Instances Status ==="
        echo "Blog (4000): $(pgrep -f 'hexo.*4000' > /dev/null && echo 'Running' || echo 'Stopped')"
        echo "Docs (4001): $(pgrep -f 'hexo.*4001' > /dev/null && echo 'Running' || echo 'Stopped')"
        ;;
    *)
        echo "Usage: $0 {start|stop|restart|status} {blog|docs}"
        exit 1
        ;;
esac

# 症状
ping blog.zysicyj.top
# ping: cannot resolve blog.zysicyj.top: Unknown host

# 排查步骤
# 1. 检查 DNS 记录是否正确添加
dig blog.zysicyj.top @8.8.8.8

# 2. 检查 DNS 传播状态
# 访问 https://dnschecker.org/

# 3. 刷新本地 DNS 缓存
# Windows: ipconfig /flushdns
# macOS: sudo dscacheutil -flushcache
# Linux: sudo systemd-resolve --flush-caches

# 解决方案
# 等待 DNS 传播（通常 1-10 分钟）
# 检查 DNS 记录是否填写正确

# 症状
# 访问博客显示 502 错误

# 排查步骤
# 1. 检查 Hexo 是否运行
ps aux | grep hexo

# 2. 检查 Hexo 日志
tail -f /var/log/hexo.log

# 3. 检查 Nginx 错误日志
tail -f /var/log/nginx/blog_error.log

# 4. 测试端口连通性
curl http://127.0.0.1:4000

# 解决方案
# 重启 Hexo
cd /root/blog && pkill -f hexo && nohup hexo server --port 4000 > /var/log/hexo.log 2>&1 &

# 症状
# 访问超时

# 排查步骤
# 1. 检查 Hexo 是否响应慢
# 2. 检查服务器负载
top -bn1 | head -20

# 解决方案
# 增加超时时间
proxy_read_timeout 180;
proxy_connect_timeout 180;

# 症状
# 浏览器显示证书错误

# 排查步骤
# 1. 检查证书是否过期
openssl x509 -in /etc/letsencrypt/live/zysicyj.top/fullchain.pem -text -noout | grep -A2 "Validity"

# 2. 检查证书域名是否匹配
openssl x509 -in /etc/letsencrypt/live/zysicyj.top/fullchain.pem -text -noout | grep -A1 "Subject Alternative Name"

# 解决方案
# 续签证书
certbot renew --force-renewal

# 症状
# hexo server 命令报错

# 排查步骤
# 1. 检查 Node.js 版本
node --version

# 2. 检查依赖是否安装
cd /root/blog && npm install

# 3. 检查端口是否被占用
lsof -i :4000

# 解决方案
# 清理并重新安装
cd /root/blog
rm -rf node_modules package-lock.json
npm install

# 症状
# 新写的文章在博客上不显示

# 排查步骤
# 1. 检查文章 Front-matter
cat source/_posts/your-article.md

# 2. 检查文章日期是否在未来
# future: true 配置允许显示未来日期的文章

# 3. 重新生成
hexo clean && hexo generate

# 解决方案
# 确保文章 Front-matter 正确
---
title: 文章标题
date: 2026-03-04 12:00:00
published: true
---

# 排查步骤
# 1. 检查 Nginx 配置
nginx -t

# 2. 检查 server_name 是否正确
grep -A5 "listen 80" /etc/nginx/conf.d/blog.conf

# 3. 重载 Nginx
nginx -s reload

# 解决方案
# 确保 HTTP server 块中有跳转配置
location / {
    return 301 https://$host$request_uri;
}

# 开启 Gzip 压缩
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_proxied expired no-cache no-store private auth;
gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml application/javascript application/json;
gzip_disable "MSIE [1-6]\.";

# 静态文件缓存
location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2|ttf|eot)$ {
    expires 30d;
    add_header Cache-Control "public, immutable";
}

# HTML 不缓存
location ~* \.html$ {
    expires -1;
    add_header Cache-Control "no-cache, no-store, must-revalidate";
}

# _config.yml 优化配置
# 启用代码高亮
highlight:
  enable: true
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false

# 生成配置
generator:
  # 禁用生成器以加快生成速度
  disable: false

# 部署配置
deploy:
  type: ''

# DNS 验证
dig blog.zysicyj.top +short

# Nginx 配置测试
nginx -t && nginx -s reload

# Hexo 管理
cd /root/blog && hexo generate && hexo server

# 查看日志
tail -f /var/log/nginx/blog_access.log
tail -f /var/log/hexo.log

# 证书管理
certbot certificates
certbot renew --dry-run

# 综合检查脚本
cat > /usr/local/bin/check-blog.sh << 'EOF'
#!/bin/bash
echo "=== 博客健康检查 ==="
echo "1. DNS 解析检查"
dig blog.zysicyj.top +short
echo ""
echo "2. Nginx 状态检查"
systemctl is-active nginx
echo ""
echo "3. Hexo 进程检查"
pgrep -f hexo > /dev/null && echo "Hexo 运行中" || echo "Hexo 未运行"
echo ""
echo "4. SSL 证书检查"
openssl x509 -in /etc/letsencrypt/live/zysicyj.top/fullchain.pem -noout -dates
echo ""
echo "5. 端口检查"
ss -tlnp | grep -E ":(80|443|4000)"
EOF
chmod +x /usr/local/bin/check-blog.sh