在香港服务器部署Typecho博客,如何配置PHP与数据库?
在香港服务器上部署 Typecho,核心不是只把程序文件上传到网站目录,而是要同时完成 PHP-FPM、MariaDB、Nginx、域名解析、文件权限和 HTTPS 配置。下面以一台全新 Ubuntu 22.04 LTS 64 位香港服务器为例,搭建一套由 Nginx 接收请求、PHP 8.1-FPM 执行程序、MariaDB 10.6 保存数据的运行环境,并以域名 example.com 作为上线示例。

本教程适合使用 sudo 权限进行系统管理的服务器。示例中的域名、数据库密码、公网 IP 和 Typecho 下载地址都需要替换成实际值。部署完成后,目标状态是:网站可以通过 HTTPS 访问,Typecho 后台可以登录,文章和图片可以正常发布,MariaDB 只监听本机,不直接暴露到公网。
一、部署目标与准备条件
1. 采用的环境组合
本文固定使用以下环境,命令和路径均按此环境编写:
| 项目 | 示例配置 | 说明 |
|---|---|---|
| 服务器系统 | Ubuntu 22.04 LTS 64 位 | 适合使用 apt 安装 PHP 8.1 |
| 站点服务 | Nginx | 负责静态文件、HTTPS 和 PHP 请求转发 |
| PHP 运行方式 | PHP 8.1-FPM | 不建议使用 Nginx 直接执行 PHP |
| 数据库 | MariaDB 10.6 | 仅允许本机访问 |
| PHP 扩展 | mysql、curl、gd、mbstring、xml、zip、opcache | 满足 Typecho 安装和常见主题、插件需求 |
| 网站目录 | /var/www/typecho | Nginx 的站点根目录 |
| PHP-FPM Socket | /run/php/php8.1-fpm.sock | Nginx 通过 Unix Socket 连接 PHP-FPM |
| 时区 | Asia/Hong_Kong | 用于日志、文章发布时间和定时任务 |
| 示例域名 | example.com | 请替换成实际域名 |
如果服务器使用 Ubuntu 24.04、Debian、AlmaLinux 或其他系统,不要直接照搬 PHP-FPM Socket 路径和包名。先用下面的命令确认系统版本:
cat /etc/os-release
uname -m
Ubuntu 22.04 的典型输出中应包含:
VERSION_ID="22.04"
x86_64
如果不是 Ubuntu 22.04,建议先确认对应系统提供的 PHP 版本、PHP-FPM 服务名和 Socket 路径,再继续操作。
围绕 Typecho 博客的 PHP 与数据库部署,A5数据提供香港物理服务器,涵盖入门建站、Xeon Gold 和 AMD EPYC 等资源档位。SSD、NVMe 存储与多种内存配置,可为 Nginx、PHP-FPM 和 MariaDB 同机运行,以及文章、图片和数据库读写提供硬件基础;香港产品中的 CN2 与国际带宽方案,则为面向不同访问人群的博客提供网络资源选择,承接内容发布与后台管理需求。
2. 服务器和域名条件
正式安装前,至少准备以下条件:
- 一台拥有公网 IPv4 地址的香港服务器;
- 一个已经注册的域名;
- 可以登录服务器的 root 或 sudo 账户;
- 服务器提供商控制台中的安全组可以放行 TCP 80、443,以及当前 SSH 端口;
- 本地已保存重要数据的备份,尤其是已有网站或数据库;
- 服务器磁盘至少预留数 GB 空间,实际容量取决于图片、附件、日志和备份数量。
Typecho 本身占用资源较少。个人博客或低访问量站点通常可以从 1 vCPU、1 GB 内存起步,但主题、图片处理、插件数量和并发访问量会影响实际资源需求。内存较小的服务器应避免同时运行多个大型服务,也不要在没有评估的情况下启用过多 PHP Worker。
将域名的 A 记录指向服务器公网 IPv4。例如:
| DNS 记录 | 主机记录 | 指向 |
|---|---|---|
| A | @ | 香港服务器公网 IPv4 |
| A 或 CNAME | www | 主域名或同一公网 IPv4 |
DNS 修改后,在本地或服务器上检查解析结果:
dig +short example.com
dig +short www.example.com
预期能看到服务器的公网 IPv4。如果服务器存在 AAAA 记录,但 IPv6 没有正确配置,浏览器可能优先通过 IPv6 访问并出现超时。这种情况下,应先修正 IPv6 路由和防火墙,或暂时移除错误的 AAAA 记录。
3. SSH 和防火墙注意事项
启用 UFW 前,必须先放行当前 SSH 端口。下面以 SSH 使用默认 22 端口为例。如果服务器实际使用其他端口,应将 22/tcp 换成实际端口。
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
预期状态类似:
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
80/tcp ALLOW Anywhere
443/tcp ALLOW Anywhere
这一步存在把自己锁在服务器外的风险。执行前应保留当前 SSH 会话,并确认服务器提供商有网页终端、VNC 或串行控制台。不要为了让 Typecho 连接数据库而放行 3306 端口,后文会将 MariaDB 限制在本机访问。
如果服务商还有独立的安全组,UFW 放行并不等于公网一定可访问,安全组同样需要允许 80 和 443。
二、安装并配置 PHP、Nginx 和基础组件
1. 更新软件索引并安装软件
先设置香港时区,然后安装 Nginx、MariaDB、PHP 8.1-FPM 和 Typecho 常用扩展:
sudo timedatectl set-timezone Asia/Hong_Kong
sudo apt update
sudo apt install -y \
nginx \
mariadb-server \
unzip \
curl \
ca-certificates \
rsync \
php8.1 \
php8.1-fpm \
php8.1-mysql \
php8.1-curl \
php8.1-gd \
php8.1-mbstring \
php8.1-xml \
php8.1-zip \
php8.1-opcache
如果系统提示某个 php8.1-* 软件包不存在,先确认系统是否确实为 Ubuntu 22.04:
apt-cache policy php8.1-fpm
不要在未确认软件源的情况下随意混用第三方 PHP 软件源。不同 PHP 版本对应的 FPM 服务名和 Socket 目录可能不同,例如 PHP 8.2 通常使用 /run/php/php8.2-fpm.sock。
设置服务开机启动并立即启动:
sudo systemctl enable --now nginx
sudo systemctl enable --now mariadb
sudo systemctl enable --now php8.1-fpm
验证服务状态:
systemctl --no-pager --full status nginx
systemctl --no-pager --full status mariadb
systemctl --no-pager --full status php8.1-fpm
预期三项服务都能看到:
Active: active (running)
如果服务没有启动,不要继续配置网站。先查看对应日志:
sudo journalctl -u nginx -n 50 --no-pager
sudo journalctl -u mariadb -n 50 --no-pager
sudo journalctl -u php8.1-fpm -n 50 --no-pager
2. 设置 PHP-FPM 运行参数
不要直接覆盖发行版提供的完整 php.ini。可以在 FPM 的 conf.d 目录新增一个站点配置文件,便于后续查看和回滚:
sudo tee /etc/php/8.1/fpm/conf.d/99-typecho.ini >/dev/null <<'INI'
date.timezone = Asia/Hong_Kong
memory_limit = 128M
upload_max_filesize = 20M
post_max_size = 22M
max_execution_time = 60
max_input_time = 60
cgi.fix_pathinfo = 0
display_errors = Off
log_errors = On
expose_php = Off
INI
这里将 post_max_size 设置为 22M,高于 upload_max_filesize 的 20M,避免上传请求因为 POST 总量限制而失败。Nginx 的 client_max_body_size 也要使用不小于 22M 的值,否则请求会在到达 PHP 前被 Nginx 拒绝。
检查 PHP-FPM 配置语法并重启服务:
sudo php-fpm8.1 -t
sudo systemctl restart php8.1-fpm
预期结果:
NOTICE: configuration file /etc/php/8.1/fpm/php-fpm.conf test is successful
检查 CLI PHP 版本和扩展:
php -v
php -m | grep -E 'curl|gd|mbstring|mysqli|mysqlnd|PDO|pdo_mysql|xml|zip|Zend OPcache'
预期至少能看到 PDO、pdo_mysql、curl、gd、mbstring、xml、zip 和 Zend OPcache。CLI 的配置和 FPM 配置并非完全相同,因此最终还要通过 Nginx 请求验证 FPM,而不是只看 php -m 的结果。
3. PHP-FPM 配置的验证方法
在网站目录创建一个临时测试文件,确认 Nginx 能把 PHP 请求交给 PHP-FPM:

