如何在日本服务器部署Typecho博客并验证网站访问?
将 Typecho 部署到日本服务器,核心不是只把程序文件上传到网站目录,而是同时完成操作系统初始化、Web 服务配置、PHP 扩展安装、数据库创建、域名解析、HTTPS 配置和上线验证。下面以 Ubuntu 22.04 LTS、Nginx、PHP 8.1、MariaDB 10.6、Typecho 1.2.x 为示例,目标是让绑定域名能够通过 HTTPS 正常打开 Typecho 安装页、完成初始化,并验证首页、后台、文章发布和伪静态访问均可用。

示例服务器使用公网 IPv4,域名以 blog.example.com 代替。命令需要通过 SSH 以具有 sudo 权限的账号执行。不同日本服务器的网络线路、控制台防火墙和系统镜像可能存在差异,文中的域名、IP、密码和数据库名称都应替换为自己的实际值。
面向日本本地访问及跨境内容站部署,A5数据提供日本物理服务器资源,覆盖Xeon Gold、AMD EPYC等平台,并配备NVMe或大容量存储及多种网络线路。针对Typecho博客、数据库和图片内容等场景,可提供从常规建站到更高计算、存储需求的服务器方案,为网站程序运行、数据保存和后续业务扩展提供基础资源。
一、部署目标与环境准备
1. 明确上线范围
本次部署完成后,应达到以下状态:
- 访问
https://blog.example.com可以打开 Typecho 首页。 - 访问
https://blog.example.com/admin/可以进入后台。 - 后台可以发布文章,并能从首页或分类页打开。
- 使用伪静态链接时,Nginx 能正确处理 Typecho 路由。
- HTTP 请求自动跳转到 HTTPS。
- 数据库、程序目录和日志路径清晰,便于备份与回滚。
- 未完成 DNS 或证书配置前,不直接把安装页面暴露给公众。
Typecho 本身资源占用较低。用于个人博客、技术文档或小型内容站时,1 核 1 GB 内存可以作为起步配置,但还要为系统、Nginx、PHP-FPM、MariaDB 和备份任务预留空间。若启用图片上传、搜索或较多插件,建议使用 2 核 2 GB 及以上配置。
2. 推荐环境与示例变量
| 项目 | 示例值 | 说明 |
|---|---|---|
| 操作系统 | Ubuntu 22.04 LTS x86_64 | 本文命令以此为准 |
| Web 服务 | Nginx | 负责静态文件、HTTPS 和 PHP 请求转发 |
| PHP | 8.1 | 通过 PHP-FPM 与 Nginx 配合 |
| 数据库 | MariaDB 10.6 | 保存文章、用户和配置数据 |
| 博客域名 | blog.example.com | 请替换为实际域名 |
| 网站目录 | /var/www/typecho | Typecho 程序文件位置 |
| PHP-FPM Socket | /run/php/php8.1-fpm.sock | Ubuntu 22.04 常见路径 |
| 数据库名 | typecho | 示例数据库 |
| 数据库用户 | typecho_user | 不建议使用数据库 root 连接程序 |
如果系统版本、PHP 版本或 PHP-FPM Socket 与示例不一致,不要直接照抄路径。可以先执行以下命令确认:
cat /etc/os-release
php -v
ls -l /run/php/
3. 准备域名和安全信息
开始安装前准备以下内容:
- 已注册并可管理 DNS 的域名。
- 日本服务器公网 IPv4 地址。
- SSH 登录账号和端口。
- 数据库名称、数据库用户和高强度密码。
- 用于后台登录的独立管理员密码。
- 服务器控制台中的安全组或防火墙管理权限。
数据库密码不应直接使用博客后台密码,也不要把密码写进公开仓库、工单或聊天记录。若服务器已有网站,先确认 80、443 端口是否被其他 Nginx、Apache 或面板占用。
二、登录服务器并完成基础检查
1. 连接服务器
在本地终端执行:
ssh your-user@SERVER_IP
如果 SSH 端口不是 22:
ssh -p 端口号 your-user@SERVER_IP
登录后确认当前身份和系统版本:
whoami
hostnamectl
cat /etc/os-release
预期可以看到当前登录用户名、主机名和 Ubuntu 版本信息。若当前账号不是 root,后续命令统一使用 sudo。
2. 更新系统软件包
先更新索引,再安装基础工具:
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl wget unzip ca-certificates gnupg lsb-release
执行完成后检查是否存在需要重启的核心服务:
sudo needrestart
如果输出提示内核或关键服务需要重启,应先确认当前没有正在进行的业务操作,再执行:
sudo reboot
重启会中断 SSH 连接,影响范围是当前服务器上的所有服务。若服务器已有生产网站,建议在维护时段执行,并提前确认业务是否具备容错能力。
3. 配置时区和主机名
日本服务器不一定默认使用日本时区。博客文章发布时间、日志时间和计划任务都依赖系统时间,建议统一设置为 Asia/Tokyo:
sudo timedatectl set-timezone Asia/Tokyo
timedatectl
预期输出中应包含:
Time zone: Asia/Tokyo (JST, +0900)
如果服务器承载多个项目,不建议仅为 Typecho 修改全局主机名;如果是新建实例,可以设置一个便于识别的名称:
sudo hostnamectl set-hostname typecho-jp
三、安装 Nginx、PHP-FPM 和 MariaDB
1. 安装 Web 与数据库组件
Ubuntu 22.04 默认仓库通常可提供 PHP 8.1、Nginx 和 MariaDB:
sudo apt install -y nginx mariadb-server mariadb-client \
php8.1-fpm php8.1-mysql php8.1-curl php8.1-gd \
php8.1-mbstring php8.1-xml php8.1-zip php8.1-opcache
安装后启动并设置开机自启:
sudo systemctl enable --now nginx
sudo systemctl enable --now php8.1-fpm
sudo systemctl enable --now mariadb
检查服务状态:
systemctl --no-pager --full status nginx
systemctl --no-pager --full status php8.1-fpm
systemctl --no-pager --full status mariadb
正常时应看到 active (running)。如果某项为 failed,先查看日志,不要反复重启:
sudo journalctl -u nginx -n 80 --no-pager
sudo journalctl -u php8.1-fpm -n 80 --no-pager
sudo journalctl -u mariadb -n 80 --no-pager
2. 验证 PHP 扩展和 FPM Socket
确认 PHP 版本:
php -v
php -m | grep -E 'curl|gd|mbstring|mysqli|pdo_mysql|xml|zip'
确认 PHP-FPM Socket:
ls -l /run/php/php8.1-fpm.sock
如果实际显示的是 php8.2-fpm.sock 或其他版本,后续 Nginx 配置必须使用实际路径。例如:
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
Typecho 安装失败时,缺少 pdo_mysql、mbstring、curl、gd 或 zip 是常见原因。扩展名称与 PHP 主版本有关,不能把 PHP 8.1 的包名直接套用到其他版本。
3. 进行 MariaDB 基础加固
执行安全配置向导:
sudo mariadb-secure-installation
不同 MariaDB 版本的提示文字可能不同,常见处理原则如下:
- 为数据库管理账号设置认证方式或密码。
- 删除匿名用户。
- 禁止远程 root 登录。
- 删除测试数据库。
- 重新加载权限表。
如果服务器已有其他业务数据库,删除测试库前应先确认库名,避免误操作。该向导主要作用是收紧默认配置,不会自动创建 Typecho 数据库。
完成后测试本地数据库登录:
sudo mariadb -e "SELECT VERSION();"
预期返回 MariaDB 版本号。如果命令失败,先检查 MariaDB 服务状态和错误日志。
四、创建 Typecho 数据库和独立用户
1. 创建数据库账户
使用本地 socket 登录 MariaDB:
sudo mariadb
在 MariaDB 提示符中执行以下 SQL。数据库名、用户名和密码仅为示例,请替换为自己的值:
CREATE DATABASE typecho
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
CREATE USER 'typecho_user'@'localhost'
IDENTIFIED BY 'Replace-With-A-Strong-Password';
GRANT ALL PRIVILEGES ON typecho.* TO 'typecho_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
utf8mb4 用于支持中文、日文及扩展字符。数据库用户只允许从 localhost 登录,Typecho 不需要通过公网连接数据库,因此不应把数据库用户开放为 % 来源。
2. 验证数据库用户
使用刚创建的账户测试连接:
mariadb -u typecho_user -p -h localhost typecho
输入密码后执行:
SELECT DATABASE(), USER();
EXIT;
预期结果中数据库为 typecho,用户为 typecho_user@localhost。如果出现 Access denied,重点检查数据库名、用户名、密码和授权来源。
若密码需要重新设置,使用管理员身份进入 MariaDB:
sudo mariadb
执行:
ALTER USER 'typecho_user'@'localhost'
IDENTIFIED BY 'New-Strong-Password';
FLUSH PRIVILEGES;
EXIT;
修改数据库密码后,Typecho 配置文件中的密码也必须同步修改,否则网站会出现数据库连接错误。
五、下载并部署 Typecho 程序
1. 创建网站目录
先创建目录并设置临时权限:
sudo mkdir -p /var/www/typecho
sudo chown -R "$USER":"$USER" /var/www/typecho
cd /var/www/typecho
如果服务器已有网站,不要直接使用其目录。每个站点应使用独立目录,以降低配置覆盖和文件误删风险。
2. 获取 Typecho 安装包
可以通过 Typecho 官方发布渠道获取稳定版本安装包。下面用一个占位下载地址演示,实际操作时应替换为已确认的正式下载地址:
cd /tmp
wget -O typecho.zip 'https://example.invalid/typecho-release.zip'
unzip -t typecho.zip
unzip -t 只检查压缩包完整性,不会写入网站目录。确认压缩包可正常读取后再解压:
unzip typecho.zip -d typecho-extract
find typecho-extract -maxdepth 2 -type f | head
不同发行包可能存在一层目录,例如:
typecho-extract/Typecho/
typecho-extract/install.php
也可能直接包含 index.php、admin 和 usr。先查看目录结构,再复制文件,避免把程序多嵌套一层导致访问路径变成 /Typecho/index.php。
示例复制方式:
sudo cp -a /tmp/typecho-extract/. /var/www/typecho/
检查网站根目录:
ls -la /var/www/typecho
正常情况下,应能看到 index.php、admin、usr 等内容。若实际文件位于 /var/www/typecho/Typecho,应将该层目录中的文件移动到网站根目录,或相应修改 Nginx 的 root,二者只能选择一种。
3. 设置程序文件权限
将网站目录交给 Web 服务用户:
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 {} \;
这组命令会修改整个 Typecho 目录的所有权和权限,影响范围仅为 /var/www/typecho。不要对网站目录使用 chmod -R 777,这会扩大写入权限,增加恶意文件被写入的风险。
如果后续通过 SSH 用户直接更新程序,可采用组权限方案,但需要额外规划用户组和发布流程。简单部署时,使用 www-data 作为文件所有者即可。
六、配置 Nginx 和 Typecho 伪静态
1. 创建站点配置
创建 Nginx 配置文件:
sudo nano /etc/nginx/sites-available/typecho
写入以下内容:

