Typecho 部署手册 (Caddy + PHP 8.2 + MariaDB)

本手册适用于 Ubuntu/Debian 系统。

一、 安装 MariaDB 数据库

MariaDB 是 MySQL 的高性能开源替代品，与 Typecho 完全兼容。

安装服务：

sudo apt update
sudo apt install mariadb-server -y
安全初始化： 执行 sudo mysql_secure_installation，按照提示设置 root 密码，并建议删除匿名用户和测试数据库。

创建 Typecho 专用数据库：

sudo mariadb -u root -p

-- 在 SQL 命令行执行：
CREATE DATABASE typecho_db;
CREATE USER 'typecho_user'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON typecho_db.* TO 'typecho_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

二、 安装 PHP 8.2 环境

添加 PHP 仓库：

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

安装必要组件：

sudo apt install -y php8.2-fpm php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip
验证 PHP-FPM 状态： 确认 ps aux | grep php-fpm 输出中包含 php-fpm: pool www，且运行用户为 www-data。

三、 安装 Caddy 服务器

Caddy 会自动处理 SSL 证书（HTTPS）。

安装 Caddy：

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy -y

四、 部署 Typecho 程序与权限设置

下载解压：

sudo mkdir -p /var/www/typecho
cd /var/www/typecho
sudo wget https://github.com/typecho/typecho/releases/latest/download/typecho.zip
sudo unzip typecho.zip

权限调优（解决“上传目录无法写入”关键）：

# 将所有权交给 PHP 运行用户 www-data
sudo chown -R www-data:www-data /var/www/typecho

# 设置目录权限
sudo find /var/www/typecho -type d -exec chmod 755 {} \;
sudo find /var/www/typecho -type f -exec chmod 644 {} \;

# 将 caddy 加入 www-data 组，确保读写顺畅
sudo usermod -aG www-data caddy

五、 配置 Caddyfile

编辑配置文件：sudo nano /etc/caddy/Caddyfile

写入以下内容（注意替换域名）：

代码段
yourdomain.com {
    # 网站根目录
    root * /var/www/typecho

    # 开启压缩
    encode gzip

    # 关键：PHP-FPM 通信
    php_fastcgi unix//run/php/php8.2-fpm.sock

    # 静态文件处理
    file_server

    # Typecho 伪静态
    try_files {path} {path}/ /index.php?{query}

    # 日志配置（位于站点块顶层）
    log {
        output file /var/log/caddy/typecho_access.log
    }
}

检查并生效：

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy

六、 在线安装注意事项

访问你的域名，进入安装界面：

数据库适配器： 选择 Pdo 驱动 Mysql 适配器（MariaDB 通用驱动）。

数据库地址： 填写 localhost 或 127.0.0.1。

用户与名： 填写第一步中创建的 typecho_user 和 typecho_db。

确认安装： 若提示目录不可写，请重新执行第四步的 chown 命令。