KSWEB 上部署 WordPress 完整步骤 解压即跑 + 数据库配置
整体流程
WordPress 是 KSWEB 支持最好的 CMS——官方明确列在支持清单里。从下载到跑通一个 WP 站,全程大约十分钟:
- 下载 WordPress 压缩包
- 解压到 htdocs 目录
- phpMyAdmin 建一个空数据库
- 浏览器打开安装向导
- 填数据库连接信息
- 完成安装,马上改 root 密码
详细步骤
第一步:准备环境
先确认 KSWEB 这几个组件都在跑:
- Lighttpd 或 Apache — 推荐 Apache(.htaccess 好看链接)
- MySQL — 端口 3306,先开着
- PHP 版本根据插件情况选(不确定就先 8.2.29)
第二步:下载和解压 WordPress
- 手机浏览器打开 WordPress 官网下载最新版 zip
- 下载完后用手机文件管理器解压(或用 Astro File Manager)
- 把解压出来的
wordpress文件夹里的所有文件移到 KSWEB 的站点根目录
第三步:确定 WordPress 放在哪个目录
两种方案:
| 方案 | 路径 | 访问地址 | 适用场景 |
|---|---|---|---|
| 直接放根目录 | /storage/emulated/0/htdocs/ | http://localhost:8080/ | 手机上只跑这一个站 |
| 子目录 | /storage/emulated/0/htdocs/myblog/ | http://localhost:8080/myblog/ | 手机上跑多个站 |
用哪种都可以,后面修改也方便。htdocs 目录的详细说明见 htdocs 与自定义根目录。
第四步:phpMyAdmin 建空数据库
- KSWEB TOOLS 标签页打开 phpMyAdmin
- 左侧点"新建"
- 输入数据库名(比如
wordpress),排序规则utf8mb4_unicode_ci - 创建
第五步:跑安装向导
手机浏览器打开:
- 如果放根目录:
http://localhost:8080/wp-admin/install.php - 如果放子目录:
http://localhost:8080/myblog/wp-admin/install.php
向导会让填数据库连接信息:
| 字段 | 填什么 |
|---|---|
| 数据库名 | 刚才建的那个(wordpress) |
| 用户名 | root |
| 密码 | 空 |
| 数据库主机 | localhost |
| 表前缀 | wp_(默认即可) |
点提交,WP 会自动建表。
第六步:站点标题和管理员
向导继续:
- 站点标题(随便填,安装完后台随时改)
- 管理员用户名和密码(记好,丢失要手动改数据库)
- 管理员邮箱
- 勾选"搜索引擎可见性"(手机本地测试就勾掉,上线再打开)
点安装,约 30 秒完成。
第七步:立即改 root 密码
部署完第一件事:回到 KSWEB,通过 phpMyAdmin 或命令行改掉 MySQL root 的空密码。详细操作见 改 root 密码。改完后,打开 WordPress 的 wp-config.php 把 DB_PASSWORD 也更新一下,否则 WP 会连不上数据库。
常见坑
- .htaccess 不生效 — 用 Lighttpd 时 .htaccess 不工作(它用自己的配置文件),需要 Apache。用 Lighttpd 想实现好看链接,需要在 Lighttpd 配置里自己写 rewrite 规则
- 文件权限 — Android 上通过 FTP 上传的文件一般权限没问题,phpMyAdmin 导入 SQL 时如果报错权限,切用 Adminer 或通过终端脚本执行
- 老插件不支持 PHP 8.x — 很多 WP 插件还在 PHP 7.4 上最稳,碰到插件白屏先切回 PHP 7.4.33 试试
- 上传限制 —
php.ini里upload_max_filesize默认 2M,换大文件需要改配置