宝塔面板安装

适合有一台 Linux 服务器、想用图形界面管理的人。全程大约 15 分钟。

想省事的话看 Docker 安装，三分钟跑起来，也不用装数据库。

第一步：装宝塔面板

服务器系统推荐 CentOS 7+ / Debian 11+ / Ubuntu 20.04+。用 SSH 连上服务器，按 https://www.bt.cn/new/download.html 上对应系统的一行命令安装。

装完屏幕会打印面板地址、账号、密码，先抄下来。

第二步：装运行环境

第一次登录面板会弹出推荐套件，选 LNMP，然后按下面选版本：

组件	选什么
Nginx	任意版本
MySQL	5.7 或以上
PHP	8.0 以上，推荐 8.2

点「一键安装」，等它装完（大约 10 分钟，可以先干别的）。

第三步：装 bcmath 扩展（关键，别跳过）

宝塔默认不装 bcmath，而程序所有的金额计算都靠它，缺了会直接白屏报致命错误。

1. 左侧菜单 → 软件商店 → 找到你装的 PHP 版本 → 点 设置
2. 切到 安装扩展 标签
3. 找到 bcmath，点安装

顺便确认这几个也在：gd、curl、zip、pdo_mysql。宝塔一般默认带了。

安装向导第一步会自动体检，缺哪个扩展会直接列出来，装完刷新即可。

第四步：建站点

1. 左侧菜单 → 网站 → 添加站点
2. 域名填你的域名（还没域名就填服务器 IP）
3. 数据库选 MySQL，账号密码它会自动生成，记下来
4. PHP 版本选你刚装的那个
5. 提交

第五步：上传源码

1. 从 https://faka.wiki/download.php 下载压缩包（访问 GitHub 顺畅的话也可以直接从仓库下）
2. 在宝塔 → 文件 → 进入网站根目录（一般是 /www/wwwroot/你的域名）
3. 上传压缩包，右键 解压
4. 解压后如果多了一层文件夹（比如 acg-faka-main），进去把里面的文件全选剪切到网站根目录，让 index.php 直接躺在根目录下

根目录下能直接看到 index.php、app、kernel、config 这些，就对了。

第六步：配置伪静态

这一步不做，网站只有首页能打开，点任何链接都是 404。

网站 → 点你的站点 → 伪静态，把 nginx 伪静态规则 整段粘进去，保存。

用 Apache 的话不用配，程序根目录的 .htaccess 已经写好了。

第七步：设置目录权限

网站 → 点你的站点 → 网站目录 → 把所有者设为 www，或者在 文件 里选中网站根目录 → 右键 权限 → 所有者填 www，勾上「应用到子目录」。

程序需要写这四个地方：config、runtime、kernel/Install、assets/cache。

第八步：开始安装

浏览器打开你的域名，会看到安装向导：

1. 环境检测 —— 有红叉就照着提示装扩展或改权限
2. 数据库 —— 填第四步宝塔给你的数据库名、账号、密码，地址填 127.0.0.1
3. 站长账号 —— 设置后台的邮箱和密码
4. 点安装，等它跑完

装完后台地址是 https://你的域名/admin。

接下来

• 绑定域名、上 HTTPS、绑多个域名：见域名与 HTTPS 证书
• 让店铺快起来：性能优化（装 Redis，效果非常明显）
• 开始用：快速上手

常见问题

现象	原因
只有首页能打开，点啥都 404	伪静态没配，回第六步
白屏 / 500	多半缺 bcmath，回第三步；也看下网站根目录的 runtime.log
安装向导提示目录不可写	权限没给，回第七步
数据库连接失败	地址填 127.0.0.1，账号密码用宝塔生成的那组

更多见 常见问题。