老铁们，你是不是也经历过这样的纠结？

想写博客，用 Hexo 嘛，确实很香：免费、快速、Markdown 写作。但一想到要在本地电脑上装 Node.js、配置各种环境依赖，甚至还可能遇到版本冲突，就有点头大。尤其是当你换一台电脑，或者想在不同系统上部署，那种“重新配置环境”的痛苦，简直是噩梦！

“有没有一种办法，能让我享受 Hexo 的丝滑，又不用污染我的本地环境，甚至能实现博客环境的‘随身携带’？”

有！今天，我就要带你进入一个全新的境界——用 Docker 搭建你的 Hexo 博客！

这不仅仅是搭建博客，更是搭建一个 “永不崩溃、环境纯净、可随时迁移” 的博客工作站！

使用到的项目地址：https://github.com/appotry/docker-hexo

为什么用 Docker 来跑 Hexo？它到底“香”在哪里？

你可能听过 Docker，知道它是个“容器”技术，但具体怎么用在博客上，又有什么好处呢？

简单来说，用 Docker 跑 Hexo，就像是给你的 Hexo 博客量身定制了一个独立的小房间。 这个房间里，Node.js、Hexo 框架、各种依赖，所有需要的东西都打包在里面，互不干扰。

它的“香”点，简直是为我们这些懒人、爱折腾又怕麻烦的人量身打造：

1. 告别“环境地狱”： 这是最大的优点！你的本地电脑不需要安装 Node.js、npm，甚至是 Hexo-cli！所有这些都运行在 Docker 容器里。从此告别版本冲突、依赖问题，你的本地开发环境保持极致纯净。
2. “开箱即用”，一步到位： Docker 镜像里已经预装好了 Hexo 运行所需的一切。你只需要拉取镜像，启动容器，就能直接开始写博客、生成、部署，省去了大量的环境配置时间。
3. 多电脑同步，无缝切换： 无论你在家里的台式机，还是公司的笔记本，甚至是借朋友的电脑，只要装了 Docker，把你的博客项目文件夹一挂载，就能立即进入你的博客工作状态，写作、发布一气呵成。
4. 环境一致性，永不崩溃： 容器化保证了每次运行的环境都一模一样，不会因为你本地系统更新、安装了其他软件而导致 Hexo 罢工。你的博客环境，永远稳定如初。
5. 方便迁移和备份： 你的博客所有内容（文章、配置、主题）都集中在一个文件夹里。用 Docker 跑，这个文件夹就是你的“宝藏”。备份这个文件夹，就备份了整个博客。迁移起来更是方便，新电脑装 Docker，把文件夹一复制，搞定！

一句话总结：Docker 让 Hexo 从“在你电脑上搭建”，变成了“把你的博客环境打包带走”！

准备工作：就一个！

你只需要在你的电脑上安装 Docker，建议使用linux服务器进行部署。安装教程这里不再赘述，看我之前的文章。

安装好 Docker，咱们就开始施展魔法了！

Docker + Hexo 搭建博客：手把手教学！

我们的核心思路是：把你的 Hexo 博客文件（文章、主题、配置等）放在本地一个文件夹里，然后把这个文件夹“映射”到 Docker 容器里，让容器内的 Hexo 访问和操作它。 Docker镜像已经内置了hexo和一下常用的插件。

第一步：部署 Hexo Docker 镜像

Docker Cli部署：

1
2
3
4
5
6
7

docker create --name=hexo \
-e HEXO_SERVER_PORT=4000 \
-e GIT_USER="17lai" \
-e GIT_EMAIL="17lai@domain.tld" \
-v /mnt/blog:/app \
-p 4000:4000 \
jumploop/hexo

docker compose部署

推荐使用 docker compose 来管理docker

docker-compose.yml内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

services:
    hexo:
        container_name: hexo
        image: jumploop/hexo:latest
        hostname: hexo
        ports:
            - '7800:4000'
        volumes:
            - ${USERDIR}/hexo/blog:/app
        env_file:
            - .env # 部分公用环境变量放到这里，以使得多个docker之间共享环境变量
        environment:
            - PUID=${PUID}
            - PGID=${PGID}
            - TZ=${TZ}
            - GIT_USER="yourName"
            - GIT_EMAIL="youID@gmail.com"

            # 主要为了内部npm网络访问顺利
            # - HTTP_PROXY=http://192.168.0.100:1089
            # - HTTPS_PROXY=http://192.168.0.100:1089
        restart: always

.env 文件示例

1
2
3
4
5
6
7

# Copy this file to .env before building the container.
# Put any local modifications here.

PUID=1000
PGID=1000
TZ="Asia/Shanghai"
USERDIR="/share/Container"

环境变量

创建好博客目录，修改好配置，执行下面命令，进行部署

1

docker compose up -d

浏览器输入http://你的服务器IP:4000，就可以看到博客页面了

第二步： ssh key 部署

