🚀 安装指南

从零开始部署 TBlog 只需要 3 分钟。提供两种安装方式，向导安装最简单。

✨ 方式一：向导安装（推荐）

下载源码 从 GitHub Releases 下载最新版本（TBlog_v1.x.x.zip）。

上传并解压 将压缩包上传到服务器网站目录并解压：

# 例如解压到 /var/www/html
cd /var/www/html
unzip TBlog_v1.0.0.zip
chown -R www-data:www-data .  # Apache
# 或 chown -R nginx:nginx .  # Nginx + PHP-FPM

创建数据库 登录 MySQL，创建一个空数据库（字符集 utf8mb4）：
```
CREATE DATABASE tblog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```
访问安装向导 浏览器打开 http://你的域名/install.php，按提示填写：
- 数据库主机（一般是 localhost）
- 数据库名 / 用户名 / 密码
- 表前缀（默认 tblog_）
- 站点名称、管理员账号密码
完成安装 向导会自动创建 config.php、建表、初始化设置。成功后页面会提示。

⚠️

注意

安装完成后，建议删除 install.php 和 install.sql，避免被重复执行。

🛠 方式二：手动配置

适合需要完全控制部署过程的场景，比如容器化或 GitOps。

创建数据库 同上，创建一个 utf8mb4 的空数据库。
导入表结构
```
mysql -u root -p tblog < install.sql
```

创建 config.php 复制 config.php.new 为 config.php，按需修改：

config.php

<?php
return [
    'DB_HOST'   => 'localhost',
    'DB_USER'   => 'tblog_user',
    'DB_PASS'   => 'your_secure_password',
    'DB_NAME'   => 'tblog',
    'DB_PORT'   => 3306,
    'DB_PREFIX' => 'tblog_',
];

设置管理员密码 先生成哈希，再写入数据库：

# 生成密码哈希
php -r "echo password_hash('你的密码', PASSWORD_DEFAULT) . PHP_EOL;"

INSERT INTO `tblog_settings` (`key`, `value`) VALUES
('admin_user', 'admin'),
('admin_hash', '把上面输出的哈希粘到这里');

🌐 Nginx 配置示例

/etc/nginx/sites-available/tblog.conf

server {
    listen 80;
    server_name tblog.cn www.tblog.cn;
    root /var/www/html;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~ /\.(ht|git) { deny all; }
}

🌐 Apache 配置

Apache 用户请确保启用了 mod_rewrite，并允许 .htaccess 覆盖。TBlog 自带的 .htaccess 已处理 URL 重写。

🔐 权限设置

安装时 config.php 需要可写（向导会写入配置）。生产环境建议 chmod 644，避免被外部修改：

chmod 644 config.php
chown root:www-data config.php  # root 拥有，web 用户只读

✅ 安装后检查清单

访问首页 http://你的域名/ 能看到默认主题
访问 http://你的域名/admin/ 能登录管理后台
尝试发布一篇文章，访问 http://你的域名/?p=1 能看到
已删除 install.php 和 install.sql
已修改默认管理员密码（不要用 admin / admin123）

🎉

安装成功！