在韩国服务器部署Typecho博客,需要准备哪些环境并如何验证安装

发布人:A5数据发布时间:2026-10-25 15:48阅读量:121

在韩国地域的云服务器上首次运行 Typecho,核心准备不是特殊的韩国版软件,而是一个匹配的 Linux、Web 服务器、PHP-FPM、数据库和可访问域名。较容易实施的基线是 Ubuntu 22.04 LTS、Nginx、PHP 8.1、MariaDB 10.6,以及一个解析到服务器公网地址的域名。

实际部署时需要同时验证本机服务和公网访问:本机验证用于确认 Nginx、PHP、数据库是否正常,公网验证用于确认韩国服务器的安全组、系统防火墙、DNS 和 IPv6 配置没有阻断访问。下面以单站点、数据库与 Typecho 部署在同一台服务器为例,命令默认使用 Ubuntu 22.04。

针对韩国地区的博客与企业网站部署,A5数据提供首尔物理服务器资源,覆盖不同处理器、内存、存储和网络配置,可承载 Typecho 程序、MariaDB 数据库、图片上传及后台管理等单站点运行需求。结合本地访问场景与业务规模,A5数据也提供多种韩国服务器方案,为网站文件存储、数据库运行和持续内容发布提供独立的硬件基础。

一、准备条件与环境基线

1. 服务器和登录条件

开始前确认具备以下条件:

项目建议或检查要求
操作系统Ubuntu 22.04 LTS,本文命令按此版本编写
权限可使用 sudo 的管理员账号,优先使用 SSH 密钥登录
公网地址至少有一个 IPv4 公网地址
域名例如 blog.example.com,A 记录指向服务器 IPv4
内存与磁盘小型博客可从 1 vCPU、1 GB 内存起步,图片和附件空间需单独评估
端口SSH 端口、TCP 80、TCP 443;不对公网开放数据库端口
软件Nginx、PHP-FPM、MariaDB、Typecho

小型博客可以先使用较低配置启动,但访问量、图片数量、插件数量增加后,PHP 内存和磁盘空间会成为新的约束。这里的配置是首次部署基线,不代表所有访问规模都适用。

韩国服务器与其他地域服务器在 Typecho 的安装方式上没有本质区别。需要额外关注的是服务器时区、DNS 解析方向、云平台安全组,以及错误的 AAAA 记录是否让部分访问者优先连接到不可用的 IPv6 地址。

2. 先检查系统版本、磁盘和时间

登录服务器后执行:

cat /etc/os-release
uname -a
df -h /
free -h
timedatectl

在 Ubuntu 22.04 上,/etc/os-release 中应能看到类似以下内容:

PRETTY_NAME="Ubuntu 22.04.5 LTS"

设置韩国本地时间:

sudo timedatectl set-timezone Asia/Seoul
timedatectl

预期结果中应包含:

Time zone: Asia/Seoul (KST, +0900)

时区不会决定 Typecho 能否安装,但会影响 Nginx、PHP 和数据库日志中的时间,也会影响定时任务和后台显示时间。若网站面向其他时区用户,可以在 Typecho 后台另行设置显示习惯,但服务器日志建议统一保留明确的时区。

3. 检查 DNS 和云平台防火墙

在本地电脑或服务器上检查域名:

dig +short A blog.example.com
dig +short AAAA blog.example.com

A 记录应返回韩国服务器的 IPv4 地址。如果存在 AAAA 记录,必须确认它指向服务器实际可用的 IPv6 地址;如果服务器没有配置 IPv6,建议删除错误的 AAAA 记录,而不是让访问者连接到一个不存在的地址。

在云服务商控制台中放行:

  • SSH 使用的实际端口;
  • TCP 80;
  • TCP 443。

不要为了让 Typecho 连接本机 MariaDB 而开放 TCP 3306。数据库使用 localhost 本地连接时,不需要从公网访问 3306。

一、准备条件与环境基线|检查 DNS 和云平台防火墙配图

二、安装基础软件

1. 安装 Nginx、MariaDB 和 PHP 扩展

本文按 Ubuntu 22.04 的 PHP 8.1 软件包命名。先安装基础组件:

sudo apt update

