/docker-hexo-next

本项目提供了一个开箱即用的hexo私人博客解决方案,并且集成了高人气的next主题。

Primary LanguageDockerfileMIT LicenseMIT

如何使用 docker-hexo-next

Github地址

Docker仓库地址

Demo地址

本项目提供了一个开箱即用的hexo私人博客解决方案,并且集成了高人气的next主题。

通过使用docker镜像,在免去了繁杂的环境配置和安装的同时,也提供了简单但灵活的主题配置方式和博客更新打包方式。

所有的依赖只有docker

快速启动

只需要执行如下命令,即可启动你自己的hexo博客

docker run -d -p 3000:4000 josiahzhao/docker-hexo-next:latest

如果需要对博客内容进行持久化存储,使用下面的语句启动即可

docker run -d -p 3000:4000 -v {你的本地路径}/source:/hexo/website/source josiahzhao/docker-hexo-next:latest

"{你的本地路径}/source"就是你的博客的数据库目录: 所有的配置、文档都在里面,后续备份和迁移部署只需要对这个目录进行操作即可

随后访问宿主机IP的3000端口即可,如图

  1. "{你的本地路径}/source"请填写本机实际存在的有读写权限的地址
  2. 如果对docker命令不熟悉请参考 docker运行命令使用方式
  3. 启动时,如果"{你的本地路径}/source"是空白的话,则会生成一份模板文件,后续可以直接在模板下进行创作和主题配置调整
  4. 启动时,如果"{你的本地路径}/source"已经有之前编辑的内容,则直接用历史数据启动;所以如果想要迁移部署很简单,将这台机器的"{你的本地路径}/source"拷贝走即可

如何维护文档

如上图,可以将撰写的md文档存储_posts目录即可

source目录就是官方文档中的source目录,也可直接参见官方文档-如何写作

如何修改配置

  • 修改hexo配置

hexo的配置如网站标题,描述,作者,时间格式等基础信息

上图中的source/_custom.yml就是官方的配置文件 (容器启动时通过--config source/_custom.yml将配置文件指向了这里)

所以按照官方文档-配置说明即可进行配置

  • 修改next主题配置

同样也存储在的source/_custom.yml,将配置写在theme_config下即可,如官方文档-主题配置说明

针对next主题可以支持的修改项,可以参考next官方文档-主题配置说明