sudo mkdir -p /var/www/typecho
printf '%s\n' '<?php echo "PHP_FPM_OK";' | sudo tee /var/www/typecho/fpm-check.php >/dev/null
此时先不考虑域名解析,可以通过 Host 请求头测试 Nginx 虚拟主机:
curl -fsS -H 'Host: example.com' http://127.0.0.1/fpm-check.php
如果输出:
PHP_FPM_OK
说明 Nginx、PHP-FPM Socket 和 PHP 请求处理链路基本正常。测试完成后立即删除文件:
sudo rm -f /var/www/typecho/fpm-check.php
这个临时文件不能长期保留,因为任何公开的 PHP 测试文件都可能被用于探测运行环境。
三、创建 MariaDB 数据库和专用账户
1. 执行 MariaDB 基础安全配置
运行发行版提供的安全配置程序:
sudo mariadb-secure-installation
不同 MariaDB 版本的提示略有差异,通常应完成以下事项:
- 删除匿名用户;
- 禁止数据库 root 账户从远程登录;
- 删除测试数据库;
- 重新加载权限表;
- root 账户认证方式按系统默认方式处理。
Ubuntu 上的 MariaDB root 账户经常使用本机 Socket 认证,因此后续使用 sudo mariadb 登录时不一定需要单独设置 root 数据库密码。不要为了“设置密码”而盲目修改 root 认证插件,避免影响系统维护。
执行完成后测试本机管理登录:
sudo mariadb -e "SELECT VERSION(), CURRENT_USER();"
预期能返回 MariaDB 版本和当前认证用户。
2. 创建 Typecho 专用数据库
Typecho 不应直接使用数据库 root 账户。创建独立数据库和独立账户时,建议使用随机生成的高强度密码。可以先生成密码:
openssl rand -base64 24
复制生成的密码,随后通过本机 MariaDB 控制台执行 SQL:
sudo mariadb
执行以下 SQL。将 请替换为高强度数据库密码 替换成实际密码,不要保留中文占位符:
CREATE DATABASE `typecho`
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
CREATE USER 'typecho_app'@'localhost'
IDENTIFIED BY '请替换为高强度数据库密码';
GRANT ALL PRIVILEGES ON `typecho`.*
TO 'typecho_app'@'localhost';
FLUSH PRIVILEGES;
EXIT;
这里的授权范围仅限于 typecho 数据库,没有授予全局管理权限。Typecho 使用数据库主机名 localhost 时,通常通过本机 Unix Socket 连接,并匹配 'typecho_app'@'localhost' 账户。
如果后续明确要在 Typecho 中填写 127.0.0.1,则需要额外创建 'typecho_app'@'127.0.0.1' 账户,不能简单认为它和 localhost 完全相同。
3. 验证数据库账户和字符集
使用刚创建的账户连接数据库:
mariadb -u typecho_app -p -h localhost typecho
输入数据库密码后执行:
SELECT DATABASE(), @@character_set_database, @@collation_database;
SHOW TABLES;
EXIT;
新建数据库尚未安装 Typecho 时,SHOW TABLES 通常为空;字符集应显示 utf8mb4,排序规则应显示 utf8mb4_unicode_ci 或兼容的 utf8mb4 排序规则。
也可以直接执行一条查询进行验证:
mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1 AS db_ok;"
预期输出类似:
+-------+
| db_ok |
+-------+
| 1 |
+-------+
检查数据库监听地址:
sudo ss -lntp | grep 3306
常见的安全状态是只监听 127.0.0.1:3306 或本机 Socket,而不是:
0.0.0.0:3306
如果 MariaDB 监听在所有公网地址,先不要上线。检查 /etc/mysql/mariadb.conf.d/50-server.cnf 中的 bind-address,将其设置为本机地址后再重启 MariaDB。修改前先备份配置文件,因为错误的缩进或参数会导致数据库无法启动:
sudo cp -a /etc/mysql/mariadb.conf.d/50-server.cnf \
/etc/mysql/mariadb.conf.d/50-server.cnf.bak
四、下载 Typecho 并设置站点文件权限
1. 获取 Typecho 程序包
建议从 Typecho 官方发布页面或其正式代码托管发布页获取对应版本压缩包。以下命令使用常见的发布下载地址作为示例;如果该地址返回 404,应以发布页面显示的 ZIP 直链为准,不要下载来路不明的修改版程序。
TYPECHO_URL='https://github.com/typecho/typecho/releases/latest/download/typecho.zip'
WORKDIR="$(mktemp -d)"
trap 'rm -rf "$WORKDIR"' EXIT
curl -fL "$TYPECHO_URL" -o "$WORKDIR/typecho.zip"
file "$WORKDIR/typecho.zip"
unzip -t "$WORKDIR/typecho.zip"
curl 应正常结束,file 通常会识别为 Zip archive,unzip -t 应显示没有损坏。如果项目发布页同时提供 SHA256 校验值,应将本地计算结果与发布页提供的值进行比对:
sha256sum "$WORKDIR/typecho.zip"
不要把无法通过校验、内容类型明显不是 ZIP 的文件直接部署到网站目录。
2. 解压到网站目录
下面的命令兼容压缩包直接包含文件或外层包含一个目录两种常见结构。该操作默认 /var/www/typecho 是新建的空目录。如果该目录已经存在网站内容,请先备份,不要直接合并覆盖。
sudo mkdir -p /var/www/typecho
if [ -n "$(sudo ls -A /var/www/typecho 2>/dev/null)" ]; then
echo "错误:/var/www/typecho 不是空目录,请先备份并确认是否继续。"
exit 1
fi
unzip -q "$WORKDIR/typecho.zip" -d "$WORKDIR/unpacked"
SRC="$WORKDIR/unpacked"
if [ -f "$WORKDIR/unpacked/typecho/index.php" ]; then
SRC="$WORKDIR/unpacked/typecho"
else
CANDIDATE="$(find "$WORKDIR/unpacked" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
if [ -n "$CANDIDATE" ] && [ -f "$CANDIDATE/index.php" ]; then
SRC="$CANDIDATE"
fi
fi
test -f "$SRC/index.php"
sudo cp -a "$SRC"/. /var/www/typecho/
验证核心文件是否存在:
sudo test -f /var/www/typecho/index.php && echo "Typecho files: OK"
sudo find /var/www/typecho -maxdepth 2 -type f | head -n 20
如果找不到 index.php,说明压缩包结构与示例不同,先查看目录结构:
find "$WORKDIR/unpacked" -maxdepth 3 -type f | head -n 30
不要在未确认程序根目录的情况下继续配置 Nginx,否则后续可能出现首页 404 或 PHP 文件找不到。
3. 设置安装阶段权限
Typecho 首次安装通常需要写入配置文件,并需要创建上传目录。安装阶段可以暂时让 PHP-FPM 使用账户 www-data 管理站点文件:
sudo chown -R www-www-data /var/www/typecho
sudo find /var/www/typecho -type d -exec chmod 755 {} \;
sudo find /var/www/typecho -type f -exec chmod 644 {} \;
sudo mkdir -p /var/www/typecho/usr/uploads
sudo chmod 775 /var/www/typecho
sudo chmod 775 /var/www/typecho/usr
sudo chmod 775 /var/www/typecho/usr/uploads
这里的 775 只用于安装阶段,不能把整个网站永久设置为 777。777 会扩大文件写入范围,增加恶意文件被修改或植入的风险。
五、配置 Nginx 站点和 PHP 请求转发
1. 创建 Nginx 虚拟主机
创建站点配置文件:
sudo tee /etc/nginx/sites-available/typecho >/dev/null <<'NGINX'
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
root /var/www/typecho;
index index.php index.html;
client_max_body_size 22m;
access_log /var/log/nginx/typecho.access.log;
error_log /var/log/nginx/typecho.error.log;
location / {
try_files $uri $uri/ /index.php?$args;
}
location = /config.inc.php {
deny all;
}
location ~* ^/usr/uploads/.*\.php$ {
deny all;
}
location ~ /\.(?!well-known).* {
deny all;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $document_root;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
fastcgi_index index.php;
}
}
NGINX
需要替换的内容只有 server_name 和实际 PHP-FPM Socket。如果系统使用 PHP 8.2,Socket 可能是:
/run/php/php8.2-fpm.sock
可以先检查:
ls -l /run/php/
不要凭经验填写不存在的 Socket 路径,否则浏览器会看到 502 Bad Gateway。
启用站点配置:
sudo ln -sfn /etc/nginx/sites-available/typecho \
/etc/nginx/sites-enabled/typecho
如果默认站点会抢先响应请求,且确认服务器没有其他网站使用它,可以先备份再停用:
if [ -e /etc/nginx/sites-enabled/default ]; then
sudo mv /etc/nginx/sites-enabled/default \
/etc/nginx/sites-enabled/default.disabled
fi
如果同一台服务器还运行其他站点,不要执行上面的停用命令,应保留默认站点并检查各个 server_name 是否冲突。
2. 检查 Nginx 配置并加载
先测试配置,不要在测试失败时直接 reload:
sudo nginx -t
预期结果:
syntax is ok
test is successful
测试通过后重新加载:
sudo systemctl reload nginx
如果 nginx -t 报错,常见原因包括:
server_name行缺少分号;- PHP-FPM Socket 路径不存在;
- 配置文件 heredoc 粘贴时混入了多余字符;
- 同一个监听地址和端口存在冲突;
- Nginx 配置目录中存在其他损坏的站点文件。
先修复语法错误,再执行 reload。Nginx 配置加载失败时,原有运行中的配置通常仍会继续提供服务,但不要把这一点当成正式回滚方案。
3. 验证 Nginx 到 PHP-FPM 的链路
重新创建临时 PHP 测试文件:
printf '%s\n' '<?php echo "PHP_FPM_OK";' | sudo tee /var/www/typecho/fpm-check.php >/dev/null
通过虚拟主机访问:
curl -i -H 'Host: example.com' http://127.0.0.1/fpm-check.php
预期响应中包含:
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
PHP_FPM_OK
如果返回 404,检查网站根目录和文件是否存在:
sudo ls -l /var/www/typecho/fpm-check.php
sudo nginx -T | grep -A 20 -B 5 'server_name example.com'
如果返回 502,检查 PHP-FPM 状态和 Socket:
systemctl --no-pager --full status php8.1-fpm
ls -l /run/php/php8.1-fpm.sock
sudo tail -n 50 /var/log/nginx/typecho.error.log
验证结束后删除临时文件:
sudo rm -f /var/www/typecho/fpm-check.php
六、通过浏览器完成 Typecho 安装
1. 打开安装页面
确认 DNS 已经指向服务器,并且服务器安全组、UFW 都允许 80 端口后,在浏览器访问:
http://example.com/
如果 Typecho 程序识别到尚未安装,通常会跳转到安装页面。此时填写以下数据库参数:
| 安装项 | 建议值 |
|---|---|
| 数据库适配器 | PDO_Mysql 或页面提供的 MySQL PDO 选项 |
| 数据库地址 | localhost |
| 数据库端口 | 3306 |
| 数据库用户名 | typecho_app |
| 数据库密码 | 创建数据库账户时设置的密码 |
| 数据库名称 | typecho |
| 表前缀 | typecho_ |
| 站点地址 | http://example.com,HTTPS 完成后再调整或重新访问 |
| 管理员用户名 | 不要使用 admin、root 等容易猜测的名称 |
| 管理员密码 | 使用长度较长且不与其他服务重复的密码 |
| 管理员邮箱 | 填写可以接收通知的邮箱 |
数据库主机填写 localhost 时,Typecho 会优先尝试本机连接方式,并与前面创建的 'typecho_app'@'localhost' 账户对应。如果填入 127.0.0.1 后提示账户无权限,可以改回 localhost,或者为 127.0.0.1 单独创建对应账户。
安装过程中如果提示无法写入配置文件,检查:
sudo ls -ld /var/www/typecho
sudo ls -ld /var/www/typecho/usr
sudo namei -l /var/www/typecho
安装阶段网站目录和 usr 目录应允许 www-data 写入。确认安装完成后,再进行权限收紧。
2. 检查首页、后台和文章发布
安装完成后,至少执行以下检查:
- 打开首页,确认主题可以正常显示;
- 访问
/admin/或页面提供的后台地址; - 登录后台并发布一篇测试文章;
- 上传一张小于 20M 的图片;
- 打开文章详情页,确认伪静态链接可以访问;
- 退出后台后重新登录一次,确认 Cookie 和 Session 正常;
- 查看文章发布时间是否符合
Asia/Hong_Kong时区。
上传一张图片后,在服务器检查上传目录是否产生文件:
sudo find /var/www/typecho/usr/uploads -type f -mmin -10 -ls
如果文章发布成功但详情页返回 404,通常是 Nginx 没有将未知路径回退到 index.php,需要检查:
location / {
try_files $uri $uri/ /index.php?$args;
}
3. 安装完成后收紧权限
确认 Typecho 安装成功后,先备份配置和网站目录,再调整文件权限。下面的命令会改变整个站点目录的所有者,适用于本文中的单站点部署。若服务器上有其他程序依赖 www-data 写入,应先单独评估。
sudo cp -a /var/www/typecho /var/www/typecho.before-permission-hardening
sudo chown -R root:www-data /var/www/typecho
sudo find /var/www/typecho -type d -exec chmod 755 {} \;
sudo find /var/www/typecho -type f -exec chmod 644 {} \;
if [ -f /var/www/typecho/config.inc.php ]; then
sudo chown root:www-data /var/www/typecho/config.inc.php
sudo chmod 640 /var/www/typecho/config.inc.php
fi
sudo mkdir -p /var/www/typecho/usr/uploads
sudo chown -R www-www-data /var/www/typecho/usr/uploads
sudo find /var/www/typecho/usr/uploads -type d -exec chmod 755 {} \;
sudo find /var/www/typecho/usr/uploads -type f -exec chmod 644 {} \;
如果 Typecho 版本或某个主题明确要求其他目录可写,应只对对应目录开放写权限,不要为了绕过错误把整个 /var/www/typecho 改成 777。
如果网站根目录存在安装脚本,完成安装后可以改名保存:
if [ -f /var/www/typecho/install.php ]; then
sudo mv /var/www/typecho/install.php \
/var/www/typecho/install.php.disabled
fi
改名的目的不是删除文件,而是避免安装入口长期暴露。若后续升级或维护确实需要该文件,可以在备份和维护窗口中恢复。
七、配置 HTTPS 并切换到正式访问
1. 申请证书前的检查
证书申请依赖域名解析和 80 端口访问。先确认域名能命中当前服务器:
curl -I -H 'Host: example.com' http://127.0.0.1/
curl -I http://example.com/
第二条命令需要在公网 DNS 已生效、80 端口可访问时执行。若域名访问的不是当前服务器,先检查 A 记录、AAAA 记录、云安全组和 UFW。
在修改 Nginx 前备份站点配置:
sudo cp -a /etc/nginx/sites-available/typecho \
/etc/nginx/sites-available/typecho.before-certbot
2. 使用 Certbot 配置证书
安装 Certbot 的 Nginx 插件:
sudo apt install -y certbot python3-certbot-nginx
申请证书并让 Certbot 修改 Nginx 配置:
sudo certbot --nginx \
-d example.com \
-d www.example.com
根据提示选择是否将 HTTP 自动跳转到 HTTPS。正式博客通常应选择重定向到 HTTPS,但必须确认两个域名都能解析到当前服务器,否则包含 www 的证书申请可能失败。
申请成功后检查:
sudo nginx -t
sudo systemctl reload nginx
sudo certbot certificates
预期能看到证书覆盖的域名和有效期。证书续期测试:
sudo certbot renew --dry-run
--dry-run 只用于模拟续期流程。如果失败,查看 Certbot 输出和 Nginx 配置,不要反复申请新证书。
3. 验证 HTTPS 和 Typecho 地址
检查 HTTP 是否跳转:
curl -I http://example.com/
如果启用了强制 HTTPS,预期会看到 301 或 308,并带有类似:
Location: https://example.com/
检查 HTTPS:
curl -I https://example.com/
curl -I https://www.example.com/
浏览器访问后台和首页,重点确认:
- 页面中的图片和 CSS 没有继续使用 HTTP;
- 登录后不会立即退出;
- 文章链接没有跳回 HTTP;
- 后台保存文章时没有 CSRF 或 Cookie 错误;
- 浏览器地址栏显示有效证书。
如果安装时站点地址填写的是 HTTP,而现在启用了 HTTPS,Typecho 生成的链接可能仍然使用 HTTP。可以在后台站点设置中将站点地址改为 https://example.com,修改前先记下原值。若后台无法访问,再根据当前 Typecho 版本和数据库结构进行有备份的配置修正,不建议直接猜测并修改数据库字段。
八、上线前的验收检查
1. 服务状态检查
systemctl is-active nginx
systemctl is-active php8.1-fpm
systemctl is-active mariadb
三条命令都应返回:
active
检查开机启动状态:
systemctl is-enabled nginx
systemctl is-enabled php8.1-fpm
systemctl is-enabled mariadb
应返回:
enabled
2. PHP 和数据库检查
php -m | grep -E 'curl|gd|mbstring|PDO|pdo_mysql|xml|zip'
sudo php-fpm8.1 -t
mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1 AS db_ok;"
验收标准:
pdo_mysql存在;- PHP-FPM 配置测试成功;
- 数据库账户能访问
typecho数据库; - 不使用数据库 root 账户运行 Typecho。
3. 网站功能检查
| 检查项目 | 操作 | 通过标准 |
|---|---|---|
| 首页 | 访问 https://example.com/ | 返回 200,页面可显示 |
| 后台 | 访问后台入口并登录 | 可以登录且不会循环跳转 |
| 文章 | 发布测试文章 | 文章可保存并可访问 |
| 图片 | 上传小图片 | 图片出现在 usr/uploads |
| 伪静态 | 打开文章详情页 | 非首页 URL 不返回 404 |
| HTTPS | 检查浏览器和 curl | 证书有效,HTTP 按预期跳转 |
| 数据库 | 执行 SELECT 1 | 专用账户连接成功 |
| 端口 | ss -lntp 检查 | 3306 不对公网监听 |
| 日志 | 查看 Nginx、PHP-FPM 日志 | 没有持续性严重错误 |
查看最近的站点日志:
sudo tail -n 50 /var/log/nginx/typecho.access.log
sudo tail -n 50 /var/log/nginx/typecho.error.log
sudo journalctl -u php8.1-fpm -n 50 --no-pager
sudo journalctl -u mariadb -n 50 --no-pager
首次上线后建议删除测试文章和测试图片,避免把测试内容当作正式内容发布。
九、常见异常与处理顺序
1. 域名打不开或访问到其他页面
先从外到内检查:

