Typecho是一款国产开源轻量级博客程序,基于PHP开发,以GPLv2协议开源。Typecho的名字来源于Type和Echo的组合,寓意”打字并回响”。它以极简的设计理念、优秀的性能和流畅的用户体验著称,安装包仅几百KB,运行资源占用极低,非常适合个人博客和小型网站。
核心优势:极致轻量(安装包不到1MB)、运行速度快、Markdown编辑支持、简洁优雅的后台界面、插件和主题生态活跃、代码结构清晰易于二次开发、支持多种数据库(MySQL/SQLite/PostgreSQL)。是国内个人博客用户的热门选择。
环境要求
- Web服务器:Nginx / Apache / LiteSpeed
- PHP版本:PHP 7.2 ~ 8.3(推荐PHP 8.0+)
- 数据库:MySQL 5.5+ / MariaDB / SQLite 3 / PostgreSQL
- 内存:最低128MB,推荐256MB以上
- 磁盘:至少50MB可用空间
- PHP扩展:pdo、pdo_mysql(或pdo_sqlite)、mbstring、json、curl、gd(可选)
安装教程
步骤1:下载Typecho安装包
cd /www/wwwroot/yourdomain.com
wget https://github.com/typecho/typecho/releases/latest/download/typecho.zip
unzip typecho.zip
rm -f typecho.zip
如果GitHub下载慢,可以使用官方下载地址或国内镜像。
步骤2:创建数据库(MySQL方式)
mysql -u root -p
CREATE DATABASE typecho DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'typecho_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON typecho.* TO 'typecho_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
也可以选择SQLite,无需创建数据库,安装时自动生成.db文件。
步骤3:配置文件权限
chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/usr/uploads
步骤4:Nginx配置
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /www/wwwroot/yourdomain.com;
index index.php index.html;
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php$1 last;
}
location ~ \.php$ {
fastcgi_pass unix:/tmp/php-cgi-82.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location ~ /\.ht {
deny all;
}
}
步骤5:运行安装向导
浏览器访问 http://yourdomain.com,进入安装页面:
- 确认安装欢迎页面,点击”我已经准备好了,开始安装”
- 配置数据库:
- 数据库适配器:选择Pdo_Mysql(或Pdo_SQLite)
- 数据库地址:localhost
- 数据库用户名:typecho_user
- 数据库密码:你的密码
- 数据库名:typecho
- 数据库前缀:typecho_(默认即可)
- 设置网站:
- 站点名称:你的博客名称
- 管理员用户名:admin
- 管理员密码:设置强密码
- 管理员邮箱:你的邮箱
- 点击”开始安装”,等待完成
步骤6:登录后台
安装完成后,访问 http://yourdomain.com/admin 登录后台。Typecho后台简洁直观,主要功能包括:撰写文章、管理分类、独立页面、评论管理、外观主题、插件管理、设置等。
Windows环境安装(phpStudy集成环境)
对于Windows用户,推荐使用phpStudy或XAMPP集成环境快速搭建:
- 下载安装phpStudy(https://www.xp.cn)或XAMPP(https://www.apachefriends.org)
- 启动集成环境,开启Apache/Nginx和MySQL服务
- 将程序源码解压到网站根目录(phpStudy默认是WWW目录,XAMPP默认是htdocs目录)
- 打开phpMyAdmin创建数据库(访问http://localhost/phpmyadmin)
- 浏览器访问http://localhost,按照安装向导完成安装
注意:Windows环境仅推荐用于本地开发和测试,生产环境建议使用Linux服务器。
宝塔面板安装(推荐)
宝塔面板是国内最流行的服务器管理面板,支持一键部署PHP环境和网站:
- 安装宝塔面板:CentOS执行
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh,Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh - 安装完成后,登录宝塔面板(地址和账号密码在安装完成后显示)
- 首次登录提示安装LNMP/LAMP环境,选择Nginx + MySQL + PHP,点击一键安装
- 点击”网站” → “添加站点”,填写域名、选择PHP版本、创建数据库
- 将程序源码上传到网站根目录(/www/wwwroot/你的域名)
- 设置目录权限:在文件管理器中选中网站目录,权限设置为755,所有者为www
- 浏览器访问域名,按照安装向导完成安装
宝塔面板优势:可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。
服务器配置建议
- PHP内存限制:
memory_limit = 64M(足够,推荐128M) - 上传文件大小:
upload_max_filesize = 16M,post_max_size = 16M - 最大执行时间:
max_execution_time = 60 - 启用OPcache(Typecho轻量,OPcache效果明显)
- 后台设置 → 基本 → 开启”地址重写功能”(需Nginx配置支持)
- 安装缓存插件(如Tpcache)进一步加速
- 定期备份数据库和usr目录
- 关注官方更新,及时升级到最新版本
常见问题
Q:安装时提示”无法连接数据库”?
A:检查数据库用户名、密码是否正确,数据库是否已创建,MySQL服务是否运行。确认PHP安装了pdo_mysql扩展。
Q:开启地址重写后文章页面404?
A:确认Nginx配置中包含rewrite规则:if (!-e $request_filename) { rewrite ^(.*)$ /index.php$1 last; }
Q:上传图片失败?
A:检查usr/uploads目录权限是否为777,所有者是否为www。检查PHP的upload_max_filesize设置。
Q:忘记管理员密码怎么办?
A:数据库执行:UPDATE typecho_users SET password=MD5('新密码') WHERE uid=1;(typecho_替换为你的表前缀)
Q:Typecho和WordPress怎么选?
A:追求轻量、简洁、快速选Typecho;需要丰富插件、主题、电商功能选WordPress。个人博客Typecho足够,企业站建议WordPress。
官方网址
官方网站:https://typecho.org
下载地址:https://typecho.org/download