hexo-deploy/README_QUICK_START_SIMPLE.md

Hexo Blog Docker Quick Start Guide Hexo Blog Docker 快速启动指南

Version 版本: v0.0.3 (Stable 稳定版) | Status 状态: 🟢 Production Ready 生产就绪 | Updated 更新: 2025-05-30

🚀 30-Second Express Launch 30秒极速启动

📋 Prerequisites Check 前置检查

# Ensure Docker is running 确保Docker运行
docker --version
# Check port availability 检查端口可用性
netstat -ano | findstr ":8080\\|:2222"

⚡ One-Click Deployment 一键部署

# Build and start (copy-paste to execute) 构建并启动 (复制粘贴执行)
docker build -f Dockerfile_v0.0.3 -t hexo-blog:v0.0.3 . && `
docker run -d --name hexo-blog --restart unless-stopped -p 8080:80 -p 2222:22 hexo-blog:v0.0.3 && `
Write-Host "🎉 Deployment complete! Access: http://localhost:8080 部署完成！访问: http://localhost:8080" -ForegroundColor Green

🌐 Access Now 立即访问

• Homepage 主页: http://localhost:8080
• Health Check 健康检查: http://localhost:8080/health
• Status 状态: docker ps | findstr hexo-blog

---

🔑 SSH Deployment Configuration (2-Minute Setup) SSH部署配置 (2分钟设置)

1. Quick SSH Setup 快速SSH设置

# Generate key + Deploy + Test (one command) 生成密钥 + 部署 + 测试 (一条命令)
ssh-keygen -t rsa -b 2048 -f hexo_key -N \'""\' ; `
Start-Sleep 10 ; `
Get-Content hexo_key.pub | docker exec -i hexo-blog bash -c "mkdir -p /home/hexo/.ssh && cat > /home/hexo/.ssh/authorized_keys && chmod 600 /home/hexo/.ssh/authorized_keys && chown -R hexo:hexo /home/hexo/.ssh" ; `
ssh -i hexo_key -o ConnectTimeout=5 -o StrictHostKeyChecking=no -p 2222 hexo@localhost "echo \'✅ SSH configuration successful SSH配置成功\'"

2. Git Deployment Test Git部署测试

# Set Git remote + Push test 设置Git远程 + 推送测试
git remote add docker ssh://hexo@localhost:2222/home/hexo/hexo.git
$env:GIT_SSH_COMMAND = "ssh -i $(Get-Location)\\hexo_key -o StrictHostKeyChecking=no"
# Test deployment 测试部署
echo "# Test deployment 测试部署" > test_deploy.md
git add test_deploy.md && git commit -m "Test Docker deployment 测试Docker部署" && git push docker main

---

🛠️ Common Commands 常用命令

# Status check 状态检查
docker ps | findstr hexo                  # Container status 容器状态
docker logs hexo-blog --tail 10          # Latest logs 最新日志
curl http://localhost:8080/health         # Health check 健康检查

# Management operations 管理操作
docker restart hexo-blog                  # Restart 重启
docker exec -it hexo-blog bash           # Enter container 进入容器
docker stats hexo-blog                   # Resource usage 资源使用

# Quick reset 快速重置
docker stop hexo-blog; docker rm hexo-blog
docker run -d --name hexo-blog -p 8080:80 -p 2222:22 hexo-blog:v0.0.3

---

🔧 FAQ 常见问题

Problem 问题	Solution 解决方案
Port in use 端口占用	docker run -p 8081:80 -p 2223:22 ...
SSH failure SSH失败	docker exec hexo-blog systemctl restart ssh
Permission error 权限错误	docker exec hexo-blog chown -R hexo:hexo /home/hexo
Git push failure Git推送失败	Check SSH key 检查SSH密钥: ssh -i hexo_key -p 2222 hexo@localhost

---

📚 Advanced Documentation 进阶文档

• 📖 Complete Guide 完整指南: README_QUICK_START_COMPLETE.md
• 🏭 Production Deployment 生产部署: doc/summary/PRODUCTION_DEPLOYMENT_GUIDE_v0.0.3.md
• 🧪 Test Report 测试报告: doc/summary/FINAL_TEST_REPORT_v0.0.3.md

---

🎯 Success Verification 成功验证

• ✅ docker ps shows Up (healthy) docker ps 显示 Up (healthy)
• ✅ http://localhost:8080 displays webpage http://localhost:8080 显示网页
• ✅ http://localhost:8080/health returns "healthy" http://localhost:8080/health 返回 "healthy"
• ✅ SSH login successful SSH登录成功: ssh -i hexo_key -p 2222 hexo@localhost

Project Status 项目状态: 🟢 Production Ready 生产就绪 | Recommended Version 推荐版本: v0.0.3

---