sudo apt install -y \
  nginx \
  mariadb-server \
  mariadb-client \
  php8.1-cli \
  php8.1-fpm \
  php8.1-mysql \
  php8.1-curl \
  php8.1-gd \
  php8.1-mbstring \
  php8.1-xml \
  php8.1-zip \
  php8.1-intl \
  php8.1-opcache \
  curl \
  ca-certificates \
  tar

如果系统提示 php8.1-* 软件包不存在,不要直接混用其他版本的 PHP-FPM。先查看系统可用版本:

apt-cache policy php-fpm php-cli php-mysql

若实际安装的是 PHP 8.2 或 PHP 8.3,需要把后续命令中的版本号和 FPM Socket 一并替换,例如:

/run/php/php8.2-fpm.sock
/run/php/php8.3-fpm.sock

Typecho 本体、主题和插件对 PHP 版本的兼容性可能不同。首次部署应固定一个已经验证过的 PHP 版本,不要在安装过程中同时切换 PHP 大版本。

2. 配置 PHP-FPM 的基本参数

为 Typecho 创建单独的 PHP-FPM 配置文件:

sudo tee /etc/php/8.1/fpm/conf.d/99-typecho.ini >/dev/null <<'EOF'
date.timezone = Asia/Seoul
memory_limit = 128M
upload_max_filesize = 32M
post_max_size = 40M
max_execution_time = 60
cgi.fix_pathinfo = 0
EOF

post_max_size 要大于 upload_max_filesize,否则上传较大图片时,即使文件大小没有超过上传限制,也可能因为整个 POST 请求超限而失败。这里的 32 MB 和 40 MB 是示例值,实际应结合服务器内存和博客附件需求调整。

检查 PHP-FPM 配置:

sudo php-fpm8.1 -t

预期结果类似:

NOTICE: configuration file /etc/php/8.1/fpm/php-fpm.conf test is successful

检查需要的 PHP 扩展:

php -m | grep -E 'curl|gd|intl|mbstring|mysqli|PDO|pdo_mysql|xml|zip'

至少应能看到 mbstring、PDO、pdo_mysql、xml、curl 和 zip。其中 pdo_mysql 来自 php8.1-mysql,不是单独的 php8.1-pdo-mysql 软件包。

3. 启动并验证服务

sudo systemctl enable --now nginx mariadb php8.1-fpm
sudo systemctl status nginx mariadb php8.1-fpm --no-pager

三个服务都应显示 active (running)。继续检查 PHP-FPM Socket 和端口:

ls -l /run/php/php8.1-fpm.sock
sudo ss -lntp | grep -E ':80|:3306'

正常情况下,Nginx 监听 TCP 80,MariaDB 只监听本机或本地 Socket。若看到 MariaDB 对 0.0.0.0:3306 监听,应检查 MariaDB 的监听地址配置,并确认云防火墙和系统防火墙均未开放该端口。

三、创建 Typecho 数据库

1. 创建独立数据库和账号

登录 MariaDB:

sudo mariadb

在 MariaDB 提示符中执行以下 SQL。请替换为随机长密码 不应原样输入,建议使用至少 20 位、包含多种字符的独立密码。

CREATE DATABASE typecho
  DEFAULT 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 数据库权限,不应直接使用 MariaDB 的 root 账号连接 Typecho。数据库账号密码不要写入公开仓库、工单或截图中。

2. 验证数据库账号

使用与 Typecho 相同的本地连接方式测试:

mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1;"

输入数据库密码后,预期结果如下:

1
1

再检查数据库是否已经创建:

sudo mariadb -e "SHOW DATABASES LIKE 'typecho';"

如果 SELECT 1 失败,优先检查用户名、密码、主机名和账号授权。Typecho 安装页面中的数据库主机建议填写 localhost,不要在没有必要时改成公网 IP。

四、下载并部署 Typecho 文件

1. 下载固定版本

以下以 Typecho 1.2.1 的发布包 URL 作为示例。正式部署时应固定使用已经测试过的版本,不要每次安装都使用不明确的最新文件。

TYPECHO_URL='https://github.com/typecho/typecho/releases/download/v1.2.1/typecho-1.2.1-release.tar.gz'
WORKDIR="$(mktemp -d)"

curl -fL --retry 3 "$TYPECHO_URL" -o "$WORKDIR/typecho.tar.gz"
tar -tzf "$WORKDIR/typecho.tar.gz" | sed -n '1,10p'

