Typecho 搭建教程 – 搭建你的轻量级个人博客

一、Typecho 是什么

Typecho 是一个轻量级的开源博客程序，基于 PHP 开发。它的定位是 WordPress 的轻量化替代品——保留博客的核心功能，去掉繁杂的插件和臃肿的代码。

Typecho 的核心特点：

• 极致轻量：安装包只有几百 KB，解压后不到 2MB。对服务器资源占用极低，1 核 512M 的小服务器也能流畅运行。
• 原生 Markdown 支持：内置 Markdown 编辑器，写作体验接近 Typora。
• 简洁高效：代码结构清晰，加载速度快，SEO 友好。
• 插件和主题：社区活跃，有大量免费主题和插件可供选择。
• SQLite/MySQL 双数据库支持：小站点可以直接用 SQLite，不需要单独安装 MySQL。
• 完全开源免费：GitHub 仓库：https://github.com/typecho/typecho

二、你需要准备什么

准备项	说明
一台云服务器或虚拟主机	PHP 虚拟主机即可，推荐 1 核 1G 以上云服务器
宝塔面板（推荐）	可视化操作，不需要手动配置 PHP 和 Nginx
一个域名（可选）	没有域名可以用服务器 IP 访问

三、部署方式一：宝塔面板部署（最推荐，适合新手）

3.1 安装宝塔面板（如果还没装）

连接到你的云服务器（用 FinalShell 或终端），执行以下命令：

# Ubuntu / Debian 系统
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

# CentOS 系统
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

安装完成后，终端会显示宝塔面板的访问地址、用户名和密码。记下这些信息。

3.2 安装 LNMP 环境

1. 浏览器访问宝塔面板，登录。
2. 首次登录会弹出”推荐安装套件”窗口，选择 LNMP（Linux + Nginx + MySQL + PHP）。
3. 版本选择：
   • Nginx：最新稳定版
   • MySQL：5.7 即可
   • PHP：选择 7.4 或 8.0
4. 选择”极速安装”，点击”一键安装”，等待 10-20 分钟。

补充说明：Typecho 也支持 SQLite 数据库，如果你不想安装 MySQL，可以跳过 MySQL 的安装，在安装 PHP 时确保启用了 sqlite3 扩展即可。但对于博客来说，MySQL 更稳定，推荐使用。

3.3 创建数据库

1. 宝塔面板 → 数据库 → 添加数据库。
2. 填写：
   • 数据库名：typecho
   • 用户名：typecho
   • 密码：设置一个复杂密码，记下来
3. 点击提交。

3.4 创建网站

1. 宝塔面板 → 网站 → 添加站点。
2. 填写：
   • 域名：填你的域名（如 blog.yourdomain.com）或服务器 IP。
   • 根目录：默认即可。
   • PHP 版本：选择 PHP 7.4 或 8.0。
3. 点击提交。

3.5 下载 Typecho 源码

1. 打开浏览器新标签页，访问 https://github.com/typecho/typecho/releases
2. 在最新版本中，下载 typecho.zip（或 typecho_x.x.x.zip）文件。
3. 回到宝塔面板 → 文件，进入网站的根目录（如 /www/wwwroot/blog.yourdomain.com）。
4. 删除目录中的所有默认文件。
5. 点击 上传，选择下载的 ZIP 文件。
6. 上传完成后，右键 ZIP 文件 → 解压。
7. 解压后，进入 typecho 或 build 子文件夹，把里面的所有文件剪切到网站根目录。删掉空的子文件夹。

确保以下文件直接在网站根目录下：index.php、install.php、admin/ 文件夹等。

3.6 设置伪静态

1. 宝塔面板 → 网站 → 点击你的域名 → 伪静态。
2. 填入以下规则：

if (!-e $request_filename) {
    rewrite ^(.*)$ /index.php$1 last;
}

点击保存。

3.7 安装 Typecho

1. 浏览器访问你的域名或 IP（如 http://你的域名）。
2. 你会看到 Typecho 的安装向导页面。
3. 点击 “我准备好了，开始下一步”。
4. 填写数据库信息：
   • 数据库适配器：选择 Mysql 原生物理适配器
   • 数据库地址：127.0.0.1
   • 数据库端口：3306
   • 数据库用户名：typecho（你在宝塔中创建的用户名）
   • 数据库密码：你设置的密码
   • 数据库名称：typecho
