Instalando Hexo en Ubuntu

por

Mascote do LinuxPro despejando uma pilha de arquivos de texto no funil do Hexo, que os transforma no site pronto exibido no notebook

Nota (2026): El howto original instalaba Node con nvm v0.35.1 en Ubuntu 16.04/18.04. Hexo 8.x pide Node ≥ 20.19. A continuación: nvm 0.40.7, LTS actual, hexo-cli sin sudo, y el flujo oficial (init, server, generate). Este sitio ejecutó Hexo durante años y migró a WordPress en 2026 — el generador sigue siendo útil para blogs estáticos.

Hexo es un generador de sitios estáticos en Node.js: entra Markdown, sale HTML, sin base de datos. GitHub Pages, Netlify, un nginx apuntando a public/. En septiembre de 2026 el paquete npm hexo está en la 8.1.2. El CLI oficial sigue npm install -g hexo-cli — pero sin root.

Contenido ocultar
1 Node via nvm (no uses sudo npm)
2 Primer blog
3 Publicar
4 Cierre

Node via nvm (no uses sudo npm)

Hexo 8.0+ requiere Node 20.19 o superior. El apt de Ubuntu va retrasado. nvm 0.40.7 (18 de agosto de 2026) instala el LTS en tu home:

sudo apt update
sudo apt install -y build-essential git curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts
node -v
npm -v

Si aparece EACCES en el npm global, el prefijo está mal — no lo arregles con sudo. nvm ya apunta el npm a ~/.nvm. Alternativa: fnm.

npm install -g hexo-cli
hexo version

Primer blog

hexo init clona el starter (tema Landscape) e instala dependencias con npm, yarn o pnpm — el que esté en el PATH:

hexo init ~/src/blog
cd ~/src/blog
hexo new "Olá, Hexo"
hexo server

Abre http://localhost:4000. El borrador queda en source/_posts/, Markdown + front-matter. Generar estático:

hexo generate
# ou: hexo g
ls public/

O public/ es lo que nginx o Pages sirven. No confirmes ese directorio — el .gitignore del starter ya lo ignora.

Publicar

GitHub Pages, en 2026, es Action, no solo hexo-deployer-git no gh-pages. La docs oficial: hexo.io/docs/github-pages. Deploy por rsync/git aún existe:

npm install hexo-deployer-git --save
# _config.yml → deploy: type: git / repo: / branch:
hexo clean && hexo deploy

Un nginx en la VPS: root /caminho/do/blog/public; e hexo generate en cron o en CI. Sin PHP, sin MariaDB.

Cierre

Node LTS, hexo-cli en el usuario, hexo init, hexo s, hexo g. El nvm 0.35 y Ubuntu 16.04 del post original no. Docs: hexo.io/docs · github.com/hexojs/hexo.