快速安装指南

环境要求

• PHP 8.1 及以上（推荐 8.3/8.4），需启用 pdo_mysql、mbstring、json、openssl 扩展
• MySQL 5.7 / 8.0（MariaDB 10.3+ 亦可）
• Nginx 或 Apache（伪静态规则见下）；云虚拟主机亦可
• 零依赖：无需 Composer、无需 Node、无需 Redis（可选）

安装步骤

1. 上传源码包（ryeblog-x.y.z.zip）到站点根目录并解压；
2. 浏览器访问 https://你的域名/install.php，按向导填写：站点标题、数据库主机/库名/用户/密码、管理员账号；
3. 安装完成后会自动生成 config.php 并写入基础数据；
4. 访问首页确认正常，然后登录后台（/admin）开始建站。

提示：安装向导检测到已安装会提示删除 install.php；请务必删除，避免被重新安装覆盖数据。

宝塔面板（Nginx）伪静态配置

面板 → 站点 → 伪静态，写入以下规则（保存后自动 reload）：

location / { try_files $uri $uri/ @ryeblog; }
location @ryeblog {
    rewrite ^/sitemap.xml$ /sitemap.php last;
    rewrite ^/feed/?$ /feed.php last;
    rewrite ^/post/([^/]+)/?$ /post.php?slug=$1 last;
    rewrite ^/category/([^/]+)/?$ /category.php?c=$1 last;
    rewrite ^/tag/([^/]+)/?$ /tag.php?t=$1 last;
    rewrite ^/tags/?$ /tags.php last;
    rewrite ^/archive/?$ /archive.php last;
    rewrite ^/page/([^/]+)/?$ /page.php?p=$1 last;
    rewrite ^/search/?$ /search.php last;
    rewrite ^/([^.]+).html$ /post.php?slug=$1 last;
    rewrite (.*) /index.php last;
}

Apache 环境请使用后台「高级设置 → 伪静态」中给出的 .htaccess 规则。

安全加固

• 删除 install.php、限制 config.php 权限（644）；
• 系统已内置：后台登录防爆破（ip 限流）、CSRF 令牌、XSS 转义、上传类型/大小校验、回收站软删除；
• 数据导出/备份目录（usr/uploads/export、usr/uploads/backup）已由 nginx 规则禁止直接访问。

下一步

建议阅读：后台使用手册 与 SEO 与站点设置。