aaPanel（宝塔）面板安装

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

aaPanel 的界面是英文的。下面提到的菜单和按钮都照界面原样写英文，第一次出现时在括号里注明意思。

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

第一步：装 aaPanel

服务器系统推荐 Ubuntu 22.04（aaPanel 官方推荐），也支持 CentOS 7、Debian 10/11/12、Ubuntu 18.04/20.04、AlmaLinux 8/9、Rocky Linux 8。配置最低 1 核、512 MB 内存，建议 1 GB 以上。最好用一台刚重装、没装过别的环境的服务器。

用 SSH 以 root 身份连上服务器，执行这条命令安装免费版：

URL=https://www.aapanel.com/script/install_panel_en.sh && if [ -f /usr/bin/curl ];then curl -ksSO $URL ;else wget --no-check-certificate -O install_panel_en.sh $URL;fi;bash install_panel_en.sh

命令以官网 https://www.aapanel.com/new/download.html 为准，官网换了就照官网的来。

安装要几分钟，装完屏幕会打印面板地址、用户名、密码，先抄下来。

第二步：装运行环境

第一次登录面板会弹出推荐的软件套件，选 LNMP（Nginx + MySQL + PHP），然后按下面选版本：

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

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

aaPanel 的 PHP 已经自带 bcmath（程序所有的金额计算都靠它），不用另外装；gd、curl、zip、pdo_mysql 一般也都带了。

安装向导第一步会自动体检，万一缺了哪个扩展会直接列出来。到 App Store（软件商店）→ 你装的 PHP 版本 → Setting（设置）→ Install extensions（安装扩展）里装上，刷新即可。

第三步：建站点

1. 左侧菜单 → Website（网站）→ Add site（添加站点）
2. 域名填你的域名（还没域名就填服务器 IP）
3. 根目录保持默认的 /www/wwwroot/你的域名 就行
4. Database（数据库）选 MySQL，数据库名、用户名、密码会自动生成，记下来
5. PHP version（PHP 版本）选你刚装的那个
6. 提交

第四步：上传源码

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

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

第五步：配置伪静态

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

Website → 点你的站点 → URL rewrite（伪静态），把 nginx 伪静态规则 整段粘进去，保存。

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

第六步：设置目录权限

在 Files 里选中网站根目录 → Permission（权限）→ 所有者填 www，并应用到子目录。

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

第七步：开始安装

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

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

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

接下来

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

常见问题

现象	原因
只有首页能打开，点啥都 404	伪静态没配，回第五步
白屏 / 500	先看网站根目录的 runtime.log，真实报错一般都在里面；还没装完的话，看安装向导的环境检测有没有红叉
安装向导提示目录不可写	权限没给，回第六步
数据库连接失败	地址填 127.0.0.1，用户名和密码用 aaPanel 生成的那组

更多见 常见问题。