5. 填写站点信息：
   • 站点地址：你的域名（如 http://blog.yourdomain.com）
   • 站点名称：你的博客名称
6. 设置管理员账号：
   • 用户名：admin
   • 登录密码：设置一个复杂密码
   • 邮件地址：你的邮箱
7. 点击 “确认，开始安装”。
8. 安装成功！

3.8 登录后台

1. 访问 http://你的域名/admin
2. 用刚才设置的用户名和密码登录。

登录后进入 Typecho 的后台管理界面。在这里可以写文章、管理评论、更换主题、安装插件。

四、部署方式二：Docker 部署

如果你不想装宝塔面板，可以用 Docker 快速部署。

4.1 安装 Docker

curl -fsSL https://get.docker.com | bash
sudo systemctl start docker
sudo systemctl enable docker

4.2 启动 Typecho 容器

docker run -d \
  --name typecho \
  --restart unless-stopped \
  -p 8080:80 \
  -v ~/typecho/data:/app/data \
  -e TZ=Asia/Shanghai \
  80x86/typecho:latest

命令解释：

• -p 8080:80：把服务器的 8080 端口映射到容器的 80 端口。
• -v ~/typecho/data:/app/data：数据持久化保存。

4.3 访问并安装

浏览器访问 http://你的IP:8080，进入安装向导。数据库适配器可以选择 SQLite（不需要单独安装 MySQL），数据库文件路径填写 /app/data/typecho.db。

五、Typecho 基本使用

5.1 写第一篇文章

1. 后台 → 撰写 → 撰写文章。
2. 输入标题，在编辑器中选择 Markdown 模式，输入内容。
3. 右侧可以设置分类、标签、发布时间。
4. 点击 发布文章。

5.2 更换主题

1. 去 Typecho 官网或 GitHub 搜索 Typecho 主题，下载主题 ZIP 包。
2. 解压后，把主题文件夹上传到 /usr/themes/ 目录下。
3. 后台 → 控制台 → 外观，找到刚才上传的主题，点击 启用。

5.3 安装插件

1. 下载插件 ZIP 包，解压后上传到 /usr/plugins/ 目录下。
2. 后台 → 控制台 → 插件，找到刚才上传的插件，点击 启用。

常用插件推荐：

• CommentToMail：评论邮件提醒
• Access：访问统计
• Sitemap：生成站点地图，方便搜索引擎收录
• CodeMirror：代码高亮

六、绑定域名和开启 HTTPS

6.1 添加 DNS 解析

在域名服务商处，添加一条 A 记录，指向你的服务器 IP。

6.2 配置 Nginx 反向代理（Docker 部署需要）

如果你用 Docker 部署，Typecho 监听 8080 端口。如果不想在域名后面加端口号，可以用 Nginx 反向代理。宝塔部署的跳过这一步。

6.3 申请 SSL 证书

在宝塔面板中：网站 → 点击域名 → SSL → Let’s Encrypt → 一键申请。免费且自动续期。

七、常见问题

Q1：安装时提示”数据库连接失败”

检查数据库主机地址是否为 127.0.0.1，用户名、密码、数据库名是否填写正确。检查 MySQL 服务是否正常运行。

Q2：文章链接打开是 404

这是伪静态没有生效。检查宝塔中该网站的”伪静态”是否正确配置。如果使用 Nginx，确保配置中有 try_files 规则。

Q3：如何升级 Typecho？

1. 备份网站根目录和数据库。
2. 下载最新版 ZIP，解压后覆盖旧文件（保留 /usr/themes/ 和 /usr/plugins/ 目录）。
3. 访问 http://你的域名/install.php，按提示升级数据库。
4. 删除 install.php 文件。

八、总结

Typecho 是目前最轻量的开源博客系统之一，非常适合个人博客。部署流程概括为：

1. 准备环境：PHP + Nginx + MySQL（宝塔一键安装）。
2. 创建数据库和网站。
3. 下载源码：从 GitHub Releases 下载最新 ZIP。
4. 上传并解压到网站根目录。
5. 配置伪静态。
6. 浏览器访问安装向导，填写数据库和管理员信息。
7. 登录后台，开始写作。

如果你想要一个简单、快速、不臃肿的博客，Typecho 是非常好的选择。

项目地址：https://github.com/typecho/typecho