curl 返回 HTTP 错误时,命令会以失败状态退出。不要把一个 HTML 错误页面当成压缩包继续解压。tar -tzf 能列出文件名,说明下载文件具备基本的压缩包格式。

查看文件列表后,根据第一层目录决定解压方式。若列表类似:

typecho-1.2.1/index.php
typecho-1.2.1/install.php
typecho-1.2.1/var/

使用:

sudo install -d -m 755 /var/www/typecho
sudo tar -xzf "$WORKDIR/typecho.tar.gz" \
  -C /var/www/typecho \
  --strip-components=1

如果列表直接以 index.php、install.php 等文件开头,则不要去掉目录层级:

sudo install -d -m 755 /var/www/typecho
sudo tar -xzf "$WORKDIR/typecho.tar.gz" \
  -C /var/www/typecho

验证关键文件:

sudo test -f /var/www/typecho/index.php
sudo test -f /var/www/typecho/install.php
sudo ls -la /var/www/typecho | sed -n '1,15p'

两个 test 命令没有输出且返回状态为 0,说明文件位置正确。如果文件被解压到了 /var/www/typecho/typecho-1.2.1/ 这样的嵌套目录,先调整目录结构,再继续配置 Nginx。

2. 设置初始安装权限

安装页面需要创建 config.inc.php,同时上传目录需要由 PHP-FPM 写入。首次安装阶段可以暂时让 Web 进程拥有站点目录权限:

sudo mkdir -p /var/www/typecho/usr/uploads

sudo find /var/www/typecho -type d -exec chmod 755 {} +
sudo find /var/www/typecho -type f -exec chmod 644 {} +

sudo chown -R www-www-data /var/www/typecho
sudo chmod 755 /var/www/typecho/usr/uploads

验证写入权限:

sudo -u www-data test -w /var/www/typecho
sudo -u www-data test -w /var/www/typecho/usr/uploads

这里不要提前创建空的 config.inc.php。部分程序会根据该文件是否存在判断安装状态,空文件可能导致安装页面不能正常初始化。

五、配置 Nginx 和访问入口

1. 创建站点配置

把 blog.example.com 换成实际域名。如果暂时没有域名,可以将 server_name 改为服务器 IP 或 _,但后续配置 HTTPS 时仍需要域名。

sudo tee /etc/nginx/sites-available/typecho >/dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;

    server_name blog.example.com;
    root /var/www/typecho;
    index index.php index.html;

    client_max_body_size 32m;

    access_log /var/log/nginx/typecho.access.log;
    error_log  /var/log/nginx/typecho.error.log;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /config.inc.php {
        deny all;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}
NGINX

try_files 是 Typecho 伪静态访问的关键配置。首页可能在缺少该配置时仍能打开,但文章链接、分类页或后台路径可能出现 404。

启用站点:

sudo ln -sfn /etc/nginx/sites-available/typecho \
  /etc/nginx/sites-enabled/typecho

sudo nginx -t
sudo systemctl reload nginx

nginx -t 预期包含:

syntax is ok
test is successful

只有配置检查成功后才执行 reload。如果检查失败,先查看报错中的行号,不要直接覆盖其他站点配置。

2. 验证本机 HTTP 响应

域名已经解析时,可以直接执行:

curl -sS -D - -o /dev/null http://blog.example.com/

如果 DNS 尚未生效,但 Nginx 已经配置完成,可以在服务器本机使用 Host 头:

curl -sS -D - -o /dev/null \
  -H 'Host: blog.example.com' \
  http://127.0.0.1/

初始阶段出现 200、301 或 302 都可能是正常结果。需要重点排除:

  • 502 Bad Gateway:Nginx 无法连接 PHP-FPM;
  • 404 Not Found:站点根目录、域名匹配或 try_files 配置有误;
  • 403 Forbidden:文件权限或 Nginx 访问规则有误;
  • 连接超时:通常与云安全组、UFW、监听地址或 DNS 有关。

访问安装入口:

http://blog.example.com/install.php

浏览器应显示 Typecho 的安装页面,而不是下载 PHP 文件、显示 Nginx 默认页面或直接返回 502。

六、完成安装并逐项验证

1. 填写安装页面

