虽然宝塔面板可以一键部署WordPress,但手动安装能让你更深入理解WordPress的运行原理,出问题时也更容易排查。这篇教程手把手教你手动安装WordPress。
一、安装前准备
- 一台已经搭建好环境的服务器(LNMP/LAMP,参考宝塔环境教程)
- 一个已经解析到服务器的域名
- FTP工具或宝塔文件管理器(用于上传文件)
- 数据库管理权限(MySQL/MariaDB)
- 一个能正常接收邮件的邮箱(用于接收管理员通知)
WordPress官方推荐环境:
• PHP 7.4+(推荐8.0+)
• MySQL 5.7+ 或 MariaDB 10.3+
• Nginx 或 Apache
• HTTPS支持
• mod_rewrite(Apache)或 try_files(Nginx)用于固定链接
二、下载WordPress
- 访问WordPress中文官网:https://cn.wordpress.org/download/
- 点击"下载WordPress"按钮,下载最新中文版(zip格式)
- 或者下载英文版:https://wordpress.org/download/
- 下载得到 wordpress-x.x.x-zh_CN.zip 文件
- 在本地解压,得到一个 wordpress 文件夹,里面包含所有程序文件
一定要从官方网站下载WordPress,不要从第三方网站下载,避免被植入恶意代码。中文版和英文版功能完全一样,只是语言不同,可以在后台切换语言。
三、上传文件到服务器
3.1 用宝塔文件管理器上传(推荐)
- 登录宝塔面板 → "文件"
- 进入网站根目录(如 /www/wwwroot/example.com/)
- 确保根目录为空(如果有index.html等默认文件,先删除)
- 点击"上传"按钮,选择本地的 wordpress-x.x.x-zh_CN.zip
- 等待上传完成
- 右键点击上传的zip文件 → "解压"
- 解压后会出现一个 wordpress 文件夹
- 进入 wordpress 文件夹,全选所有文件(Ctrl+A)
- 点击"剪切",回到网站根目录,点击"粘贴"
- 确认所有文件在根目录下(不是在wordpress子文件夹中)
- 删除空的wordpress文件夹和zip压缩包
3.2 用FTP工具上传
- 用FileZilla/WinSCP等FTP工具连接服务器
- 本地找到解压后的wordpress文件夹,全选所有文件
- 上传到网站根目录
- 等待所有文件上传完成(约2000个文件,可能需要几分钟)
上传完成后,检查网站根目录下是否有 wp-content、wp-includes、wp-admin 文件夹,以及 wp-config-sample.php、index.php 等文件。如果这些文件在wordpress子文件夹中,需要移动到根目录。
四、创建数据库
- 宝塔面板 → "数据库" → "添加数据库"
- 填写数据库名(如 wp_example)
- 填写用户名(如 wp_user,自动加前缀)
- 密码点击"随机"生成强密码
- 访问权限选"本地服务器"
- 字符集选 utf8mb4
- 关联网站选择对应的网站
- 点击"提交"
- 重要:记录数据库名、用户名、密码,安装时需要
五、运行安装程序
- 在浏览器中访问你的域名(如 https://example.com)
- 如果文件上传正确,会看到WordPress安装引导页面
- 选择语言(简体中文),点击"继续"
- 页面提示需要数据库信息,点击"现在就开始!"
- 填写数据库信息:
- 数据库名:刚才创建的数据库名(如 xxx_wp_example)
- 用户名:刚才创建的用户名(如 xxx_wp_user)
- 密码:刚才设置的密码
- 数据库主机:localhost(默认)
- 表前缀:wp_(默认,建议改成其他如 wpabc_ 提高安全性)
- 点击"提交"
- 如果信息正确,提示"现在可以运行安装程序了",点击"运行安装程序"
- 填写网站信息:
- 站点标题:你的网站名称
- 用户名:管理员登录用户名(不要用admin,建议复杂一些)
- 密码:管理员密码(建议强密码,系统会自动生成)
- 你的邮箱:管理员邮箱(用于接收通知和找回密码)
- 对搜索引擎可见性:不勾选(让搜索引擎收录)
- 点击"安装WordPress"
- 安装成功!显示"成功!"页面
- 点击"登录",输入用户名和密码,进入WordPress后台
Error establishing a database connection:数据库连接错误,检查数据库名/用户名/密码是否正确,数据库服务是否运行
404 Not Found:文件没有上传到正确目录,检查文件是否在根目录
500 Internal Server Error:PHP版本不兼容或文件权限问题,检查PHP版本和文件权限
页面空白:PHP错误,开启WP_DEBUG查看错误信息
六、安装后设置与FAQ
- 设置固定链接:后台 → 设置 → 固定链接 → 选择"文章名",保存更改
- 设置站点标题和副标题:设置 → 常规
- 设置时区:设置 → 常规 → 时区选择"上海"
- 安装必备插件:参考WordPress插件教程
- 选择并安装主题:参考WordPress主题教程
- 配置SSL和HTTPS:确保网站支持HTTPS
- 设置备份:安装备份插件或配置服务器自动备份
- 提交到搜索引擎:百度站长平台和Google Search Console
Q:手动安装和一键安装有什么区别?
A:功能上没有区别,手动安装能让你理解WordPress的文件结构和运行原理,出问题时更容易排查。一键安装(宝塔的"一键部署")更快捷,适合新手。
Q:安装时提示"无法写入wp-config.php"怎么办?
A:这是文件权限问题。可以手动创建wp-config.php:将wp-config-sample.php复制为wp-config.php,编辑填入数据库信息,上传到根目录。或者在宝塔文件管理器中设置根目录权限为755,所有者为www。
Q:WordPress可以安装在子目录吗?
A:可以,将文件上传到子目录(如 /blog/),访问 https://example.com/blog/ 进行安装。安装后可以在设置中修改站点地址,让网站显示在根域名。
Q:数据库表前缀为什么要修改?
A:默认表前缀wp_容易被SQL注入攻击利用,修改为随机前缀(如 wp3x9_)可以提高安全性。但修改后要记住,以后手动操作数据库时需要用到。
Q:安装后忘记管理员密码怎么办?
A:在登录页面点击"忘记密码?",输入用户名或邮箱,会收到重置密码的邮件。如果邮箱收不到,可以通过数据库修改密码,或者用WP-CLI命令重置。