Docker会自动随机生成ssh key 在 /app/.ssh 目录下面。自动部署请把ssh key添加到github 等平台。

1. 将SSH 公钥复制到剪贴板。
2. 在任何页面的右上角，单击您的个人资料照片，然后单击Settings（设置）。
3. 在用户设置侧边栏中，单击SSH and GPG keys（SSH 和GPG 密钥）。
4. 单击New SSH key（新SSH 密钥）或Add SSH key（添加SSH 密钥）。

进入docker

1

docker exec -it hexo bash

然后就可以正常运行hexo的各种命令了，是不是非常简单？ 快来试试吧。
第三步：博客的基础配置

打开你本地博客文件夹里的 _config.yml 文件，找到Site，配置站点信息

1
2
3
4
5
6
7

title: 小明同学 # 标题
subtitle: '个人博客' # 副标题
description: '一个用于知识记录与分享的博客网站' # 网站描述
keywords: linux,devops,driver,hexo,html5,ccs3,debian,git,gitbook,vps,gitlab,mysql,vim,ai,docker,blog,note,nas
author: 小明同学 # 作者
language: zh-CN # 语言
timezone: 'Asia/Shanghai' # 时区

_config.yml 文件的其它修改建议:

• 请修改 _config.yml 的 url 的值为你的网站主 URL（如：http://xxx.github.io）。
• 建议修改两个 per_page 的分页条数值为 6 的倍数，如：12、18 等，这样文章列表在各个屏幕下都能较好的显示。
• 如果你是中文用户，则建议修改 language 的值为 zh-CN。

效果展示

第四步：发布到互联网（GitHub Pages / Gitee Pages）

准备工作： 1.注册 GitHub 账号： 如果你还没有，赶紧去 github.com 注册一个。2.创建新仓库： 在 GitHub 上创建一个新的仓库 (Repository)，仓库名称必须是 你的GitHub用户名.github.io (例如，如果你的用户名是 zhangsan，那么仓库名就是 zhangsan.github.io)。

部署
如果你想把博客部署到 GitHub Pages 或 Gitee Pages，你需要配置 _config.yml 文件，并安装 hexo-deployer-git 插件。1.安装部署插件：
Docker镜像已经内置该插件，可以不用再安装

1

cnpm install hexo-deployer-git --save

2.配置 _config.yml：
打开你本地博客文件夹里的 _config.yml 文件，拉到最底部，修改 deploy: 部分。例如部署到 GitHub Pages：

1
2
3
4

deploy:
    type: git
    repo: git@github.com:你的GitHub用户名/你的GitHub用户名.github.io.git # 替换成你自己的仓库地址
    branch: master # 或者 main，取决于你的 GitHub 仓库默认分支名

保存文件。

3.生成并部署！

1

hexo clean && hexo generate && hexo deploy

稍等片刻，你的博客就上线了！访问 https://你的GitHub用户名.github.io 就能看到。

怎么写文章？

你只需要在你本地博客文件夹的 source/_posts 目录下，用 Markdown 格式创建新的 .md 文件即可。

比如，在你的本地博客文件夹里，执行：

1
2
3
4

# 注意，这里我们直接在本地创建文件，因为 Hexo 的新文章命令会直接操作文件系统，
# 而我们已经把本地文件夹映射到了容器内，所以直接在本地操作即可。
# 如果你想用容器内的 hexo new 命令，也可以：
hexo new post "我的Docker Hexo初体验"

然后用你喜欢的编辑器打开 source/_posts/我的Docker Hexo初体验.md，开始你的写作！

hexo 支持实时预览修改效果，文章主题的修改，都可以通过web服务立刻看到效果。

如果你发现了修改没有立刻生效，可能是 node 缓存还在，可以使用下面方法重启 web 服务

1
2
3
4
5

# 重启 pm2，需要进到容器执行
pm2 restart /hexo_run.js

# 重启 hexo docker
docker restart hexo

写完后，确认无误后，重复第四步的部署命令即可发布。然后通过访问 https://你的GitHub用户名.github.io 就能看到最新的修改。

总结：Docker + Hexo，让你的博客之路“一劳永逸”！

用 Docker 运行 Hexo，可能初看起来比直接安装 Hexo 稍微多一步，但它带来的环境隔离、一致性、以及无与伦比的便捷性，绝对是值得的！

从此，你的博客环境不再受本地电脑的“污染”，无论你在哪里，都能随时随地、优雅地写作和发布。这不仅仅是搭建博客，更是搭建了一个高效、稳定、可移植的个人内容发布系统！

所以，别再犹豫了！赶紧动手，用 Docker 打造你的专属 Hexo 博客工作站吧！你会发现，它的“真香”程度，远超你的想象！

觉得这个教程有用？别忘了点赞、转发给身边想写博客的朋友们！咱们下期再见！👋

玩 Docker 的朋友，大概分为两派。