dig +short example.com
curl -I http://example.com/
sudo ufw status verbose
sudo systemctl is-active nginx
不同结果通常表示:
dig没有返回服务器 IP:DNS 记录还未生效或记录填写错误;- DNS 正确但连接超时:检查云安全组、UFW、服务器公网 IP 和 IPv6;
- 返回 Nginx 默认页面:默认站点抢先响应,或
server_name没有匹配; - 返回 404:检查
root路径和 Typecho 文件是否位于/var/www/typecho; - 返回 502:继续检查 PHP-FPM Socket 和服务状态。
查看 Nginx 实际加载的完整配置:
sudo nginx -T | less
重点确认 server_name、root、try_files 和 fastcgi_pass 是否来自预期站点文件。
2. 出现 502 Bad Gateway
执行:
systemctl --no-pager --full status php8.1-fpm
ls -l /run/php/
sudo tail -n 80 /var/log/nginx/typecho.error.log
如果错误类似:
connect() to unix:/run/php/php8.1-fpm.sock failed
说明 Nginx 配置的 Socket 不存在,可能是 PHP 版本不一致,也可能是 PHP-FPM 没有启动。根据 ls -l /run/php/ 的实际结果修改 fastcgi_pass,修改后执行:
sudo nginx -t
sudo systemctl reload nginx
如果 Socket 存在但仍然 502,查看 PHP-FPM 日志,重点关注进程启动失败、配置语法错误和权限错误:
sudo journalctl -u php8.1-fpm -n 100 --no-pager
3. 首页正常但文章链接 404
这通常不是数据库错误,而是 Nginx 没有把不存在的静态路径转发到 Typecho 入口。检查站点配置中是否包含:
location / {
try_files $uri $uri/ /index.php?$args;
}
修改后验证并重新加载:
sudo nginx -t
sudo systemctl reload nginx
如果仍然 404,确认 Typecho 后台使用的站点地址与当前访问地址一致,并检查是否存在其他 Nginx location 规则覆盖了 /。
4. 安装页面提示无法连接数据库
先独立测试数据库账户:
mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1;"
如果连接失败,按以下顺序检查:
- 密码是否与创建用户时完全一致;
- 数据库名称是否为
typecho; - 用户名是否为
typecho_app; - 主机是否填写
localhost; - MariaDB 是否正在运行;
- 数据库用户是否只创建成了
127.0.0.1或其他 Host。
查看用户授权:
sudo mariadb -e "SHOW GRANTS FOR 'typecho_app'@'localhost';"
如果 pdo_mysql 不存在,重装对应扩展并重启 PHP-FPM:
sudo apt install -y php8.1-mysql
sudo systemctl restart php8.1-fpm
5. 上传图片失败
先检查三层限制:
sudo nginx -T | grep -n client_max_body_size
grep -R "upload_max_filesize\|post_max_size" \
/etc/php/8.1/fpm/php.ini \
/etc/php/8.1/fpm/conf.d/
然后检查上传目录权限和磁盘空间:
sudo ls -ld /var/www/typecho/usr/uploads
df -h /var/www/typecho
df -i /var/www/typecho
上传失败可能来自以下原因:
- 文件超过 Nginx 的 22M 限制;
- 文件超过 PHP 的 20M 上传限制;
post_max_size小于上传请求总量;www-data无法写入usr/uploads;- 磁盘空间或 inode 耗尽;
- PHP-FPM 重启后仍使用旧配置。
修改 PHP 配置后必须重启或 reload PHP-FPM:
sudo systemctl restart php8.1-fpm
sudo nginx -t
sudo systemctl reload nginx
6. 页面出现 403、500 或空白
先看错误日志,不要直接把 display_errors 打开到公网:
sudo tail -n 100 /var/log/nginx/typecho.error.log
sudo journalctl -u php8.1-fpm -n 100 --no-pager
常见原因包括:
- 网站文件所有者和目录权限不正确;
config.inc.php不存在或内容不完整;- PHP 扩展缺失;
- 主题或插件与当前 PHP 版本不兼容;
- PHP-FPM 内存限制不足;
- Nginx 的
try_files或root指向错误目录。
如果问题是在启用某个主题或插件后出现,先通过后台停用;如果后台也无法进入,先备份数据库和网站文件,再将对应主题或插件目录改名,而不是直接删除:
sudo mv /var/www/typecho/usr/plugins/插件目录 \
/var/www/typecho/usr/plugins/插件目录.disabled
改名会影响网站功能,执行前应确认目录名称,操作后记录原路径,方便回滚。
十、备份与回滚方案
1. 首次上线前创建备份
数据库和网站文件必须分别备份。先创建只有 root 可访问的备份目录:
sudo install -d -m 700 /var/backups/typecho
STAMP="$(date +%F-%H%M)"
备份数据库:
sudo sh -c \
"mariadb-dump --single-transaction --quick --routines --triggers typecho > /var/backups/typecho/db-${STAMP}.sql"
sudo chmod 600 "/var/backups/typecho/db-${STAMP}.sql"
备份网站文件:
sudo tar -C /var/www \
-czf "/var/backups/typecho/site-${STAMP}.tar.gz" \
typecho
sudo chmod 600 "/var/backups/typecho/site-${STAMP}.tar.gz"
检查备份文件是否生成:
sudo ls -lh /var/backups/typecho/
数据库备份和网站文件备份必须使用接近的时间点。只备份数据库而不备份 usr/uploads,恢复后文章可能存在但图片丢失;只备份文件而没有数据库,文章内容、用户和配置也无法完整恢复。
2. 配置回滚
如果修改 Nginx 后出现异常,先恢复修改前的站点配置:
sudo cp -a /etc/nginx/sites-available/typecho.before-certbot \
/etc/nginx/sites-available/typecho
sudo nginx -t
sudo systemctl reload nginx
如果 PHP 参数修改导致 PHP-FPM 无法启动,可以暂时移除新增配置文件:
sudo mv /etc/php/8.1/fpm/conf.d/99-typecho.ini \
/etc/php/8.1/fpm/conf.d/99-typecho.ini.disabled
sudo php-fpm8.1 -t
sudo systemctl restart php8.1-fpm
如果 HTTPS 配置后站点无法加载,先检查:
sudo nginx -t
sudo certbot certificates
sudo journalctl -u nginx -n 100 --no-pager
不要在 nginx -t 失败时继续 reload,也不要直接删除整份 Nginx 配置。优先恢复备份文件,保留问题配置供后续分析。
3. 文件和数据库恢复
恢复前先停止 PHP-FPM,避免恢复过程中仍有请求写入文件:
sudo systemctl stop php8.1-fpm
恢复网站文件前,先把当前目录改名保留。下面的路径必须确认是本站目录,执行错误会影响网站文件:
sudo mv /var/www/typecho /var/www/typecho.failed-restore
sudo tar -C /var/www \
-xzf /var/backups/typecho/site-YYYY-MM-DD-HHMM.tar.gz
恢复数据库前,必须确认备份对应的是当前 Typecho 站点,并且数据库中没有需要保留的新文章。数据库导入会覆盖同名表数据:
sudo mariadb typecho < /var/backups/typecho/db-YYYY-MM-DD-HHMM.sql
重新设置权限并启动服务:
sudo chown -R root:www-data /var/www/typecho
sudo find /var/www/typecho -type d -exec chmod 755 {} \;
sudo find /var/www/typecho -type f -exec chmod 644 {} \;
sudo mkdir -p /var/www/typecho/usr/uploads
sudo chown -R www-www-data /var/www/typecho/usr/uploads
sudo systemctl start php8.1-fpm
sudo nginx -t
sudo systemctl reload nginx
恢复后重新检查首页、后台、文章和图片。若备份是升级前生成的,数据库结构和程序版本应保持匹配,不能只恢复其中一部分。
4. 放弃本次新建部署时的清理
如果这是全新服务器上的失败安装,并且已经确认数据库没有其他业务数据,可以删除 Typecho 专用数据库和账户。但这是不可逆操作,执行前必须确认数据库名称和账户确实只供本次 Typecho 使用,并且已经完成备份。
DROP DATABASE `typecho`;
DROP USER 'typecho_app'@'localhost';
FLUSH PRIVILEGES;
网站目录和 Nginx 配置也不要直接使用 rm -rf 清理。更安全的方式是先改名保留:
sudo mv /var/www/typecho /var/www/typecho.failed
sudo mv /etc/nginx/sites-enabled/typecho \
/etc/nginx/sites-enabled/typecho.disabled
保留失败现场有助于检查日志、配置和权限问题,也可以在确认没有价值后再按维护流程清理。
最终验收应同时满足以下条件:域名解析指向香港服务器;80 和 443 按预期开放;Nginx、PHP-FPM、MariaDB 均能正常启动;Typecho 使用独立数据库账户;3306 不对公网监听;HTTPS 页面、后台、文章和图片均可访问;配置文件和上传目录权限符合最小写入原则;数据库与网站文件备份已经生成;并且能够根据备份文件恢复到上线前状态。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3394.html


