Docker部署hexo

Hexo 博客Docker部署前期准备与安装指南（Debian 示例）

前期准备工作

准备一台 Linux 操作系统的服务器（本文以 Debian 为例）

更新软件包并安装基本工具

apt-get update && apt install curl nano

---

开启 SSH 登录并启用 root 用户

手动开启 root 登录

nano /etc/ssh/sshd_config

修改以下配置：

1. PermitRootLogin prohibit-password → 修改为：PermitRootLogin yes
2. #PasswordAuthentication no → 修改为：PasswordAuthentication yes（去掉前面的 # 号）

如 root 用户尚未设置密码：

sudo passwd root

重启 SSH 服务使配置生效：

systemctl restart ssh

一键开启 root 登录 SSH

wget -q root.sh https://raw.githubusercontent.com/passeway/root/main/root.sh && chmod +x root.sh && ./root.sh

---

安装 Docker

一键安装 Docker 脚本

curl -fsSL https://get.docker.com | bash -s docker

如需设置国内镜像源（如阿里云）：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

Docker 官方已内置 docker compose 命令，无需单独安装 docker-compose。
若你习惯使用 docker-compose，也可额外安装。注意区分命令写法（有无 -）。

---

部署 Hexo 博客

安装 Hexo

1. 创建本地 Hexo 容器目录：

mkdir -p /root/data/docker/hexo && cd /root/data/docker/hexo

2. 创建 docker-compose.yml 配置文件：

nano docker-compose.yml

3. 添加以下内容：

version: '3.0'
services:
  hexo:
    container_name: hexo
    restart: always
    environment:
      - HEXO_SERVER_PORT=4000
      - TZ=Asia/Shanghai
    volumes:
      - './blog:/app'
    ports:
      - '8889:4000'
    image: spurin/hexo

按 Ctrl + X 保存，回车确认退出。

4. 启动容器（后台运行）：

docker-compose up -d

访问博客：

http://你的服务器IP或域名:8889

---

安装 Keep 主题

GitHub 仓库地址：
XPoet/hexo-theme-keep

执行以下命令：

# 进入 blog 目录
cd blog

# 克隆主题到 themes 目录
git clone https://github.com/tanwanme/keep.git themes/keep

# 替换配置文件
rm _config.yml
cp themes/keep/blog/_config.yml _config.yml
cp themes/keep/blog/_config.keep.yml _config.keep.yml

---

启用主题并安装插件

1. 进入容器内部：

docker exec -it hexo bash

2. 安装 Hexo 插件：

npm install
npm install hexo-admin --save           # 管理后台插件
npm install hexo-deployer-git --save    # Git 部署插件
hexo clean && hexo g                    # 清除缓存并生成页面
exit

3. 重启容器：

docker-compose restart hexo

浏览器访问：

http://你的服务器IP或域名:8889

---

配置说明

你可以修改以下文件来自定义博客：

• 主题配置文件：_config.keep.yml
• Hexo 主配置文件：_config.yml