Sign inSign up

bloodstar/hexo

By bloodstar

•Updated 3 days ago

Hexo Docker One-Click Deployment Environment/一键部署环境 Add cjk support 附赠详细教程

Image
22

50K+

bloodstar/hexo repository overview

Docker Pulls Docker Image Version Build Status

⁠bloodstar/hexo

Hexo blog environment Docker image — zero-config, no need to install Node.js / npm / Hexo locally.

Source repository: github.com/appotry/docker-hexo⁠ — issues, PRs, docs, multi-language README


⁠Quick Start

docker create --name=hexo \
  -e HEXO_SERVER_PORT=4000 \
  -e GIT_USER="yourname" \
  -e GIT_EMAIL="[email protected]" \
  -v /path/to/blog:/app \
  -p 4000:4000 \
  bloodstar/hexo

docker start hexo

On first start, if /app is empty, the container automatically runs hexo init and installs common plugins.

⁠Environment Variables

VariableDefaultDescription
HEXO_SERVER_PORT4000Hexo server listening port
GIT_USER—Git global username
GIT_EMAIL—Git global email

⁠SSH Keys

SSH keys are auto-generated at /app/.ssh on first start. Add the public key to GitHub for deployment.

docker exec hexo cat /app/.ssh/id_rsa.pub

GitHub SSH key tutorial⁠

⁠User Customization

⁠userRun.sh

Create /app/userRun.sh in your blog volume to run custom commands on container startup.

#!/bin/bash
cnpm install --save hexo-generator-search hexo-related-popular-posts
⁠requirements.txt

Add a requirements.txt file to your blog volume (one npm package per line). Packages auto-install on startup:

hexo-generator-json-content
hexo-generator-feed

⁠Common Commands

ActionCommand
Enter containerdocker exec -it hexo bash
View logsdocker logs --follow hexo
Restart pm2docker exec hexo pm2 restart /hexo_run.js
Restart containerdocker restart hexo
Generate static filesdocker exec hexo hexo g
Deploy to remotedocker exec hexo hexo d
New postdocker exec hexo hexo new post "My Title"
New pagedocker exec hexo hexo new page "music"
Clean cachedocker exec hexo hexo clean

⁠Documentation

DocumentDescriptionLink
English READMEFull English documentationREADME.en.md⁠
简体中文完整中文说明README.md⁠
繁體中文完整繁體中文說明README.zh-TW.md⁠
日本語日本語ドキュメントREADME.ja.md⁠
한국어한국어 문서README.ko.md⁠
EspañolDocumentación completa en españolREADME.es.md⁠
FrançaisDocumentation complète en françaisREADME.fr.md⁠
DeutschVollständige Dokumentation auf DeutschREADME.de.md⁠
PortuguêsDocumentação completa em portuguêsREADME.pt.md⁠
РусскийПолная документация на русскомREADME.ru.md⁠
العربيةالوثائق الكاملة باللغة العربيةREADME.ar.md⁠
ArchitectureComponents & data flowdocs/ARCHITECTURE.md⁠
RequirementsFunctional & non-functionaldocs/REQUIREMENTS.md⁠
TestingTest strategy & verificationdocs/TESTING.md⁠
ChangelogVersion historydocs/CHANGELOG.md⁠

⁠Tags

TagDescription
latestLatest stable build
node20Latest build based on Node.js 20
{hexo-ver}-node20Specific hexo + node version (e.g. 7.3.0-node20)

⁠Resources

Tag summary

Content type

Image

Digest

sha256:0353da45b…

Size

306 MB

Last updated

3 days ago

docker pull bloodstar/hexo