在安装页面填写:

  • 数据库适配器:选择页面提供的 MySQL/PDO MySQL 选项;
  • 数据库地址:localhost;
  • 数据库端口:3306;
  • 数据库名:typecho;
  • 数据库用户名:typecho_app;
  • 数据库密码:前面创建的数据库密码;
  • 表前缀:使用默认值或改成明确的前缀;
  • 站点地址:与当前域名保持一致;
  • 管理员账号和密码:使用独立、较长的密码。

如果页面要求先检测环境,所有必需项应通过后再提交。安装完成后,Typecho 会生成 config.inc.php,并在数据库中创建文章、用户、设置等表。

2. 检查配置文件和数据库表

安装完成后,先确认配置文件存在且不为空:

sudo test -s /var/www/typecho/config.inc.php
sudo stat -c '%U:%G %a %n' /var/www/typecho/config.inc.php

检查数据库表:

sudo mariadb typecho -e "SHOW TABLES;"

正常情况下会看到以表前缀开头的多张表。若数据库为空,说明安装页面可能没有真正完成,或者填写的数据库名与命令检查的数据库不是同一个。

3. 安装完成后收紧文件权限

安装阶段结束后,不应继续让 PHP-FPM 修改整个站点代码目录。执行:

sudo find /var/www/typecho -type d -exec chmod 755 {} +
sudo find /var/www/typecho -type f -exec chmod 644 {} +

sudo chown -R root:root /var/www/typecho
sudo chown -R www-www-data /var/www/typecho/usr/uploads

sudo chown root:www-data /var/www/typecho/config.inc.php
sudo chmod 640 /var/www/typecho/config.inc.php
sudo chmod 755 /var/www/typecho/usr/uploads

验证 PHP-FPM 仍能读取配置文件,并且只能写入上传目录:

六、完成安装并逐项验证|安装完成后收紧文件权限配图

sudo -u www-data test -r /var/www/typecho/config.inc.php
sudo -u www-data test -w /var/www/typecho/usr/uploads
sudo -u www-data test ! -w /var/www/typecho/index.php

三个命令都没有输出时,说明权限关系符合预期。后续安装主题或插件时,不要直接把整个站点改成 777;如果某个插件要求额外写权限,应先确认它的实际目录和用途。

4. 检查首页、后台和文章链接

执行以下检查:

curl -sS -o /dev/null -w '%{http_code}\n' http://blog.example.com/
curl -sS -o /dev/null -w '%{http_code}\n' http://blog.example.com/admin/

浏览器中依次确认:

  1. 首页能够打开;
  2. 可以使用管理员账号登录后台;
  3. 创建一篇测试文章并发布;
  4. 从首页点击文章链接;
  5. 刷新文章页面后仍能正常返回;
  6. 上传一张小图片,确认图片能够显示;
  7. 退出后台后,普通访问者仍能打开文章。

如果首页正常但文章链接返回 404,优先检查 Nginx 的 try_files 和站点是否加载了正确配置:

sudo nginx -T | grep -A 25 -B 5 'server_name blog.example.com'

七、常见失败处理

1. 域名无法访问,但本机正常

先在服务器执行:

curl -I -H 'Host: blog.example.com' http://127.0.0.1/
sudo ss -lntp | grep ':80'
sudo ufw status verbose

如果本机返回正常,而公网超时,按以下顺序检查:

  • 云平台安全组是否放行 TCP 80;
  • UFW 是否放行了实际端口;
  • A 记录是否指向当前服务器;
  • 是否存在错误 AAAA 记录;
  • Nginx 是否监听了 IPv4 和 IPv6。

如果尚未确认 SSH 规则,不要在远程会话中直接启用 UFW。应先放行实际 SSH 端口,并用第二个 SSH 会话测试登录:

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw status numbered

若 SSH 使用的不是 22 端口,应将命令中的 22 替换为实际端口。确认第二个会话可以登录后,再执行:

sudo ufw enable

如果误封 SSH,需通过云平台控制台执行 sudo ufw disable,这也是启用防火墙前应保留的回滚方式。

2. 出现 502 Bad Gateway

检查 PHP-FPM:

sudo systemctl status php8.1-fpm --no-pager
sudo ls -l /run/php/
sudo tail -n 50 /var/log/nginx/typecho.error.log

