如何在香港服务器上用Nginx与PHP部署Typecho博客?
在香港服务器上部署 Typecho,可以采用“Ubuntu 24.04 LTS+Nginx+PHP 8.3-FPM+MariaDB”的组合:Nginx 处理静态文件和 HTTPS 请求,PHP-FPM 执行博客程序,MariaDB 保存文章、评论与设置。完成部署后,应当能够通过域名访问首页、登录后台、发布文章并上传图片,同时保证数据库不对公网开放、上传目录不能执行 PHP。
下面按新服务器的操作顺序展开。适用环境是具有公网 IP、可通过 SSH 管理的 Ubuntu 24.04 LTS 香港服务器,Typecho 使用明确兼容 PHP 8.3 的稳定发行包。若服务器已有其他网站、管理面板或不同版本的 PHP,不要直接套用覆盖配置,应先核对现有服务并建立独立站点。
Typecho 博客的运行体验,与服务器的计算、内存、存储和网络资源密切相关。A5数据提供香港物理服务器租用,涵盖入门建站、Xeon Gold 与 AMD EPYC 等配置,配有 SSD 或 NVMe 存储,并提供 CN2 与国际带宽等不同线路选择,可为博客程序、数据库及相关网站服务提供部署资源。
一、准备条件与部署边界
需要准备什么
| 项目 | 本文使用方式 | 上线前核对 |
|---|---|---|
| 操作系统 | Ubuntu 24.04 LTS | 不混用其他发行版的软件包命令 |
| 域名 | blog.example.com,仅作示例 | 替换为自己的域名,配置 A 记录 |
| Web 服务 | Ubuntu 软件源中的 Nginx | 80、443 端口没有被其他程序占用 |
| PHP | PHP 8.3-FPM | Typecho、主题和插件均兼容该版本 |
| 数据库 | MariaDB,单机部署 | 只监听本机,不开放公网 3306 |
| 程序目录 | /var/www/typecho | 本文只操作这个站点目录 |
| 管理入口 | SSH 与 Typecho 后台 | 使用独立强密码,保存恢复凭据 |
对于内容量较少、访问量不高的个人博客,2 个 vCPU、2 GB 内存可以作为起步配置参考,不是性能保证。图片体积、插件数量、并发访问和数据库规模都会影响实际资源需求。
服务器位于香港,不代表所有访问地区都具有相同的网络表现。上线后应从主要读者所在地检查 HTTPS 连接、页面加载和图片请求,而不是只在服务器本机打开首页。
域名需要能够公开解析。若配置了 AAAA 记录,服务器的 IPv6 路由、监听与防火墙也必须正常;没有可用 IPv6 时,不要保留指向错误地址的 AAAA 记录。站点内容及经营活动仍应遵守适用法律、域名服务与服务器服务协议。
先确认系统,再建立恢复点
本文后续命令在管理员执行 sudo -i 后的 root Shell 中运行。root 可以修改系统配置,因此复制命令前必须确认路径和域名。
sudo -i
cat /etc/os-release
ss -lntp
df -h /
DOMAIN=blog.example.com
BACKUP=/root/typecho-deploy-$(date +%Y%m%d-%H%M%S)
mkdir -p "$BACKUP"
chmod 700 "$BACKUP"
if [ -d /etc/nginx ]; then
cp -a /etc/nginx "$BACKUP/nginx"
fi
echo "$BACKUP"
应确认系统标识为 Ubuntu 24.04,并检查 80、443 是否已被使用。记录最后输出的备份目录;重新登录后,Shell 变量不会自动保留。
安装前建议通过服务器控制台创建系统盘快照。下面的软件包安装会改变系统状态,配置备份只能恢复配置文件,不能完整撤销软件包及依赖变化。
二、安装 Nginx、PHP 与数据库,并逐项验证
安装运行环境
apt update
apt install -y nginx mariadb-server \
php8.3-fpm php8.3-cli php8.3-mysql \
php8.3-mbstring php8.3-xml php8.3-curl \
php8.3-gd php8.3-zip \
curl unzip ca-certificates certbot
systemctl enable --now nginx mariadb php8.3-fpm
这里的 php8.3-mysql 提供 PHP 连接 MariaDB 所需的驱动。GD 用于图片处理,其他扩展用于程序或常见主题、插件的运行需求;具体插件仍可能有额外依赖。
执行以下检查:
nginx -v
php -v
php -m | grep -Ei 'pdo_mysql|mysqli|mbstring|xml|curl|gd|zip'
systemctl is-active nginx mariadb php8.3-fpm
ls -l /run/php/php8.3-fpm.sock
预期三个服务分别返回 active,PHP 版本为 8.3,且存在 PHP-FPM socket。
注意,php -v 检查的是命令行 PHP,不能单独证明 Nginx 已连接 PHP-FPM。后面的安装页面和完整请求验证才是 Web 执行链路的检查。
检查网络放行
云平台安全组至少需要允许:
- 管理员访问实际 SSH 端口;条件允许时限制来源 IP。
- 公网访问 TCP 80,用于 HTTP 跳转和证书验证。
- 公网访问 TCP 443,用于 HTTPS。
- 不开放 TCP 3306 和 PHP-FPM 的服务端口。
先检查本机防火墙:
ufw status verbose
若使用 UFW,可添加对应规则。下面的 22 只适用于 SSH 确实监听 22 端口的服务器:
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
不要在没有确认 SSH 放行的情况下执行 ufw enable。 如果 UFW 原来关闭,启用前还应备份 /etc/ufw,保持当前 SSH 会话,并从第二个终端测试新连接。启用后无法登录时,应通过控制台恢复规则;只有原先未启用 UFW、此次启用导致故障时,才考虑临时执行 ufw disable。
创建独立数据库与账号
本文让 PHP 和数据库通过本机 socket 通信,安装界面的数据库地址填写 localhost。
MYSQL_HISTFILE=/dev/null mariadb
进入数据库终端后执行,先把示例密码替换为随机生成的强密码:
CREATE DATABASE typecho
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
CREATE USER 'typecho'@'localhost'
IDENTIFIED BY 'ReplaceWithYourOwnStrongPassword';
GRANT ALL PRIVILEGES ON typecho.* TO 'typecho'@'localhost';
EXIT;
授权范围仅限 typecho 数据库,不应授予全局权限,也不要让程序使用数据库 root 账号。该账号可以修改或删除本库数据,因此凭据泄露仍会造成严重影响。
验证登录和数据库字符集:
mariadb --host=localhost --user=typecho -p typecho \
-e "SELECT DATABASE(); SHOW VARIABLES LIKE 'character_set_database';"
ss -lntp | grep ':3306'
第一条命令应显示数据库名 typecho、字符集 utf8mb4。第二条若显示数据库监听地址,应是回环地址,而不是 0.0.0.0 或公网地址;若通过 socket 提供服务而没有 TCP 监听,也可以正常使用。
发现公网监听时,先核查 MariaDB 的实际配置:
grep -R '^[[:space:]]*bind-address' /etc/mysql/
Ubuntu 软件包通常使用 /etc/mysql/mariadb.conf.d/50-server.cnf,但应以核验结果为准。修改前备份文件,将监听限制在本机,再重启 MariaDB 并复查。不要只依赖“安全组暂时没有放行”来代替数据库监听限制。
三、部署 Typecho 文件与安全的站点配置
下载并核验发行包
从 Typecho 官方发布渠道取得稳定发行包,确认其说明支持 PHP 8.3。主题和插件也要分别检查兼容性,不要只看主程序。
将压缩包上传到 /tmp/typecho.tar.gz。以下示例按 tar.gz 格式处理,若下载的是 ZIP,请使用相应解压工具。
tar -tzf /tmp/typecho.tar.gz | head -n 30
检查压缩包内容,不应出现异常的绝对路径或 ../ 路径。若发布方提供校验值,应执行 sha256sum 并与发布方的校验值比对;仅计算哈希、不进行比对,不能证明文件来源可信。
确认来源和归档内容后再解压:
mkdir -p /tmp/typecho-release
tar --no-same-owner -xzf /tmp/typecho.tar.gz \
-C /tmp/typecho-release
find /tmp/typecho-release -maxdepth 3 -name install.php -print
不同发行包的顶层目录可能不同。下面以实际程序位于 /tmp/typecho-release/build 为例,必须按检查结果调整 SRC:
SRC=/tmp/typecho-release/build
test -f "$SRC/index.php" &&
test -f "$SRC/install.php" &&
test -d "$SRC/admin" &&
test -d "$SRC/var" &&
echo "程序目录检查通过"
只有检查通过后才继续。使用完整发行包,不要把缺少依赖或构建结果的源码目录直接当作可安装程序。
设置安装期权限
以下命令仅适用于尚不存在的 /var/www/typecho。已有站点应先备份,不能直接覆盖。
test ! -e /var/www/typecho &&
mkdir -p /var/www/typecho
确认上一步成功,再复制:
cp -a "$SRC/." /var/www/typecho/
chown -R root:www-data /var/www/typecho
find /var/www/typecho -type d -exec chmod 750 {} \;
find /var/www/typecho -type f -exec chmod 640 {} \;
chmod 770 /var/www/typecho
mkdir -p /var/www/typecho/usr/uploads
chown www-www-data /var/www/typecho/usr/uploads
chmod 750 /var/www/typecho/usr/uploads
这里仅临时给 PHP-FPM 所属的 www-data 组写入站点根目录的权限,方便安装器生成 config.inc.php。普通程序文件保持不可写,图片上传目录单独允许写入。
不要用 chmod -R 777 解决权限问题,也不要让整个站点长期由 Web 进程随意改写。后续安装主题、插件时,可通过管理员部署文件,不必开放后台写程序目录。
先建立证书验证入口
创建 HTTP 配置,所有 blog.example.com 都要替换为实际域名:
mkdir -p /var/www/acme
nano /etc/nginx/sites-available/typecho
写入:
server {
listen 80;
listen [::]:80;
server_name blog.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
}
location / {
return 404;
}
}
启用站点:
ln -s /etc/nginx/sites-available/typecho \
/etc/nginx/sites-enabled/typecho
对于没有其他站点的全新服务器,可以移除默认站点链接。该操作只移除启用链接,不删除默认配置文件:
if [ -L /etc/nginx/sites-enabled/default ]; then
unlink /etc/nginx/sites-enabled/default
fi
nginx -t && systemctl reload nginx
如果 nginx -t 失败,不要继续申请证书,应先根据报错修复。此时博客尚未公开,普通路径返回 404 是预期结果。
申请 HTTPS 证书
确认域名已解析到服务器,且外部能够访问 80 端口后执行:
certbot certonly --webroot \
-w /var/www/acme \
-d "$DOMAIN"
按提示填写联系邮箱和确认协议。成功后核对证书:
certbot certificates
cp -a /etc/nginx/sites-available/typecho \
"$BACKUP/typecho-http.conf"
证书验证失败时,优先检查域名解析、错误的 AAAA 记录、安全组和挑战目录,不要通过关闭证书校验来掩盖问题。
配置 HTTPS 与 PHP-FPM
将站点配置替换为以下内容。除域名外,还要将 198.51.100.10 替换为管理员当前的公网出口 IP。这个访问限制用于保护首次安装过程;它不是服务器自身的 IP。
server {
listen 80;
listen [::]:80;
server_name blog.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
}
location / {
return 301 https://blog.example.com$request_uri;
}
}
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name blog.example.com;
ssl_certificate /etc/letsencrypt/live/blog.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/blog.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
root /var/www/typecho;
index index.php;
client_max_body_size 20m;
# 安装期间仅允许管理员出口 IP。
allow 198.51.100.10;
deny all;
access_log /var/log/nginx/typecho.access.log;
error_log /var/log/nginx/typecho.error.log;
location = /config.inc.php {
return 404;
}
location ^~ /var/ {
return 404;
}
location ~ /\. {
deny all;
}
location ~* \.(sql|bak|ini|log|tar|gz|zip)$ {
deny all;
}
# 此规则必须放在通用 PHP 规则之前。
location ~* ^/usr/uploads/.*\.(php[0-9]*|phtml|phar)(/|$) {
return 403;
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
该配置通过 try_files 将不存在的文章路径交给 Typecho,同时只执行真实存在的 PHP 文件。上传目录禁止执行常见 PHP 脚本扩展名,程序内部目录与数据库配置文件也不对外开放。

这里的备份文件扩展名限制适用于博客站点。如果业务确实要提供 ZIP 等文件下载,应另建受控下载目录和规则,不要直接删除所有保护规则。
验证并加载:
nginx -t && systemctl reload nginx
curl -I "http://$DOMAIN"
HTTP 应返回指向同域名 HTTPS 的 301。从允许的管理员出口访问 HTTPS,才会进入安装流程;其他来源返回 403 是安装期的预期行为。
四、完成安装、收紧权限并开放访问
在浏览器中安装
使用管理员浏览器访问:
https://blog.example.com/install.php
安装页面中填写:
- 数据库适配器:选择可用的 MySQL PDO 适配器。
- 数据库地址:
localhost。 - 数据库名:
typecho。 - 数据库用户名:
typecho。 - 数据库密码:前面创建账号时设置的密码。
- 表前缀:可保留默认值,但后续迁移必须保持一致。
- 网站地址:使用正式的 HTTPS 域名。
- 管理员账号:使用独立用户名和强密码,填写可用邮箱。
若安装器提示不能写入配置,先检查权限,不要立即放宽整个目录:
namei -l /var/www/typecho
runuser -u www-data -- test -w /var/www/typecho &&
echo "安装目录可写"
如果希望根目录始终不可写,也可以按照安装器提示手动创建配置文件,但不能把包含数据库密码的配置内容公开粘贴或上传到公开仓库。
安装成功后,应能够进入后台,并在前台看到初始化内容。这只代表安装完成,还不代表上线验收完成。
收回写权限与关闭安装入口
确认 config.inc.php 已生成:
test -s /var/www/typecho/config.inc.php &&
echo "配置文件已生成"
随后收紧权限:
chmod 750 /var/www/typecho
chown root:www-data /var/www/typecho/config.inc.php
chmod 640 /var/www/typecho/config.inc.php
在 HTTPS 的 server 块中加入:
location = /install.php {
return 404;
}
确认安装结束、管理员凭据已保存后,再删除安装期的两行限制:
allow 198.51.100.10;
deny all;
然后执行:
nginx -t && systemctl reload nginx
不要在安装完成之前解除来源限制,以免他人抢先初始化站点。也不要把安装时允许的 IP 误当作永久后台安全机制:若后续只想限制后台,需要对后台路径单独规划访问控制。

检查图片上传与固定链接
在后台新建一篇测试文章,插入图片并打开文章详情页。建议保留到验收结束再删除。
上传大小涉及 Nginx 和 PHP 两层限制。本文 Nginx 示例允许请求体不超过 20m,但 PHP 默认上传限制可能更小。可以创建独立配置:
nano /etc/php/8.3/fpm/conf.d/99-typecho.ini
写入:
upload_max_filesize = 16M
post_max_size = 20M
保存后验证并重新加载:
php-fpm8.3 -t && systemctl reload php8.3-fpm
POST 请求体还包含表单字段和封装开销,所以 post_max_size 应高于单文件限制。该配置作用于本机 PHP 8.3-FPM 的所有站点;共享服务器应改用独立 FPM 池配置,避免影响其他业务。
固定链接方面,先确认带入口文件的文章地址能正常访问,再在 Typecho 后台启用地址重写并测试。若首页正常、文章链接 404,应优先检查 try_files 和 Typecho 的固定链接设置,而不是重新安装程序。
五、按“外部访问到内部服务”排查异常
遇到失败时,先判断请求到达了哪一层,再修改配置。一次只改一个因素,避免同时调整 DNS、权限和 PHP 后失去判断依据。
| 现象 | 优先检查 | 结果含义与处理 |
|---|---|---|
| 域名无法连接 | DNS、安全组、80/443 监听 | 未到达 Nginx,先解决网络入口 |
| 证书申请失败 | A/AAAA 记录、80 端口、挑战路径 | 常见原因是解析错误或请求未到目标站点 |
| 所有页面返回 403 | 安装期 allow/deny、目录权限 | 管理员出口变化,或 Nginx 无法读取目录 |
| 页面返回 502 | PHP-FPM 状态、socket 路径 | Nginx 找不到或无法连接 PHP-FPM |
| 安装器提示数据库失败 | 驱动、localhost、账号密码 | 区分认证错误、连接失败与权限不足 |
| 首页正常,文章 404 | 固定链接、try_files | 请求没有正确交给 Typecho |
| 上传返回 413 | Nginx 请求体限制 | 请求在进入 PHP 之前已被拒绝 |
| 上传返回 PHP 错误 | PHP 上传限制、上传目录权限 | 已进入 PHP,需查应用与 FPM 日志 |
确认请求到达哪个站点
curl -I "https://$DOMAIN"
tail -n 50 /var/log/nginx/typecho.access.log
tail -n 50 /var/log/nginx/typecho.error.log
需要绕过本机 DNS 缓存核验目标 IP 时,可以从外部终端执行:
curl --resolve blog.example.com:443:203.0.113.20 \
-I https://blog.example.com/
将域名和 IP 换成真实值。不要加入 -k 作为验收条件,否则证书名称错误或信任链问题可能被隐藏。
若返回的是 Nginx 默认页面,应检查站点是否启用、server_name 是否一致,而不是先修改 Typecho 数据库。
检查 PHP 与数据库
systemctl status php8.3-fpm --no-pager
journalctl -u php8.3-fpm -n 50 --no-pager
ls -l /run/php/php8.3-fpm.sock
mariadb --host=localhost --user=typecho -p typecho \
-e "SELECT 1;"
数据库命令成功、安装器仍失败时,再检查 PHP 数据库扩展与安装参数。若只是某个主题或插件触发 500,应先在后台停用该扩展;无法进入后台时,先备份文件和数据库,再采用该扩展支持的恢复方法,不要随意删除数据库记录。
检查上传权限可以使用:
runuser -u www-data -- test -w /var/www/typecho/usr/uploads &&
echo "上传目录可写"
通过错误日志定位问题即可,不建议长期公开 phpinfo() 页面或开启面向访客的详细报错,它们可能泄露路径、模块和配置。
六、结果验收、备份与回滚检查项
上线验收
从服务器之外的网络完成以下检查:
- HTTP 正确跳转到同域名 HTTPS,浏览器没有证书告警。
- 首页、文章、分类、归档和后台登录均正常。
- 发布与编辑文章能够保存,中文内容没有乱码。
- 图片可以上传和访问,不出现上传目录权限错误。
/config.inc.php、/var/、/install.php无法公开访问。- 上传目录中的脚本请求被拒绝,普通图片访问不受影响。
- 公网安全组没有开放数据库端口。
- 安装期 IP 限制已经按上线计划解除,没有误挡访客。
- Nginx 与 PHP-FPM 日志没有持续出现 500、502 或权限错误。
再检查证书续期:
certbot renew --dry-run
systemctl list-timers --all | grep -i certbot
若系统通过定时器执行续期,确认它已启用;若采用其他调度方式,应核查对应任务。证书成功续期后,Nginx 还需要重新加载才能使用新证书。
可以添加部署钩子:
install -d -m 755 /etc/letsencrypt/renewal-hooks/deploy
cat > /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
#!/bin/sh
/usr/sbin/nginx -t && /bin/systemctl reload nginx
EOF
chmod 750 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
建立可恢复的基线备份
安装完成、测试内容确认无误后,在暂停发布、评论写入和图片上传的窗口制作备份。数据库事务快照不能自动保证数据库记录与上传文件处于同一个时间点;如果已有访问写入或后台任务,应先暂停这些写入再备份。
BASELINE=/root/typecho-baseline-$(date +%Y%m%d-%H%M%S)
mkdir -p "$BASELINE"
chmod 700 "$BASELINE"
set -o pipefail
mariadb-dump --single-transaction --quick typecho \
> "$BASELINE/typecho.sql"
tar -czf "$BASELINE/typecho-files.tar.gz" \
-C /var/www typecho
cp -a /etc/nginx/sites-available/typecho \
"$BASELINE/typecho-nginx.conf"
ls -lh "$BASELINE"
只有数据库导出和文件归档都成功,才将其视为有效备份。备份包含数据库密码、用户信息和文章内容,应限制访问,并复制到独立存储;放在同一块系统盘上不能防止整盘损坏。
恢复演练至少应验证:SQL 可以导入、文件归档可以展开、配置中的数据库名和网站地址能正确对应。不要把“有一个压缩文件”等同于“可以恢复”。
回滚路径与风险边界
Nginx 配置修改失败:恢复上一版站点文件,先测试再加载。证书配置阶段失败时,可以恢复前面保存的 HTTP 验证配置,但它只返回 404,不应让后台退回明文 HTTP:
cp -a "$BACKUP/typecho-http.conf" \
/etc/nginx/sites-available/typecho
nginx -t && systemctl reload nginx
程序升级失败:先限制公开访问或进入维护窗口,再备份当前故障状态。仅在确认升级没有改变数据库结构时,才单独恢复旧程序文件;如果迁移过数据库,应恢复同一时间点的文件与数据库,不能混用。
数据库需要恢复:优先导入到新库,例如 typecho_restore,验证后再切换配置,而不是直接覆盖正在使用的库。创建恢复库和导入操作需要管理员权限,且会占用额外磁盘空间:
MYSQL_HISTFILE=/dev/null mariadb
CREATE DATABASE typecho_restore
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON typecho_restore.*
TO 'typecho'@'localhost';
EXIT;
随后导入经过核验的备份:
mariadb typecho_restore < "$BASELINE/typecho.sql"
导入成功后,备份现有 config.inc.php,在维护窗口将其中数据库名改为 typecho_restore,验证文章、后台和图片。切换失败时恢复原配置即可重新连接原库;不要在验证完成前删除原库。

最终保留以下回滚检查项:
- 部署前快照可用,配置备份路径有记录。
- 最近一次完整备份同时包含数据库、程序、配置与上传文件。
- 已记录证书路径、PHP-FPM socket 和站点权限。
- 恢复操作经过验证,而不只是确认备份文件存在。
- 回滚后重新检查 HTTPS、后台、固定链接和上传功能。
- 故障排查期间临时放开的权限、调试页面和防火墙规则已经收回。
达到这些条件后,Typecho 才算完成了从“安装成功”到“可以上线并可恢复”的部署。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3178.html



