FmBlog 完整安装教程（含 ThinkPHP 伪静态）

FmBlog 是基于 PHP8+、SQLite 的轻量博客，无需手动配置数据库，开箱即用，伪静态直接使用 ThinkPHP 通用规则。

一、环境要求

Web 服务器：Nginx / Apache / IIS

PHP 版本：PHP 8.0 及以上

扩展：开启 sqlite3、pdo_sqlite（面板默认一般已开）

空间权限：根目录可写，无需创建数据库

二、安装步骤

1. 下载与上传

前往官网 http://www.fmcode.com.cn/ 下载最新安装包

解压后，将所有文件上传至服务器网站根目录

运行目录设置：public文件夹

确保以下目录权限为 755，所有者为 Web 运行用户：

/runtime
/uploads

根目录（用于自动生成 SQLite 数据库文件）

2. 运行安装向导

浏览器访问你的域名：https://你的域名/

系统自动检测环境，满足条件点击下一步

设置管理员账号、密码、邮箱、站点名称

点击完成安装，自动创建 SQLite 数据库

安装成功后，删除 /install 目录提升安全

后台地址：https://你的域名/admin

三、伪静态配置（必做）

FmBlog 基于类 ThinkPHP 架构，直接使用 TP 官方伪静态规则，隐藏 index.php，URL 更美观。

Apache 配置

在网站根目录新建 / 编辑 .htaccess

写入以下规则：

apache

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]

确保 Apache 开启 mod_rewrite，虚拟主机 AllowOverride All。

Nginx 配置（推荐）

打开站点配置文件（如 nginx.conf 或 vhost 配置）

在 server 块内添加：

nginx

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

保存后重启 Nginx生效。

宝塔 / 小皮面板快速设置

宝塔：网站设置 → 伪静态 → 选择 ThinkPHP 模板 → 保存

小皮：主机设置 → 伪静态 → 选用 TP 规则 → 确认

四、安装后验证

前台访问：https://你的域名 正常打开

后台访问：https://你的域名/admin 可登录

文章 / 分类链接无 index.php，伪静态生效

上传图片、新建文章正常，权限无误

五、常见问题

环境不满足：升级 PHP 到 8.0+，开启 sqlite3、pdo_sqlite 扩展

404 错误：检查伪静态规则是否正确，重启 Web 服务

无法写入：修正目录权限为 755，所有者为 www/web

安装后报错：删除 /install 目录，清空 /runtime 缓存