# 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 前置检查
```powershell
# Ensure Docker is running 确保Docker运行
docker --version
# Check port availability 检查端口可用性
netstat -ano | findstr ":8080\\|:2222"
```

### ⚡ One-Click Deployment 一键部署
```powershell
# 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设置
```powershell
# 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部署测试
```powershell
# 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 常用命令

```powershell
# 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](README_QUICK_START_COMPLETE.md)
- 🏭 **Production Deployment 生产部署**: [doc/summary/PRODUCTION_DEPLOYMENT_GUIDE_v0.0.3.md](doc/summary/PRODUCTION_DEPLOYMENT_GUIDE_v0.0.3.md)
- 🧪 **Test Report 测试报告**: [doc/summary/FINAL_TEST_REPORT_v0.0.3.md](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

---