一派是“命令行原教旨主义者”，黑框框里敲代码，觉得特极客，但一旦容器多了，改个参数能把人累死；

另一派是“Portainer 忠实信徒”，功能那是真强大，强大到像开了一艘航母去买菜——有时候我只是想改个端口映射，它那一层层的菜单看得我脑壳疼。

我就一直在想：有没有那种，既有图形界面的直观，又能像代码一样干净利落的工具？

最近，那个开发了神级监控工具 Uptime Kuma 的大佬（Louis Lam），带着他的新作品 Dockge 来了。

项目地址：https://github.com/louislam/dockge

我替大家试了毒，结论只有两个字：丝滑。

今天就聊聊，为什么建议你把手里的 Docker 管理工具，换成 Dockge。

01

它是真的在“管理文件”，而不是“接管系统”

很多新手用 Portainer 最大的痛点是什么？是你用它创建的容器，配置都被藏在它的数据库里。一旦 Portainer 挂了，或者你想迁移数据，那就很麻烦。

Dockge 的逻辑完全不同，它非常 “克制”。

它的核心理念是：基于 compose.yaml 文件。

你在 Dockge 的界面上创建一个服务，它实际上是在你的硬盘里实实在在地生成了一个文件夹和一个 yaml 文件。

• 你在界面上改配置，文件会自动更新。
• 你去后台用 vim 改文件，界面也会实时刷新。

这种 “所见即所得” 的安全感，对于稍微懂点技术的玩家来说，简直太治愈了。你完全不用担心被工具“绑架”，工具只是你的帮手，数据依然完全掌握在你手里。

02

“神级功能”：docker run 自动转 Compose

这绝对是 Dockge 的杀手锏，没有之一。

我们在网上找教程，或者去 GitHub 找项目部署，通常作者给的都是一行长长的 docker run 命令。

以前我们要么直接复制进终端跑（以后很难维护），要么这就得去这就得去翻文档，手动把它翻译成 Docker Compose 的格式，缩进搞错一点就报错。

在 Dockge 里，你只需要把那行 docker run 命令往输入框里一粘贴。

啪！很快啊！

它自动就给你转换成了标准的 docker.yaml 格式，端口、环境变量、挂载路径，整整齐齐地列在右边。

那一刻，我真的感觉到了对懒人的极致关怀。

03

颜值即正义，交互更顺手

如果你用过 Uptime Kuma，你就知道这个作者的审美一直在线。

Dockge 的界面非常现代化（Reactive UI），响应极快。左边是容器列表，右边是控制台和编辑器。

它甚至内置了一个网页版的终端。你需要进容器内部查看日志，或者执行个命令，直接在网页上就能操作，完全不需要再打开 SSH 客户端。

而且，它支持多代理（Agent）模式。也就是说，如果你有好几台服务器（VPS 或 NAS），你可以在一个 Dockge 界面里管理所有机器上的 Docker 容器。

04

怎么装？简单到令人发指

既然是管理 Docker 的工具，它自己当然也是用 Docker 部署的。

在你想要安装的目录（比如 /opt/stacks），创建一个目录给它，然后运行下面的命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# compose.yaml
services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      - 5001:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
      # 这里一定要注意，把你的 stack 目录映射进去
      - /opt/stacks:/opt/stacks
    environment:
      - DOCKGE_STACKS_DIR=/opt/stacks

如果无法下载compose.yaml文件，创建compose.yaml并复制上面的内容到compose.yaml文件中

1
2
3
4
5
6
7
8
9
10
11
12

# Create directories that store your stacks and stores Dockge's stack
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge

# Download the compose.yaml
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

# Start the server
docker compose up -d

# If you are using docker-compose V1 or Podman
# docker-compose up -d

启动之后，访问 http://IP:5001，创建一个账号，你就可以开始享受丝滑了。

05

实际上手操作

以青龙面板为例，我们进行演示
1.docker run 自动转 Compose

2.点击进行部署

3.点击Bash，进入容器


4.Dockge代理

写在最后

工具这东西，没有最好的，只有最顺手的。

如果你是企业级用户，需要精细的权限管理和集群编排，那 Portainer 依然是老大哥。

但如果你像我一样，是个 HomeLab 玩家、NAS 用户，或者只是想管好自己那几台 VPS，Dockge 这种“轻量、直观、不越权”的工具，绝对是目前的最佳选择。

少折腾工具，多享受服务。

这，才是玩技术的初衷嘛。

你现在主要用什么方式管理 Docker？命令行、Portainer 还是群晖/威联通/极空间自带的界面？评论区来聊聊你的“血泪史”。

好了，以上就是今天给大家分享的内容，我是爱分享的小明同学，如果今天的内容对你有帮助请记得收藏，顺便点点关注，咱们下期再见！谢谢大家~

(本文纯属技术分享，无利益相关，喜欢这类神器推荐的话，点个在看鼓励一下)