Typecho 部署教程 | 从零开始搭建你的个人博客

一、前言

Typecho 是一款轻量级的博客系统，以其简洁的界面、强大的功能和良好的扩展性广受开发者喜爱。本文将详细讲解如何在 Linux 服务器上部署 Typecho，包含环境准备、代码下载、数据库配置、域名绑定、SSL 证书安装等关键步骤，适合新手和进阶用户参考。

二、环境准备

1. 服务器需求

操作系统：Ubuntu 20.04 或 CentOS 7+
Web 服务器：Nginx 或 Apache
数据库：MySQL 或 MariaDB
域名：已备案的域名（如 example.com）
SSH 访问权限：服务器 SSH 登录权限

2. 环境部署

宝塔安装

宝塔安装参考此视频：
宝塔安装Typecho视频教程
#BV# danmuku:false;

第一步：安装宝塔面板

登录服务器
通过 SSH 登录到你的 Linux 服务器（Ubuntu / CentOS 等）。

安装宝塔面板
通过以下命令安装（以 Ubuntu 为例）：

# Ubuntu/CentOS/Debian
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

配置宝塔面板
安装完成后，记录默认端口，浏览器访问 http://your_server_ip:端口，按照提示设置管理员账号和密码。

第二步：创建网站和数据库

创建网站
登录宝塔面板，进入 网站 > 添加网站。
填写域名（如 example.com）。
设置 PHP 版本（推荐 7.4 或 8.0）。
设置 网站根目录（默认为 /www/wwwroot/example.com）。

创建数据库
进入 数据库 > 添加数据库。
填写数据库名（如 typecho）、用户名（如 typecho）和密码。
确保数据库字符集为 utf8mb4。

命令行安装

安装 Nginx（以 Ubuntu 为例）
sudo apt update
sudo apt install nginx
安装 MySQL
sudo apt install mysql-server
安装 PHP 及扩展
sudo apt install php php-mysql php-curl php-gd php-mbstring php-xml php-zip
验证 PHP 版本
php -v

三、部署 Typecho 步骤

1. 下载 Typecho 源码

# 使用 Git 克隆最新版本
git clone https://github.com/Typecho/Typecho.git /var/www/Typecho

或直接下载压缩包：
访问 Typecho 官方发布页
下载最新版本（如 Typecho-2.0.10.zip）
解压到 /var/www/Typecho 目录

2. 配置数据库

# 登录 MySQL
mysql -u root -p

创建数据库和用户：

CREATE DATABASE typecho;
CREATE USER 'typecho'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON typecho.* TO 'typecho'@'localhost';
FLUSH PRIVILEGES;

3. 配置 Typecho 配置文件

进入 Typecho 目录：

cd /var/www/Typecho

复制配置模板：

_fastcgi_config.php

修改配置文件：

nano /var/www/Typecho/config.inc.php

修改以下内容：

'db' => [
    'type' => 'mysql',
    'host' => '127.0.0.1',
    'user' => 'typecho',
    'pwd' => 'your_password',
    'dbname' => 'typecho',
    'charset' => 'utf8mb4',
],

4. 配置 Nginx 虚拟主机

创建 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/typcho

添加以下内容：

server {
    listen 80;
    server_name example.com;

    location / {
        root /var/www/Typecho;
        index index.php;
        try_files $uri $uri/ /index.php?$query_string;

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

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/typcho /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

5. 域名解析

登录域名服务商后台（如阿里云、腾讯云）。
添加 A 记录，将域名解析到服务器 IP（如 114.114.114.114）。
等待 DNS 更新（通常 24 小时）。

6. 安装 SSL 证书（Let's Encrypt）

使用 Certbot 自动申请 SSL：

sudo apt install certbot
sudo certbot --nginx -d example.com

Certbot 会自动修改 Nginx 配置，添加 HTTPS 支持。

四、初始化 Typecho

访问 https://example.com，进入安装向导。
根据提示完成初始化：

  • 设置管理员账号
  • 选择主题（如 Ming 或 Layui）
  • 配置基本参数（网站标题、SEO 设置等）

五、常见问题排查

1. 端口冲突

检查 80/443 端口是否被占用：

sudo netstat -tuln

2. PHP 脚本错误

查看 Nginx 错误日志：

sudo tail -f /var/log/nginx/error.log

3. 数据库连接失败

检查 MySQL 用户权限和密码是否正确。
确保数据库字符集为 utf8mb4。

4. 静态资源加载失败

确认 Nginx 配置中的 root 路径正确。
检查 .htaccess 文件是否存在（Typecho 默认支持）。

六、进阶优化

1. 配置反向代理

location / {
    proxy_pass https://127.0.0.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

2. 配置 CDN

使用 Cloudflare 或 CDN 网站，加速全球访问。

3. 安全加固

设置防火墙规则：

sudo ufw allow 22
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

七、后续维护

定期备份：使用 tar 或 MySQL 备份工具。
更新类型：定期升级 Typecho 到最新版本。
监控日志：通过 logrotate 工具管理日志文件。

八、结语

通过本文，你已成功在 Linux 服务器上部署了 Typecho 博客系统。后续可根据需求添加多语言支持、自定义主题、插件扩展等功能。如果遇到具体问题，欢迎随时在评论区交流。

📌 注意：部署前请确保服务器已开通 SSH 访问权限。

本文作者：Cyril2007

本文链接：http://120.24.178.77/archives/2025/05/03/typecho-start/8/

版权声明：转载时须注明出处及本声明