Hugging Face Spaces WordPress 部署指南
本指南将帮助您在 Hugging Face Spaces 上成功部署 WordPress 应用。
📋 部署前准备
1. 账户要求
- Hugging Face 账户（免费或付费）
- 基本的 Git 操作知识
2. 文件清单
确保您有以下文件：
├── Dockerfile # Docker 构建文件
├── app.py # Python 应用入口
├── requirements.txt # Python 依赖
├── wp-config.php # WordPress 配置
├── monitor-cleanup.sh # 清理脚本
├── start-services.sh # 服务启动脚本
├── test-deployment.sh # 部署测试脚本
├── .dockerignore # Docker 忽略文件
├── README_SPACES.md # Spaces 说明文档
└── DEPLOYMENT_GUIDE.md # 本部署指南
🚀 部署步骤
步骤 1: 创建 Hugging Face Space
- 访问 Hugging Face Spaces
- 点击 "Create new Space"
- 填写 Space 信息：
- Space name: 选择一个唯一的名称（如：
my-wordpress-site） - License: 选择合适的许可证
- SDK: 选择 "Docker"
- Visibility: 选择 Public 或 Private
- Space name: 选择一个唯一的名称（如：
- 点击 "Create Space"
步骤 2: 克隆仓库
# 克隆您的 Space 仓库
git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
cd YOUR_SPACE_NAME
步骤 3: 上传文件
将所有必要文件复制到 Space 仓库目录：
# 复制所有文件到 Space 目录
cp /path/to/wordpress-files/* ./
# 检查文件
ls -la
步骤 4: 提交和推送
# 添加所有文件
git add .
# 提交更改
git commit -m "Initial WordPress deployment for Hugging Face Spaces"
# 推送到远程仓库
git push origin main
步骤 5: 等待构建
- 返回您的 Space 页面
- Hugging Face 会自动检测 Dockerfile 并开始构建
- 构建过程通常需要 5-15 分钟
- 您可以在 "Logs" 标签页查看构建进度
🔧 配置说明
环境变量（可选）
在 Space 设置中，您可以添加以下环境变量：
# WordPress 配置
WORDPRESS_DB_NAME=wordpress
WORDPRESS_DB_USER=wordpress
WORDPRESS_DB_PASSWORD=wordpress
# 清理配置
FILE_RETENTION_DAYS=365
AUTO_CLEANUP_ENABLED=true
# 调试模式（仅开发时使用）
WP_DEBUG=false
自定义配置
修改文件保留期限
编辑 wp-config.php：
// 修改保留天数（默认365天）
define('FILE_RETENTION_DAYS', 180); // 改为6个月
禁用自动清理
编辑 wp-config.php：
// 禁用自动清理
define('AUTO_CLEANUP_ENABLED', false);
修改内存限制
编辑 wp-config.php：
// 增加内存限制
ini_set('memory_limit', '512M');
🔍 验证部署
自动测试
部署完成后，您可以运行测试脚本：
# 在本地测试（如果您有访问权限）
bash test-deployment.sh
手动验证
访问以下URL验证部署：
- 主页:
https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/ - WordPress:
https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/wordpress - 健康检查:
https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health - 清理状态:
https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/api/cleanup/status
检查清单
- 主页正常显示
- WordPress 安装页面可访问
- 健康检查 API 返回正常状态
- 清理状态 API 返回配置信息
- 可以创建 WordPress 管理员账户
- 可以登录 WordPress 后台
- 文件上传功能正常
- 清理统计在仪表板显示
🛠️ 故障排除
常见问题
1. 构建失败
症状: Space 显示构建错误
解决方案:
- 检查 Dockerfile 语法
- 确保所有文件都已正确上传
- 查看构建日志中的具体错误信息
2. 应用无法启动
症状: Space 显示 "Application Error"
解决方案:
- 检查
start-services.sh脚本权限 - 确保端口 7860 正确配置
- 查看应用日志
3. WordPress 数据库错误
症状: WordPress 显示数据库连接错误
解决方案:
- 检查 SQLite 插件是否正确安装
- 确认数据库目录权限
- 验证
wp-config.php配置
4. 文件上传失败
症状: 无法上传媒体文件
解决方案:
- 检查上传目录权限
- 确认磁盘空间充足
- 检查 PHP 上传限制
调试模式
启用调试模式以获取更多信息：
编辑
wp-config.php：define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', true);重新部署 Space
查看错误信息
日志查看
如果您有容器访问权限，可以查看日志：
# WordPress 清理日志
tail -f /var/log/wordpress/cleanup.log
# Apache 错误日志
tail -f /var/log/apache2/error.log
# Python 应用日志
tail -f /var/log/python-app.log
📈 性能优化
1. 图片优化
- 上传前压缩图片
- 使用 WebP 格式
- 安装图片优化插件
2. 缓存配置
- 安装缓存插件（如 W3 Total Cache）
- 启用浏览器缓存
- 配置 CDN（如果需要）
3. 数据库优化
- 定期清理垃圾评论
- 限制文章修订版本
- 删除未使用的插件和主题
4. 监控和维护
- 定期检查清理日志
- 监控磁盘使用情况
- 保持 WordPress 和插件更新
🔒 安全建议
1. 强密码策略
- 使用复杂的管理员密码
- 启用双因素认证
- 定期更换密码
2. 插件安全
- 只安装必要的插件
- 保持插件更新
- 定期审查已安装插件
3. 访问控制
- 限制管理员账户数量
- 使用强用户名（避免 "admin"）
- 配置 IP 白名单（如果需要）
4. 备份策略
- 定期导出重要内容
- 备份数据库文件
- 保存配置文件副本
📞 获取帮助
官方资源
社区支持
- Hugging Face 社区论坛
- WordPress 支持论坛
- GitHub Issues（如果项目开源）
技术支持
如果遇到技术问题，请提供以下信息：
- Space 名称和 URL
- 错误信息截图
- 相关日志内容
- 复现步骤
- 环境配置信息
📄 许可证和免责声明
本部署方案基于开源软件构建，请遵守相关许可证条款：
- WordPress: GPL v2+
- Apache: Apache License 2.0
- Python: PSF License
- SQLite: Public Domain
免责声明: 本方案仅供学习和测试使用，生产环境使用前请进行充分测试和安全评估。
祝您部署成功！ 🎉