从零搭建Typecho博客:新手也能轻松上手的完整教程

如果你正在寻找一个轻量、快速、不折腾的博客系统,那么 Typecho 绝对值得一试。相比 WordPress 的臃肿和复杂,Typecho 更像是一位「极简主义者」—— 安装包不到 500KB,原生支持 SQLite 数据库,无需单独安装 MySQL,对新手极其友好。我自己第一个博客就是用 Typecho 搭建的,从购买服务器到文章发布,前后只花了不到半小时。今天,我就把整套流程拆解开来,手把手带你走一遍。

第一步:环境准备 —— 选一台服务器,装好 Nginx 和 PHP

Typecho 运行需要 PHP(建议 7.4 以上)和一个 Web 服务器(推荐 Nginx)。数据库方面,我们直接选 SQLite,因为它不需要额外配置,文件即数据库,特别适合个人博客。

如果你还没有服务器,可以考虑 雨云服务器(优惠码:aabh),性价比高,新用户首月很便宜,用来练手或长期运行都合适。购买后选择 Ubuntu 22.04 系统,然后通过 SSH 登录,执行以下命令安装必要的软件包:

# 更新系统
apt update && apt upgrade -y
# 安装 Nginx
apt install nginx -y
# 安装 PHP 及其常用扩展(包括 SQLite 支持)
apt install php-fpm php-sqlite3 php-mbstring php-curl php-gd php-xml -y

安装完成后,启动 Nginx 和 PHP-FPM 服务:

systemctl start nginx

systemctl start php8.1-fpm # 版本号根据实际安装的 PHP 版本调整
systemctl enable nginx php8.1-fpm

到这里,运行环境就准备就绪了。

第二步:下载并安装 Typecho

去 Typecho 官网(typecho.org)下载最新的稳定版压缩包,或者直接用命令行在服务器上拉取:

cd /var/www/html
wget https://github.com/typecho/typecho/releases/latest/download/typecho.zip
unzip typecho.zip
chown -R www-data:www-data /var/www/html/*

接着配置 Nginx 站点。在 /etc/nginx/sites-available 下创建一个配置文件,比如 typecho,写入以下内容(记得将 server_name 改为你的域名或 IP):

server {
listen 80;
server_name yourdomain.com; # 改成你的域名或服务器 IP
root /var/www/html;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ .php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
}
}

然后启用站点并重载 Nginx:

ln -s /etc/nginx/sites-available/typecho /etc/nginx/sites-enabled/
nginx -t # 测试配置是否正确
systemctl reload nginx

现在打开浏览器访问你的服务器 IP 或域名,就会看到 Typecho 的安装欢迎页面。按照提示选择「SQLite」作为数据库类型,填写站点名称和管理员账号,点击「确认」即可完成安装。整个过程不到 2 分钟。

第三步:选择一套顺眼的主题

Typecho 默认主题比较朴素,但好处是更换主题非常简单。推荐几个我常用的免费主题:

  • Handsome(付费但口碑极好,适合追求颜值的人)
  • Mirages(响应式设计,支持暗色模式,免费)
  • Initial(极简风格,适合文字博客)
  • CorePress(功能丰富,有类似 WordPress 的编辑器增强)

下载主题后,将主题文件夹上传到 /var/www/html/usr/themes/ 目录下,然后进入 Typecho 后台(/admin),在「控制台 -> 外观」中启用即可。如果你用的是雨云服务器,上传文件可以直接用 SFTP 工具,非常方便。

第四步:基础配置,让博客更好用

安装完成后,建议做以下几项配置:

  1. 固定链接设置:在后台「设置 -> 永久链接」中,选择「启用地址重写功能」,并将自定义格式设为 /archives/{cid}//post/{slug}.html,这样文章 URL 会更友好。如果开启后出现 404,说明 Nginx 伪静态规则没生效,检查之前的配置文件是否包含 try_files 那行。
  2. 评论反垃圾:Typecho 原生没有验证码,推荐安装 Captcha 插件,或者开启评论审核。
  3. 插件扩展:比如 Stat(访问统计)、EditorMD(Markdown 编辑器增强)、Links(友情链接),都可以在后台「插件」中直接安装。
  4. 备份:由于使用 SQLite,数据库就是一个 .db 文件,位于 /var/www/html/usr/ 下,定期下载备份即可。

第五步:常见问题与解决

问题 1:安装时提示「数据库连接失败」或无法创建 SQLite 文件。

解决:检查 /var/www/html/usr/ 目录是否可写,执行 chmod -R 755 /var/www/html/usr 并确保所有者是 www-data

问题 2:开启伪静态后文章页面 404。

解决:Nginx 配置中缺少 try_files 规则,请参考第二步中的配置。如果已经添加仍不行,重启 Nginx 并清空浏览器缓存。

问题 3:后台无法上传图片或附件。

解决:检查 /var/www/html/usr/uploads/ 目录权限,同样需要 755 且属于 www-data。如果使用雨云服务器,还可以考虑将附件托管到对象存储,减轻服务器压力。

写在最后:为什么我仍然推荐 Typecho

在 WordPress 占据大半江山的今天,Typecho 依然有一群忠实用户。它的核心优势就是 简单 —— 没有复杂的数据库配置,没有繁重的后台加载,甚至你可以在 256MB 内存的 VPS 上流畅运行。如果你只是想安安静静写点东西,不想被系统维护分心,Typecho 就是那个「刚刚好」的选择。

搭建过程中,你可能遇到一些小坑,但跟着这篇教程走,基本都能顺利解决。最后再安利一次 雨云服务器(优惠码:aabh),性价比高,用来跑 Typecho 绰绰有余。动手试试吧,从零拥有一个属于自己的博客,那种成就感是社交媒体无法替代的。

评论区: