手把手记录 Typecho 博客从安装到能正常访问的全过程,踩过的坑都标出来了。
为什么选 Typecho
Typecho 是个轻量级的博客系统,用 PHP 写的,数据库支持 MySQL 和 SQLite。我选它主要是因为三个原因:
- 轻 — 装完就几十MB,不会像 WordPress 那样吃资源
- 快 — 页面加载速度比 WordPress 快不少
- 简单 — 没有那些花里胡哨的功能,就是写博客
环境准备
服务器是 Linux 发行版,用宝塔面板管理的。先确认几个东西:
# PHP 版本检查
php -v
# 推荐 7.4+,Typecho 1.2.0 需要 PHP 7.4+安装过程
1. 下载 Typecho
cd /tmp
wget https://github.com/typecho/typecho/releases/download/v1.2.0/typecho.zip
unzip typecho.zip2. 部署到网站目录
# 创建网站目录(替换为你的实际域名)
mkdir -p /www/wwwroot/your-domain.com
cp -r /tmp/typecho/* /www/wwwroot/your-domain.com/
chown -R www:www /www/wwwroot/your-domain.com
chmod -R 755 /www/wwwroot/your-domain.com3. 关键坑点:autoload 死锁
这个坑我踩了,标出来重点说。
Typecho 1.2.0 有个 autoload 死锁问题。如果手动创建 config 并定义了常量,index.php 会跳过 include,导致 autoloader 未注册,最终报错 Class "Typecho_Db" not found。
唯一正确做法:用安装向导自动生成 config,不要尝试手动创建 config。
Nginx 配置
宝塔的伪静态规则文件有时候是空的,导致访问文章页面直接 404。
在伪静态配置里补上 rewrite 规则:
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php$1 last;
break;
}然后重载 Nginx:nginx -s reload,问题搞定。
安装 handsome 主题
handsome 是 Typecho 生态里最火的主题。上传主题文件到 themes 目录,后台启用即可。需要安装 TePostViews 和 Links 两个插件。
总结
Typecho 部署主要坑在 autoload 死锁和伪静态配置。简单说就是:别手动写 config,用安装向导;伪静态规则得自己补。