如果 /run/php/ 中实际存在的是 php8.2-fpm.sock,而 Nginx 仍然写着 php8.1-fpm.sock,修改 fastcgi_pass 后重新检查并加载:

sudo nginx -t
sudo systemctl reload nginx

如果 PHP-FPM 服务本身没有运行,查看日志:

sudo journalctl -u php8.1-fpm -n 80 --no-pager

3. 安装页面提示数据库连接失败

不要只反复修改浏览器表单,先在服务器上使用相同账号测试:

mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1;"

根据结果判断:

  • Access denied:用户名、密码或授权主机不匹配;
  • Unknown database:数据库名填写错误;
  • Can't connect:MariaDB 未启动,或连接方式与服务配置不一致;
  • 命令成功但网页失败:检查 PHP 的 pdo_mysql 扩展和 PHP-FPM 日志。

4. 上传图片失败

分别检查 PHP 限制和目录权限:

grep -E 'memory_limit|upload_max_filesize|post_max_size' \
  /etc/php/8.1/fpm/conf.d/99-typecho.ini

sudo -u www-data test -w /var/www/typecho/usr/uploads
sudo systemctl restart php8.1-fpm

post_max_size 小于上传文件限制、PHP-FPM 未重启、上传目录不可写,都可能造成上传失败。若上传目录权限正确但仍失败,查看:

sudo tail -n 80 /var/log/nginx/typecho.error.log
sudo journalctl -u php8.1-fpm -n 80 --no-pager

八、验收与回滚检查项

1. 首次部署验收清单

部署结束后,至少确认以下项目:

  • [ ] nginx -t 检查成功;
  • [ ] Nginx、MariaDB、PHP-FPM 均为运行状态;
  • [ ] PHP 已加载 pdo_mysql、mbstring、xml 等必要扩展;
  • [ ] mariadb -u typecho_app -p -h localhost typecho -e "SELECT 1;" 成功;
  • [ ] 域名 A 记录指向正确的韩国服务器 IPv4;
  • [ ] 无错误 AAAA 记录;
  • [ ] 云安全组放行 80/443,未对公网开放 3306;
  • [ ] /install.php 能显示安装页面;
  • [ ] config.inc.php 已生成且不可被 HTTP 直接下载;
  • [ ] 首页、后台、文章链接均能访问;
  • [ ] usr/uploads 可写,站点代码不可由 www-data 写入;
  • [ ] 已保存数据库账号、站点管理员账号和备份位置。

2. 需要回滚时先备份

如果安装已经完成,回滚前先备份文件和数据库。以下命令会保存站点配置、上传文件和数据库内容:

BACKUP_DIR="/var/backups/typecho-$(date +%F-%H%M%S)"

sudo install -d -m 700 "$BACKUP_DIR"

sudo tar -czf "$BACKUP_DIR/typecho-files.tar.gz" \
  -C /var/www typecho

sudo mariadb-dump \
  --single-transaction \
  --routines \
  --events \
  typecho | gzip > "$BACKUP_DIR/typecho-database.sql.gz"

sudo ls -lh "$BACKUP_DIR"

3. 文件和 Nginx 配置回滚

如果新部署的站点导致访问异常,可以先将站点目录改名保留,不要直接删除:

sudo mv /var/www/typecho \
  "/var/www/typecho.failed-$(date +%F-%H%M%S)"

如果要暂时撤下 Nginx 站点配置,在确认符号链接路径无误后执行:

sudo mv /etc/nginx/sites-enabled/typecho \
  "/etc/nginx/sites-enabled/typecho.disabled"

sudo nginx -t
sudo systemctl reload nginx

这样可以保留失败现场,便于查看日志和恢复文件。若服务器上还有其他站点,不要删除或覆盖它们的配置。

4. 数据库回滚边界

首次安装失败时,数据库可以暂时保留,便于确认 Typecho 是否已经创建过表。只有在确认 typecho 是本次部署专用数据库、并且已经完成数据库备份后,才考虑删除:

sudo mariadb
DROP DATABASE typecho;
DROP USER 'typecho_app'@'localhost';
EXIT;

DROP DATABASE 会永久删除该数据库中的文章、用户和配置表,不能依靠普通命令撤销。若已经录入内容,应先从 typecho-database.sql.gz 恢复,再重新配置站点文件和数据库连接。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5759.html

相关推荐