CatPtain commited on
Commit
f42ed0e
·
verified ·
1 Parent(s): a49e2a9

Delete DEPLOYMENT_GUIDE.md

Browse files
Files changed (1) hide show
  1. 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
- **祝您部署成功!** 🎉