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 |
-
**祝您部署成功!** 🎉
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|