Typecho 是一款极简主义的开源 PHP 博客程序,代码轻量、加载速度快,内核只有约 400KB,在低配 VPS 上也能流畅运行。相比 WordPress,Typecho 更适合追求速度、内容为主的个人博客。本文以 Debian/Ubuntu + Nginx + MySQL 环境为例,从零开始搭建 Typecho 博客。

本文要点

  • LNMP 环境准备(复用已有环境)
  • MySQL 建库与配置
  • 下载 Typecho 并配置 Nginx 虚拟主机
  • 完成 Typecho 安装向导
  • 配置 Nginx 伪静态规则,修复 404
  • 主题安装与推荐

环境要求

组件最低版本推荐版本
PHP7.28.1 / 8.2
MySQL5.68.0 或 MariaDB 10.6
Nginx1.141.24
内存128MB512MB+

Typecho 对环境要求极低,128MB 内存的 VPS 即可运行,是资源受限环境的理想选择。

安装 LNMP 环境

若尚未安装 LNMP 环境,请先参考本站《手动 LNMP 部署》教程完成安装。确认环境就绪:

nginx -v         # 查看 Nginx 版本
php -v           # 查看 PHP 版本
mysql --version  # 查看 MySQL 版本

创建数据库

mysql -u root -p

CREATE DATABASE typecho DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'tcuser'@'localhost' IDENTIFIED BY '此处填强密码';
GRANT ALL PRIVILEGES ON typecho.* TO 'tcuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

下载并部署 Typecho

  1. 从 GitHub 下载最新稳定版并部署:
mkdir -p /var/www/typecho
wget https://github.com/typecho/typecho/releases/latest/download/typecho.zip -O /tmp/typecho.zip
unzip /tmp/typecho.zip -d /tmp/typecho_tmp
mv /tmp/typecho_tmp/* /var/www/typecho/
chown -R www-data:www-data /var/www/typecho
find /var/www/typecho -type d -exec chmod 755 {} \;
find /var/www/typecho -type f -exec chmod 644 {} \;

关于源码下载

如果服务器下载 GitHub 文件速度较慢,可先在本地下载后通过 scp 上传到服务器:scp typecho.zip root@服务器IP:/tmp/

配置 Nginx 虚拟主机

nano /etc/nginx/sites-available/typecho

填入以下配置:

server {
    listen 80;
    server_name your-domain.com www.your-domain.com;
    root /var/www/typecho;
    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }

    location ~ /\. {
        deny all;
    }
}
ln -s /etc/nginx/sites-available/typecho /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

运行安装向导

在浏览器访问 http://你的IP或域名/install.php,Typecho 安装向导会自动启动:

  1. 选择语言(简体中文)
  2. 填写数据库信息(主机 localhost,数据库名 typecho,用户名 tcuser,密码)
  3. 设置博客名称、管理员账号与密码
  4. 点击"开始安装"
  5. 安装完成后登录 /admin 后台

安装完成验证

安装成功后请手动删除 install.php 文件:rm /var/www/typecho/install.php,避免他人重新运行安装向导。

配置 Nginx 伪静态(固定链接)

Typecho 的独立页面和文章默认依赖 URL 重写,Nginx 的 try_files 已在上面的配置中设置好。进入 Typecho 后台 → 设置永久链接,选择自定义模式(如 /archives/{cid}/ 或日期模式),保存后验证文章 URL 是否正常。

SSL 配置

apt install -y certbot python3-certbot-nginx
certbot --nginx -d your-domain.com -d www.your-domain.com

按提示操作即可自动申请证书并修改 Nginx 配置。

主题推荐与安装

Typecho 主题安装方式:下载主题压缩包,解压到 /var/www/typecho/usr/themes/ 目录,然后进入后台 → 控制台外观 激活新主题。

主题名风格特点适合场景
Joe现代卡片式,支持暗黑模式技术/个人博客
Moricolor极简文字风格写作向博客
Handsome功能丰富,仿微信卡片综合型博客

小结

  • Typecho 适合低配 VPS,128MB 内存即可流畅运行
  • Nginx 的 try_files 指令是伪静态的核心,配置正确即可支持自定义 URL
  • 安装完成后删除 install.php 是重要的安全操作
  • 主题通过拷贝目录方式安装,操作简便

常见问题

Typecho 和 WordPress 如何选择?

Typecho 更轻量,适合内容为主的个人博客,VPS 资源消耗极小;WordPress 插件生态更丰富,适合功能复杂的网站。个人博客追求速度选 Typecho,需要大量插件和电商功能选 WordPress。

Typecho 支持 SQLite 数据库吗?

支持。Typecho 提供 SQLite 和 MySQL/MariaDB 两种数据库驱动。资源极度受限时可使用 SQLite,无需安装 MySQL 服务。

Typecho 后台路径是什么?

默认后台访问地址为 /admin/,登录后即可进入控制台管理文章、主题和插件。