server {
listen 80;
listen [::]:80;
server_name blog.example.com;
root /var/www/typecho;
index index.php index.html;
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 ~ \.php$ {
try_files $uri =404;
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
location ~ /\.(?!well-known).* {
deny all;
}
}
需要替换的内容:
blog.example.com替换为实际域名。/var/www/typecho替换为实际网站目录。php8.1-fpm.sock替换为系统实际 Socket。- 日志路径可按服务器现有日志规范调整。
try_files $uri =404; 用于阻止访问不存在的 PHP 文件;location ~ /\.(?!well-known).* 用于限制隐藏文件访问,同时保留证书验证可能使用的 .well-known 目录。
2. 启用配置并检查语法
建立软链接:
sudo ln -s /etc/nginx/sites-available/typecho \
/etc/nginx/sites-enabled/typecho
如果默认站点占用相同监听配置,可以先检查:
ls -l /etc/nginx/sites-enabled/
不需要默认站点时再删除其软链接。删除操作会影响默认站点访问,先确认服务器没有依赖它:
sudo rm /etc/nginx/sites-enabled/default
检查 Nginx 配置:
sudo nginx -t
预期结果:
syntax is ok
test is successful
只有语法检查成功后才重新加载:
sudo systemctl reload nginx
如果 nginx -t 失败,不要执行 reload。根据错误行号检查分号、括号、路径和 Socket 名称:
sudo journalctl -u nginx -n 80 --no-pager
3. 在 DNS 生效前进行本机验证
如果域名还没有解析到服务器,可以从服务器本机使用 Host 头测试:
curl -I -H 'Host: blog.example.com' http://127.0.0.1/
预期可能返回:
HTTP/1.1 200 OK
Server: nginx
Content-Type: text/html
如果返回 404,重点检查 root 路径和 index.php 是否存在;如果返回 502 Bad Gateway,重点检查 PHP-FPM 是否运行以及 fastcgi_pass Socket 是否正确;如果返回其他站点内容,通常是 server_name 或默认站点匹配问题。
七、配置 DNS 并申请 HTTPS 证书
1. 添加 DNS 记录
在域名 DNS 管理平台添加:
| 类型 | 主机记录 | 值 | TTL |
|---|---|---|---|
| A | blog | 服务器公网 IPv4 | 默认或 300 秒 |
| AAAA | blog | 服务器公网 IPv6 | 仅在 IPv6 可用且已配置时添加 |
如果服务器没有可用 IPv6,不要添加错误的 AAAA 记录。部分访问者会优先使用 IPv6,错误 AAAA 可能导致部分地区无法连接。
使用本地或服务器检查解析:
dig +short blog.example.com A
dig +short blog.example.com AAAA
预期 A 记录应返回服务器公网 IPv4。DNS 缓存存在传播时间,TTL 较长时,修改不会立即在所有递归 DNS 服务器上生效。
2. 放行 HTTP 和 HTTPS
如果使用 UFW,执行前先确认 SSH 规则已经放行:
sudo ufw status verbose
若 SSH 已允许,再添加 Web 端口:
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status
ufw enable 会改变服务器入站访问策略,若 SSH 规则没有提前放行,可能导致远程连接中断。云平台安全组也要同时放行 TCP 80 和 443,仅配置 UFW 而未配置云安全组仍可能无法访问。
如果服务器由面板或云厂商防火墙管理,不要重复启用多套策略,先确认实际生效的防火墙层级。
3. 安装 Certbot 并申请证书
Ubuntu 22.04 可使用 apt 安装 Certbot 和 Nginx 插件:
sudo apt install -y certbot python3-certbot-nginx
确认域名已经解析,并且外部可以访问 80 端口后执行:
sudo certbot --nginx -d blog.example.com
Certbot 通常会要求填写邮箱、同意服务条款,并询问是否将 HTTP 重定向到 HTTPS。若博客不需要保留明文 HTTP,选择重定向方案。
申请成功后检查证书:
sudo certbot certificates
检查 Nginx 配置并重新加载:
sudo nginx -t
sudo systemctl reload nginx
测试自动续期流程:
sudo certbot renew --dry-run
--dry-run 不会真正替换线上证书,但会模拟续期流程。预期结果包含续期测试成功的信息。如果失败,检查 80 端口是否可访问、DNS 是否正确、证书验证目录是否被 Nginx 规则拦截。
不要把证书私钥复制到网站公开目录,也不要在不确认配置的情况下手动删除 /etc/letsencrypt。删除证书目录可能影响已有站点。
八、通过 Typecho 安装页面完成初始化
1. 打开安装地址
在浏览器访问:
https://blog.example.com/install.php
如果可以打开 Typecho 检测页面,说明 Nginx、HTTPS、PHP-FPM 和程序文件已经基本连通。
安装页面通常会检查:
- PHP 版本。
- 必需扩展。
- 网站目录写入权限。
- 数据库连接能力。
- 配置文件生成条件。
如果页面提示缺少扩展,返回服务器安装对应 PHP 包。例如:
sudo apt install -y php8.1-mbstring php8.1-curl php8.1-gd php8.1-xml php8.1-zip
sudo systemctl restart php8.1-fpm
重启 PHP-FPM 会短暂中断正在处理的 PHP 请求,静态文件和 Nginx 进程通常不受影响。操作完成后刷新安装页。
2. 填写数据库信息
安装页面中的数据库配置填写示例:
| 字段 | 示例值 |
|---|---|
| 数据库适配器 | Pdo_Mysql 或页面提供的 MySQL 选项 |
| 数据库地址 | localhost |
| 数据库用户名 | typecho_user |
| 数据库密码 | 创建用户时设置的密码 |
| 数据库名称 | typecho |
| 表前缀 | typecho_ |
若页面要求填写端口,MariaDB 默认端口通常为 3306。数据库仅本地连接时,地址使用 localhost 或 127.0.0.1 应与当前 PHP 驱动行为相匹配;遇到连接差异时优先查看 Typecho 页面报错和 MariaDB 日志。
数据库表前缀不等于数据库安全隔离。真正的隔离依赖独立数据库和独立账户。多套 Typecho 共用同一数据库时,可以使用不同表前缀,但备份、权限和误操作风险都会增加。
3. 设置站点和管理员
填写:
- 站点名称。
- 站点地址:
https://blog.example.com。 - 管理员用户名。
- 管理员密码。
- 管理员邮箱。
站点地址必须使用最终上线的 HTTPS 域名,不要先填服务器 IP,避免后续生成链接、后台跳转和资源地址不一致。
管理员密码应满足较高复杂度,避免使用域名、用户名、生日或常见短语。完成安装后,记录后台地址:
https://blog.example.com/admin/
如果安装页报错并需要重新安装,先查看网站目录是否已生成配置文件和数据表,避免重复初始化覆盖已有内容。
九、安装后的权限收紧和基础设置
1. 检查配置文件
Typecho 安装后通常会生成配置文件。先查看文件名,不要直接猜测:
find /var/www/typecho -maxdepth 2 -type f \
\( -name 'config.inc.php' -o -name '*.php' \) -ls
如果存在 config.inc.php,确认其所有者和权限:
sudo stat /var/www/typecho/config.inc.php
可将该文件权限收紧为仅所有者可读:
sudo chmod 600 /var/www/typecho/config.inc.php
此命令只影响配置文件,不会影响 Typecho 运行,因为 PHP-FPM 与文件所有者同属 www-data。如果实际运行用户不同,应先通过 PHP-FPM 配置确认,不要盲目修改。
2. 删除或保护安装入口
安装完成后,先确认后台和首页均可访问,再处理安装文件:
sudo ls -l /var/www/typecho/install.php
如果该文件存在且版本允许删除,可在确认备份完成后删除:
sudo rm -f /var/www/typecho/install.php
删除是不可逆的文件操作,影响范围仅为 Typecho 安装入口。回滚方式是从与当前版本匹配的程序包中恢复该文件。若不希望删除,也可以通过 Nginx 禁止访问:
location = /install.php {
deny all;
}
修改配置后执行:
sudo nginx -t
sudo systemctl reload nginx
3. 设置固定链接并验证伪静态
登录后台后,在站点设置中选择适合的永久链接格式。保存后创建一篇测试文章,例如标题为“部署验证文章”。
从后台复制文章链接,在服务器或本地执行:
curl -I 'https://blog.example.com/测试文章链接'
预期返回 200 OK 或根据 Typecho 路由返回正常页面状态。如果返回 404:
- 检查 Nginx
location /是否包含try_files $uri $uri/ /index.php?$args;。 - 检查是否修改了错误的站点配置文件。
- 执行
sudo nginx -t。 - 查看
/var/log/nginx/typecho_error.log。 - 确认文章链接中没有使用不兼容的特殊字符或错误编码。
十、逐项验证网站是否真正上线
1. DNS、端口和 TLS 验证
检查域名解析:
dig +short blog.example.com A
检查 HTTPS 响应头:
curl -I https://blog.example.com/
预期结果类似:
HTTP/2 200
server: nginx
content-type: text/html; charset=UTF-8
检查 HTTP 是否跳转:
curl -I http://blog.example.com/
预期类似:
HTTP/1.1 301 Moved Permanently
location: https://blog.example.com/
若 HTTP 返回 200 且未跳转,说明 Certbot 没有写入重定向,或后续修改覆盖了证书工具生成的配置。可以检查 Nginx 配置:
sudo nginx -T | less
不要仅以浏览器能打开为准。浏览器可能使用缓存、自动补全 HTTPS 或忽略部分证书提示,命令行结果更适合确认状态码和跳转链。
2. 首页、后台和静态资源验证
检查首页:
curl -sS -o /dev/null -w '%{http_code}\n' \
https://blog.example.com/
检查后台:
curl -sS -o /dev/null -w '%{http_code}\n' \
https://blog.example.com/admin/
检查常见静态资源:
curl -I https://blog.example.com/usr/themes/
后台未登录时可能返回 200、302 或登录页面相关状态,关键是不能出现 502、Nginx 默认页或 PHP 源码泄露。
3. 发布文章并进行端到端验证
通过后台完成以下动作:

- 创建一篇测试文章。
- 上传一张尺寸适中的图片。
- 保存并发布。
- 从前台打开文章。
- 注销后台后再次访问文章。
- 检查图片、CSS 和主题资源是否均为 HTTPS。
浏览器开发者工具的 Network 面板中,如果出现 Mixed Content,通常是站点地址、主题资源地址或文章中的图片仍然使用 http://。应先检查 Typecho 站点地址,再检查主题模板和文章正文中的绝对链接。
4. 检查服务和日志
确认服务状态:
systemctl is-active nginx
systemctl is-active php8.1-fpm
systemctl is-active mariadb
查看最近的 Nginx 错误:
sudo tail -n 50 /var/log/nginx/typecho_error.log
查看 PHP-FPM 日志:
sudo journalctl -u php8.1-fpm -n 50 --no-pager
检查磁盘空间:
df -h
检查内存:
free -h
如果网站刚上线就出现 502,常见原因是 PHP-FPM 停止、Socket 路径错误或 PHP 进程资源不足。如果文章发布失败但首页正常,重点检查数据库连接、目录写入权限和 PHP 上传限制。
十一、常见异常及处理方式
1. 浏览器显示连接超时
按由外到内的顺序检查:

dig +short blog.example.com A
sudo ss -lntp | grep -E ':80|:443'
sudo ufw status verbose
判断方法:
- DNS 不是服务器 IP:修正 A 记录,等待缓存更新。
- 80/443 没有监听:检查 Nginx 状态和配置。
- 本机监听但外部超时:检查云安全组、UFW、上游网络策略。
- 只有 IPv6 访问失败:检查是否存在错误 AAAA 记录。
2. 出现 Nginx 502 Bad Gateway
执行:
systemctl status php8.1-fpm --no-pager
ls -l /run/php/
sudo tail -n 50 /var/log/nginx/typecho_error.log
如果 Socket 实际名称是 php8.2-fpm.sock,修改 Nginx:
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
然后验证并加载:
sudo nginx -t
sudo systemctl reload nginx
如果 PHP-FPM 未运行:
sudo systemctl restart php8.1-fpm
重启前应确认没有正在执行的长时间 PHP 任务。重启只影响 PHP 请求处理,不会删除网站文件或数据库内容。
3. 安装页面提示数据库连接失败
先从命令行验证:
mariadb -u typecho_user -p -h localhost typecho
若命令行也失败,检查:
- 用户名是否拼写正确。
- 数据库名是否正确。
- 密码是否包含误输入字符。
- 用户授权是否为
localhost。 - MariaDB 是否运行。
查看授权信息:
sudo mariadb -e "SHOW GRANTS FOR 'typecho_user'@'localhost';"
如果需要重新授权,应只授权 Typecho 数据库,不要执行针对所有数据库的宽泛授权:
GRANT ALL PRIVILEGES ON typecho.* TO 'typecho_user'@'localhost';
FLUSH PRIVILEGES;
4. 伪静态链接返回 404
确认配置中存在:
location / {
try_files $uri $uri/ /index.php?$args;
}
随后执行:
sudo nginx -t
sudo systemctl reload nginx
如果仍然 404,查看访问日志:
sudo tail -n 50 /var/log/nginx/typecho_access.log
若日志显示请求进入了另一个 server_name,说明站点匹配错误;若请求进入正确站点但返回 404,检查 Typecho 固定链接设置和程序目录。
5. 上传图片失败
查看 PHP 限制:
php -i | grep -E 'upload_max_filesize|post_max_size|memory_limit'
PHP-FPM 使用的配置可能与命令行 PHP 不同,可创建临时探针确认,但不要长期暴露 phpinfo() 页面。更安全的做法是直接检查 FPM 配置目录:
grep -R 'upload_max_filesize\|post_max_size\|memory_limit' \
/etc/php/8.1/fpm/ 2>/dev/null
编辑配置前先备份:
sudo cp /etc/php/8.1/fpm/php.ini \
/etc/php/8.1/fpm/php.ini.bak
按图片大小调整,例如:
upload_max_filesize = 16M
post_max_size = 20M
memory_limit = 128M
修改后重启 PHP-FPM:
sudo systemctl restart php8.1-fpm
post_max_size 应大于 upload_max_filesize,否则较大的上传请求仍可能失败。具体值应结合服务器内存和图片处理需求设置,不宜无限增大。
6. 页面出现 403 或无法读取主题文件
检查目录和文件权限:
namei -l /var/www/typecho/index.php
sudo -u www-data test -r /var/www/typecho/index.php
echo $?
返回 0 表示 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 {} \;
该操作会覆盖网站目录内已有权限设置。如果插件或主题需要特定写入目录,应先记录其要求,并只对必要目录授予写权限。
十二、备份、回滚与重新部署策略
1. 部署前制作备份
如果服务器原本没有 Typecho 数据,可以保存程序包和配置快照;如果已经存在博客,先备份数据库和网站目录。
备份数据库:
sudo mariadb-dump \
--single-transaction \
--routines \
--triggers \
typecho | gzip > /root/typecho-$(date +%F-%H%M).sql.gz
备份网站文件:
sudo tar -czf /root/typecho-files-$(date +%F-%H%M).tar.gz \
-C /var/www typecho
查看备份文件:
ls -lh /root/typecho-*.gz
数据库备份包括文章、用户、配置和插件数据;网站文件备份包括主题、上传内容和程序文件。两者缺一不可。
2. 配置回滚
修改 Nginx 前先备份:
sudo cp /etc/nginx/sites-available/typecho \
/etc/nginx/sites-available/typecho.bak
如果新配置导致检查失败,可恢复:
sudo cp /etc/nginx/sites-available/typecho.bak \
/etc/nginx/sites-available/typecho
sudo nginx -t
sudo systemctl reload nginx
修改 PHP 配置前也应保留备份。回滚后必须重新执行 nginx -t 或重启对应服务,并通过浏览器和 curl 验证。
3. 回滚程序文件
如果新主题或插件导致网站异常,优先在后台停用最近安装的插件,并恢复主题。无法进入后台时,可以先将问题插件目录改名,而不是立即删除:
sudo mv /var/www/typecho/usr/plugins/PluginName \
/var/www/typecho/usr/plugins/PluginName.disabled
改名操作可逆,回滚方式是改回原目录名。目录名必须替换为实际插件目录,执行前先列出目录:
sudo ls -la /var/www/typecho/usr/plugins/
若程序文件被覆盖或损坏,可从匹配版本的安装包恢复,但不要直接覆盖 usr/uploads、配置文件和自定义主题,除非已经完成备份并明确需要这样做。
4. 数据库恢复
恢复数据库会覆盖目标数据库中的现有表和数据,属于高风险操作。执行前必须确认备份文件、数据库名称和恢复时间点。
一种稳妥方式是先创建临时数据库验证备份:
sudo mariadb -e "CREATE DATABASE typecho_restore_test
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
zcat /root/typecho-YYYY-MM-DD-HHMM.sql.gz | \
sudo mariadb typecho_restore_test
sudo mariadb -e "SHOW TABLES FROM typecho_restore_test;"
确认备份可读后,停止写入或进入维护状态,再恢复正式数据库。恢复完成后检查表数量、最新文章和后台登录状态。临时数据库确认无误后删除:
sudo mariadb -e "DROP DATABASE typecho_restore_test;"
删除临时数据库不可逆,确认库名无误后再执行。
十三、上线验收清单
服务与系统
- [ ] Ubuntu 版本与 PHP、Nginx、MariaDB 版本已记录。
- [ ]
nginx、php8.1-fpm、mariadb均显示运行中。 - [ ] 系统时区已设置为
Asia/Tokyo或团队统一时区。 - [ ] 磁盘空间和内存余量满足当前博客使用。
- [ ] SSH、80、443 端口策略已确认。
- [ ] 未对网站目录使用
777权限。
域名与 HTTPS
- [ ] A 记录指向正确的日本服务器公网 IPv4。
- [ ] 不需要 IPv6 时没有错误 AAAA 记录。
- [ ]
http://能跳转到https://。 - [ ] HTTPS 证书域名匹配,浏览器无证书警告。
- [ ]
certbot renew --dry-run通过或已有明确续期方案。
Typecho 功能
- [ ] 首页可以访问。
- [ ]
/admin/可以登录。 - [ ] 数据库使用独立用户,不使用 root。
- [ ] 测试文章可以发布并从前台打开。
- [ ] 主题 CSS、图片和脚本均能通过 HTTPS 加载。
- [ ] 固定链接和伪静态访问正常。
- [ ] 安装入口已删除或禁止访问。
- [ ] 配置文件权限已收紧。
备份与恢复
- [ ] 数据库备份文件可以读取。
- [ ] 网站程序、主题和上传目录已备份。
- [ ] Nginx、PHP 配置修改前保留了旧版本。
- [ ] 已记录数据库恢复命令和备份文件位置。
- [ ] 已明确插件或主题故障时的停用、改名和恢复路径。
完成上述检查后,日本服务器上的 Typecho 才算完成从安装到上线的闭环。后续运维应保持程序、主题、插件和系统的变更记录,更新前先备份,更新后重新验证首页、后台、文章发布、图片上传、HTTPS 和伪静态链接。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3695.html



