在韩国服务器部署Typecho博客,需要准备哪些环境并如何验证安装
在韩国地域的云服务器上首次运行 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。

二、安装基础软件
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/
浏览器中依次确认:
- 首页能够打开;
- 可以使用管理员账号登录后台;
- 创建一篇测试文章并发布;
- 从首页点击文章链接;
- 刷新文章页面后仍能正常返回;
- 上传一张小图片,确认图片能够显示;
- 退出后台后,普通访问者仍能打开文章。
如果首页正常但文章链接返回 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



