本指南适用于宝塔 Linux 面板（BT Panel）。虚拟主机用户可跳过，直接按 README 的 「方式一：发布包」操作即可（虚拟主机通常已内置 Apache/Nginx 伪静态支持）。
一、建站与运行环境
宝塔面板 → 网站 → 添加站点（PHP 版本选 8.1+，如 8.2/8.3）
若站点目录不是默认的
/www/wwwroot/你的域名，记下实际路径软件商店确认已安装 PHP 8.1+，并开启以下扩展：
pdo、pdo_mysql、gd、zip、mbstring、openssl、fileinfo数据库：添加 MySQL 数据库（5.7.6+，推荐 8.0），记下数据库名 / 用户名 / 密码
二、上传与解压
下载
pafish-php-vX.Y.Z.zip发布包宝塔文件管理器进入
/www/wwwroot/你的域名/，上传 zip右键 zip → 解压 → 得到
pafish/目录进入
pafish/，全选 → 剪切，回到站点根目录粘贴（此时站点根目录就是 pafish 的全部文件）删除站点根目录下残留的空
pafish/目录和 zip 包
也可以在添加站点时直接把网站根目录设为
pafish/，免去移动步骤。
三、PHP 上传限制（应用商店必需）
主题/插件 zip 包上限 10MB，需确保：
post_max_size≥ 16Mupload_max_filesize≥ 12M
操作：软件商店 → PHP → 设置 → 「配置修改」→ 搜索 post_max_size 与 upload_max_filesize 修改后保存；
或在「上传限制」页直接调大。修改后 PHP 需要重启（设置页右下角「重启」按钮）。
低于 10M 时博客核心功能不受影响，安装向导只给警告；10M 到目标值之间会直接阻断环境检查，需要先调大上传限制。目标值：post_max_size ≥ 16M、upload_max_filesize ≥ 12M。
四、安装向导
浏览器访问
http://你的域名/install.php环境检查页：全部 ✓ 后点「下一步」
填写数据库连接（第二步创建的库）与站点信息、管理员账号
安装完成 → 立即删除
install.php打开首页即可访问；
http://你的域名/admin/进入后台
五、定时发布（计划任务，可选）
宝塔面板 → 计划任务 → 添加任务：
类型：Shell 脚本
名称：pafish 定时发布
执行周期：每 1 分钟（N 分钟）
脚本内容：
php /www/wwwroot/你的域名/cron.php
保存即可。没有配置计划任务时，前台请求也会低频自动发布到期文章，定时功能不会失效。
六、伪静态（Nginx）
安装完成、删除 install.php 后，将下面规则加入 Nginx server 配置。网站运行目录应指向 Pafish 项目根目录；PHP 拦截规则必须放在通用 PHP-FPM 规则之前：
location ~* ^/(config\.php|composer\.(json|lock)|\.env)(/|$) {
deny all;
}
location ^~ /runtime/ {
deny all;
}
location ^~ /backups/ {
deny all;
}
location ~ ^/(?!index\.php$|cron\.php$).*\.php(?:/|$) {
deny all;
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}若宝塔配置中已经有 location /，请合并规则而不要重复添加。不要改成 try_files $uri =404，否则动态路由会直接返回 404。完整站点配置（含 PHP-FPM）见Nginx 配置示例。
快速判断：用同一篇已发布文章测试
/post/文章slug和/index.php?p=post/文章slug。只有后者能打开时，就是伪静态配置未生效；两者都打不开再检查 文章状态、站点目录和 PHP 错误日志。项目入口也兼容/index.php/路径及子目录部署。静态资源 404：在浏览器网络面板确认失败地址遵循
/public/...、/uploads/...或/themes/{主题名}/...，并确认文件存在于项目的public/、public/uploads/或对应主题目录。
Apache（.htaccess）已随发布包内置；请启用 mod_rewrite 并允许 .htaccess 生效。
若服务器无法启用伪静态，可在安装向导中取消勾选「启用伪静态」，或在 runtime/config.php 中设置 pretty_urls 为 false。链接会使用 index.php?p=xxx 形式，无需任何重写规则。
七、安全建议
删除
install.php首次登录后立即在「个人资料」中修改管理员密码（安装向导要求现场设置，不存在内置默认密码）
站点设置 → 安全：建议关闭注册（或开启邮箱验证）、开启评论审核
定期在后台「备份」页创建数据库备份