Delete DEPLOYMENT_GUIDE.md
Browse files- DEPLOYMENT_GUIDE.md +0 -318
DEPLOYMENT_GUIDE.md
DELETED
|
@@ -1,318 +0,0 @@
|
|
| 1 |
-
# Hugging Face Spaces WordPress 部署指南
|
| 2 |
-
|
| 3 |
-
本指南将帮助您在 Hugging Face Spaces 上成功部署 WordPress 应用。
|
| 4 |
-
|
| 5 |
-
## 📋 部署前准备
|
| 6 |
-
|
| 7 |
-
### 1. 账户要求
|
| 8 |
-
- Hugging Face 账户(免费或付费)
|
| 9 |
-
- 基本的 Git 操作知识
|
| 10 |
-
|
| 11 |
-
### 2. 文件清单
|
| 12 |
-
确保您有以下文件:
|
| 13 |
-
|
| 14 |
-
```
|
| 15 |
-
├── Dockerfile # Docker 构建文件
|
| 16 |
-
├── app.py # Python 应用入口
|
| 17 |
-
├── requirements.txt # Python 依赖
|
| 18 |
-
├── wp-config.php # WordPress 配置
|
| 19 |
-
├── monitor-cleanup.sh # 清理脚本
|
| 20 |
-
├── start-services.sh # 服务启动脚本
|
| 21 |
-
├── test-deployment.sh # 部署测试脚本
|
| 22 |
-
├── .dockerignore # Docker 忽略文件
|
| 23 |
-
├── README_SPACES.md # Spaces 说明文档
|
| 24 |
-
└── DEPLOYMENT_GUIDE.md # 本部署指南
|
| 25 |
-
```
|
| 26 |
-
|
| 27 |
-
## 🚀 部署步骤
|
| 28 |
-
|
| 29 |
-
### 步骤 1: 创建 Hugging Face Space
|
| 30 |
-
|
| 31 |
-
1. 访问 [Hugging Face Spaces](https://huggingface.co/spaces)
|
| 32 |
-
2. 点击 **"Create new Space"**
|
| 33 |
-
3. 填写 Space 信息:
|
| 34 |
-
- **Space name**: 选择一个唯一的名称(如:`my-wordpress-site`)
|
| 35 |
-
- **License**: 选择合适的许可证
|
| 36 |
-
- **SDK**: 选择 **"Docker"**
|
| 37 |
-
- **Visibility**: 选择 Public 或 Private
|
| 38 |
-
4. 点击 **"Create Space"**
|
| 39 |
-
|
| 40 |
-
### 步骤 2: 克隆仓库
|
| 41 |
-
|
| 42 |
-
```bash
|
| 43 |
-
# 克隆您的 Space 仓库
|
| 44 |
-
git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
|
| 45 |
-
cd YOUR_SPACE_NAME
|
| 46 |
-
```
|
| 47 |
-
|
| 48 |
-
### 步骤 3: 上传文件
|
| 49 |
-
|
| 50 |
-
将所有必要文件复制到 Space 仓库目录:
|
| 51 |
-
|
| 52 |
-
```bash
|
| 53 |
-
# 复制所有文件到 Space 目录
|
| 54 |
-
cp /path/to/wordpress-files/* ./
|
| 55 |
-
|
| 56 |
-
# 检查文件
|
| 57 |
-
ls -la
|
| 58 |
-
```
|
| 59 |
-
|
| 60 |
-
### 步骤 4: 提交和推送
|
| 61 |
-
|
| 62 |
-
```bash
|
| 63 |
-
# 添加所有文件
|
| 64 |
-
git add .
|
| 65 |
-
|
| 66 |
-
# 提交更改
|
| 67 |
-
git commit -m "Initial WordPress deployment for Hugging Face Spaces"
|
| 68 |
-
|
| 69 |
-
# 推送到远程仓库
|
| 70 |
-
git push origin main
|
| 71 |
-
```
|
| 72 |
-
|
| 73 |
-
### 步骤 5: 等待构建
|
| 74 |
-
|
| 75 |
-
1. 返回您的 Space 页面
|
| 76 |
-
2. Hugging Face 会自动检测 Dockerfile 并开始构建
|
| 77 |
-
3. 构建过程通常需要 5-15 分钟
|
| 78 |
-
4. 您可以在 "Logs" 标签页查看构建进度
|
| 79 |
-
|
| 80 |
-
## 🔧 配置说明
|
| 81 |
-
|
| 82 |
-
### 环境变量(可选)
|
| 83 |
-
|
| 84 |
-
在 Space 设置中,您可以添加以下环境变量:
|
| 85 |
-
|
| 86 |
-
```bash
|
| 87 |
-
# WordPress 配置
|
| 88 |
-
WORDPRESS_DB_NAME=wordpress
|
| 89 |
-
WORDPRESS_DB_USER=wordpress
|
| 90 |
-
WORDPRESS_DB_PASSWORD=wordpress
|
| 91 |
-
|
| 92 |
-
# 清理配置
|
| 93 |
-
FILE_RETENTION_DAYS=365
|
| 94 |
-
AUTO_CLEANUP_ENABLED=true
|
| 95 |
-
|
| 96 |
-
# 调试模式(仅开发时使用)
|
| 97 |
-
WP_DEBUG=false
|
| 98 |
-
```
|
| 99 |
-
|
| 100 |
-
### 自定义配置
|
| 101 |
-
|
| 102 |
-
#### 修改文件保留期限
|
| 103 |
-
|
| 104 |
-
编辑 `wp-config.php`:
|
| 105 |
-
|
| 106 |
-
```php
|
| 107 |
-
// 修改保留天数(默认365天)
|
| 108 |
-
define('FILE_RETENTION_DAYS', 180); // 改为6个月
|
| 109 |
-
```
|
| 110 |
-
|
| 111 |
-
#### 禁用自动清理
|
| 112 |
-
|
| 113 |
-
编辑 `wp-config.php`:
|
| 114 |
-
|
| 115 |
-
```php
|
| 116 |
-
// 禁用自动清理
|
| 117 |
-
define('AUTO_CLEANUP_ENABLED', false);
|
| 118 |
-
```
|
| 119 |
-
|
| 120 |
-
#### 修改内存限制
|
| 121 |
-
|
| 122 |
-
编辑 `wp-config.php`:
|
| 123 |
-
|
| 124 |
-
```php
|
| 125 |
-
// 增加内存限制
|
| 126 |
-
ini_set('memory_limit', '512M');
|
| 127 |
-
```
|
| 128 |
-
|
| 129 |
-
## 🔍 验证部署
|
| 130 |
-
|
| 131 |
-
### 自动测试
|
| 132 |
-
|
| 133 |
-
部署完成后,您可以运行测试脚本:
|
| 134 |
-
|
| 135 |
-
```bash
|
| 136 |
-
# 在本地测试(如果您有访问权限)
|
| 137 |
-
bash test-deployment.sh
|
| 138 |
-
```
|
| 139 |
-
|
| 140 |
-
### 手动验证
|
| 141 |
-
|
| 142 |
-
访问以下URL验证部署:
|
| 143 |
-
|
| 144 |
-
1. **主页**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/`
|
| 145 |
-
2. **WordPress**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/wordpress`
|
| 146 |
-
3. **健康检查**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health`
|
| 147 |
-
4. **清理状态**: `https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/api/cleanup/status`
|
| 148 |
-
|
| 149 |
-
### 检查清单
|
| 150 |
-
|
| 151 |
-
- [ ] 主页正常显示
|
| 152 |
-
- [ ] WordPress 安装页面可访问
|
| 153 |
-
- [ ] 健康检查 API 返回正常状态
|
| 154 |
-
- [ ] 清理状态 API 返回配置信息
|
| 155 |
-
- [ ] 可以创建 WordPress 管理员账户
|
| 156 |
-
- [ ] 可以登录 WordPress 后台
|
| 157 |
-
- [ ] 文件上传功能正常
|
| 158 |
-
- [ ] 清理统计在仪表板显示
|
| 159 |
-
|
| 160 |
-
## 🛠️ 故障排除
|
| 161 |
-
|
| 162 |
-
### 常见问题
|
| 163 |
-
|
| 164 |
-
#### 1. 构建失败
|
| 165 |
-
|
| 166 |
-
**症状**: Space 显示构建错误
|
| 167 |
-
|
| 168 |
-
**解决方案**:
|
| 169 |
-
- 检查 Dockerfile 语法
|
| 170 |
-
- 确保所有文件都已正确上传
|
| 171 |
-
- 查看构建日志中的具体错误信息
|
| 172 |
-
|
| 173 |
-
#### 2. 应用无法启动
|
| 174 |
-
|
| 175 |
-
**症状**: Space 显示 "Application Error"
|
| 176 |
-
|
| 177 |
-
**解决方案**:
|
| 178 |
-
- 检查 `start-services.sh` 脚本权限
|
| 179 |
-
- 确保端口 7860 正确配置
|
| 180 |
-
- 查看应用日志
|
| 181 |
-
|
| 182 |
-
#### 3. WordPress 数据库错误
|
| 183 |
-
|
| 184 |
-
**症状**: WordPress 显示数据库连接错误
|
| 185 |
-
|
| 186 |
-
**解决方案**:
|
| 187 |
-
- 检查 SQLite 插件是否正确安装
|
| 188 |
-
- 确认数据库目录权限
|
| 189 |
-
- 验证 `wp-config.php` 配置
|
| 190 |
-
|
| 191 |
-
#### 4. 文件上传失败
|
| 192 |
-
|
| 193 |
-
**症状**: 无法上传媒体文件
|
| 194 |
-
|
| 195 |
-
**解决方案**:
|
| 196 |
-
- 检查上传目录权限
|
| 197 |
-
- 确认磁盘空间充足
|
| 198 |
-
- 检查 PHP 上传限制
|
| 199 |
-
|
| 200 |
-
### 调试模式
|
| 201 |
-
|
| 202 |
-
启用调试模式以获取更多信息:
|
| 203 |
-
|
| 204 |
-
1. 编辑 `wp-config.php`:
|
| 205 |
-
```php
|
| 206 |
-
define('WP_DEBUG', true);
|
| 207 |
-
define('WP_DEBUG_DISPLAY', true);
|
| 208 |
-
```
|
| 209 |
-
|
| 210 |
-
2. 重新部署 Space
|
| 211 |
-
|
| 212 |
-
3. 查看错误信息
|
| 213 |
-
|
| 214 |
-
### 日志查看
|
| 215 |
-
|
| 216 |
-
如果您有容器访问权限,可以查看日志:
|
| 217 |
-
|
| 218 |
-
```bash
|
| 219 |
-
# WordPress 清理日志
|
| 220 |
-
tail -f /var/log/wordpress/cleanup.log
|
| 221 |
-
|
| 222 |
-
# Apache 错误日志
|
| 223 |
-
tail -f /var/log/apache2/error.log
|
| 224 |
-
|
| 225 |
-
# Python 应用日志
|
| 226 |
-
tail -f /var/log/python-app.log
|
| 227 |
-
```
|
| 228 |
-
|
| 229 |
-
## 📈 性能优化
|
| 230 |
-
|
| 231 |
-
### 1. 图片优化
|
| 232 |
-
|
| 233 |
-
- 上传前压缩图片
|
| 234 |
-
- 使用 WebP 格式
|
| 235 |
-
- 安装图片优化插件
|
| 236 |
-
|
| 237 |
-
### 2. 缓存配置
|
| 238 |
-
|
| 239 |
-
- 安装缓存插件(如 W3 Total Cache)
|
| 240 |
-
- 启用浏览器缓存
|
| 241 |
-
- 配置 CDN(如果需要)
|
| 242 |
-
|
| 243 |
-
### 3. 数据库优化
|
| 244 |
-
|
| 245 |
-
- 定期清理垃圾评论
|
| 246 |
-
- 限制文章修订版本
|
| 247 |
-
- 删除未使用的插件和主题
|
| 248 |
-
|
| 249 |
-
### 4. 监控和维护
|
| 250 |
-
|
| 251 |
-
- 定期检查清理日志
|
| 252 |
-
- 监控磁盘使用情况
|
| 253 |
-
- 保持 WordPress 和插件更新
|
| 254 |
-
|
| 255 |
-
## 🔒 安全建议
|
| 256 |
-
|
| 257 |
-
### 1. 强密码策略
|
| 258 |
-
|
| 259 |
-
- 使用复杂的管理员密码
|
| 260 |
-
- 启用双因素认证
|
| 261 |
-
- 定期更换密码
|
| 262 |
-
|
| 263 |
-
### 2. 插件安全
|
| 264 |
-
|
| 265 |
-
- 只安装必要的插件
|
| 266 |
-
- 保持插件更新
|
| 267 |
-
- 定期审查已安装插件
|
| 268 |
-
|
| 269 |
-
### 3. 访问控制
|
| 270 |
-
|
| 271 |
-
- 限制管理员账户数量
|
| 272 |
-
- 使用强用户名(避免 "admin")
|
| 273 |
-
- 配置 IP 白名单(如果需要)
|
| 274 |
-
|
| 275 |
-
### 4. 备份策略
|
| 276 |
-
|
| 277 |
-
- 定期导出重要内容
|
| 278 |
-
- 备份数据库文件
|
| 279 |
-
- 保存配置文件副本
|
| 280 |
-
|
| 281 |
-
## 📞 获取帮助
|
| 282 |
-
|
| 283 |
-
### 官方资源
|
| 284 |
-
|
| 285 |
-
- [Hugging Face Spaces 文档](https://huggingface.co/docs/hub/spaces)
|
| 286 |
-
- [WordPress 官方文档](https://wordpress.org/support/)
|
| 287 |
-
- [Docker 官方文档](https://docs.docker.com/)
|
| 288 |
-
|
| 289 |
-
### 社区支持
|
| 290 |
-
|
| 291 |
-
- Hugging Face 社区论坛
|
| 292 |
-
- WordPress 支持论坛
|
| 293 |
-
- GitHub Issues(如果项目开源)
|
| 294 |
-
|
| 295 |
-
### 技术支持
|
| 296 |
-
|
| 297 |
-
如果遇到技术问题,请提供以下信息:
|
| 298 |
-
|
| 299 |
-
1. Space 名称和 URL
|
| 300 |
-
2. 错误信息截图
|
| 301 |
-
3. 相关日志内容
|
| 302 |
-
4. 复现步骤
|
| 303 |
-
5. 环境配置信息
|
| 304 |
-
|
| 305 |
-
## 📄 许可证和免责声明
|
| 306 |
-
|
| 307 |
-
本部署方案基于开源软件构建,请遵守相关许可证条款:
|
| 308 |
-
|
| 309 |
-
- WordPress: GPL v2+
|
| 310 |
-
- Apache: Apache License 2.0
|
| 311 |
-
- Python: PSF License
|
| 312 |
-
- SQLite: Public Domain
|
| 313 |
-
|
| 314 |
-
**免责声明**: 本方案仅供学习和测试使用,生产环境使用前请进行充分测试和安全评估。
|
| 315 |
-
|
| 316 |
-
---
|
| 317 |
-
|
| 318 |
-
**祝您部署成功!** 🎉
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|