宝塔面板部署方案

从零开始在阿里云 ECS 上安装宝塔面板并配置客联盈系统运行环境，适合运维与实施团队交付使用。

本文仅涵盖服务器选购、宝塔安装、环境配置，不涉及具体业务代码部署。

官方参考：阿里云帮助中心 · 宝塔 Linux 面板

---

一、阿里云 ECS 服务器选购

1.1 推荐规格

1.2 操作系统选择

必须使用干净系统（新购或重装后的纯净镜像，未手动装过 Nginx / Apache / PHP / MySQL / Redis）。

不要选：已预装"建站环境 / LNMP / WordPress"的应用镜像（会与宝塔冲突）。

1.3 购买与登录

1. 登录 阿里云控制台 → 云服务器 ECS → 创建实例，按上表选配。
2. 购买完成后，在实例列表中找到公网 IP。
3. 设置 root 密码（实例 → 重置密码）。
4. 本机 SSH 登录：

ssh root@你的公网IP

Windows 可用：终端 / PuTTY / FinalShell / 阿里云"远程连接"。

---

二、安全组配置（装之前先放行）

阿里云有两层网络控制，都要放行，否则装完打不开面板。

2.1 安全组（控制台必做）

ECS 实例 → 安全组 → 配置规则 → 入方向 添加：

说明：

• 安装过程若提示面板端口不是 8888，以终端输出为准，安全组放行实际端口。
• 安装完成后宝塔面板端口建议改为其他端口（如 15888），安全组需同步放行。
• 3306 / 6379 不要对公网开放（仅本机或内网使用）。

2.2 系统防火墙

CentOS 系镜像若已开启 firewalld，需同步放行上述端口，或安装期临时关闭后再在宝塔里统一管理。

---

三、安装宝塔面板

以下两种方式二选一，装的都是宝塔 Linux 面板免费版，不要在同一台机重复安装。

3.1 方式 A：阿里云控制台扩展程序（推荐新手）

适用于：公共镜像、干净系统、实例运行中且已分配公网 IP。

1. 阿里云控制台 → 云服务器 ECS → 目标实例 → 实例详情。
2. 右侧 扩展程序 → 安装扩展程序。
3. 选择 公共扩展程序 → 宝塔面板免费版一键安装 → 确认安装。
4. 等待任务状态变为 已完成（约数分钟，期间勿重启实例）。
5. 已安装的扩展程序 → 该扩展 → 配置信息，复制保存：

- 公网面板 URL - 用户名、初始密码

1. 安全组：扩展可能自动放行 8888；若打不开面板，按第二节手动核对入方向规则。
2. 浏览器打开面板 URL 登录，继续第四节与第五节。

3.2 方式 B：SSH 脚本安装（CentOS 优先）

全程用 root（或 sudo -i）。安装约数分钟，期间不要断开 SSH。

yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec

提示确认时输入 y 回车。

其他发行版可选脚本（Ubuntu / Debian 等）：

url=https://download.bt.cn/install/install_lts.sh
if [ -f /usr/bin/curl ]; then
  curl -sSO $url
else
  wget -O install_lts.sh $url
fi
bash install_lts.sh ed8484bec

# Ubuntu / Deepin / Debian
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh ed8484bec

脚本地址若失效，到 https://www.bt.cn/linux 复制官网最新命令。

3.3 安装成功标志

方式 A：扩展程序任务已完成，且"配置信息"中 URL 可在浏览器打开并登录。

方式 B：终端末尾会打印类似信息（立刻复制保存）：

==================================================================
Congratulations! Installed successfully!
==================================================================
外网面板地址: http://x.x.x.x:8888/xxxxxxxx
内网面板地址: http://...
username: xxxxxx
password: xxxxxx
==================================================================

用浏览器打开"外网面板地址"→ 输入用户名密码登录。

若打不开：

1. 核对安全组是否放行面板端口；
2. 本机网络是否拦截；
3. 服务器上执行 bt default 查看当前面板地址与账号。

---

四、首次登录必做（安全加固）

1. 绑定宝塔账号（按提示，免费版即可）。
2. 修改面板密码为强密码。
3. 面板设置 → 安全：

- 修改面板端口（勿继续用 8888），同步改阿里云安全组； - 开启"面板 SSL"（可选）； - 授权 IP：仅允许公司/家宽 IP 访问面板； - 关闭"API"除非你明确要用。

1. SSH：尽量改为密钥登录，禁用密码登录（改完前先确认密钥可用）。
2. 阿里云控制台：为 root 设强密码或禁用密码 + 密钥；开启云监控告警可选。

---

五、必装环境与插件清单

路径约定：宝塔左侧 软件商店。

5.1 总览清单

5.2 安装运行环境

1. 登录宝塔 → 左侧 软件商店。
2. 顶部切到 运行环境。
3. 依次找到 Nginx / MySQL / PHP-8.1 / Redis，点 安装：

- 编译安装 / 极速安装均可；内存紧张优先"极速安装"。 - MySQL 选 5.7.40；PHP 必须选 8.1。 - 可多选后批量装，耐心等 10～30 分钟。

1. 安装完成后，在 软件商店 → 已安装 确认四者状态为"运行中"。

首次装完若弹出"LNMP 一键推荐"，按上表勾选即可，不要勾 Apache。

5.3 PHP 8.1 必装扩展

软件商店 → PHP-8.1 → 设置 → 安装扩展，逐个安装（已安装的跳过）：

装完后 重载 PHP。终端自检：

/www/server/php/81/bin/php -m | grep -Ei 'pdo_mysql|gd|zip|bcmath|fileinfo|intl|opcache'

5.4 PHP 禁用函数清理（必做）

PHP-8.1 → 设置 → 禁用函数，从列表中删除下列项（若存在），保存并重载：

putenv
proc_open
proc_get_status
proc_close
pcntl_signal
pcntl_alarm
pcntl_fork
exec
shell_exec
passthru
popen
symlink
readlink
link

不清理会导致 Composer 安装依赖和命令行工具报错。

5.5 PHP 上传与内存配置

PHP-8.1 → 设置 → 配置修改（或"性能调整"）：

upload_max_filesize = 50M
post_max_size = 60M
memory_limit = 512M
max_execution_time = 300

保存并重载 PHP。

5.6 MySQL 配置

软件商店 → MySQL 5.7 → 设置 → 配置修改，在 [mysqld] 中确保：

character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
sql_mode=STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

保存 → 重载配置 / 重启。

MySQL root 密码设置

宝塔安装 MySQL 后会生成初始密码，可通过以下命令获取：

sqlite3 /www/server/panel/data/default.db "SELECT mysql_root FROM config LIMIT 1;"

1. 软件商店 → 已安装 → MySQL → 设置 → 根密码。
2. 设强密码并保存。
3. 安全：MySQL 设置里确认只监听本机；阿里云安全组不要放行 3306。

忘记密码时强制重置

如果面板改密码不生效或忘记密码，通过 SSH 执行：

# 1. 停 MySQL
/etc/init.d/mysqld stop
2. 跳过权限启动
/www/server/mysql/bin/mysqld --skip-grant-tables --user=mysql &
sleep 3
3. 无密码登录
mysql -u root

进入 MySQL 后执行：

FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';
FLUSH PRIVILEGES;
EXIT;

# 4. 杀进程，正常重启
pkill -f skip-grant-tables
/etc/init.d/mysqld restart
5. 验证
mysql -u root -p

5.7 Redis 配置

1. 软件商店 → Redis → 安装（7.x）。
2. 设置 → 配置修改：增加或修改 requirepass 你的强密码
3. 重启 Redis。
4. 确认未对公网开放 6379（安全组不要放行）。

5.8 Supervisor（强烈建议）

用于守护后台队列进程，确保异步任务（通知、导出等）稳定运行。

安装插件

软件商店 → 系统工具 → 搜 Supervisor → 安装。安装后在已安装中确认状态为"运行中"。

添加守护进程

业务代码部署完成后，在 Supervisor 中添加守护进程：

5.9 phpMyAdmin（可选）

必须安装 5.2.x，低版本与 PHP 8.1 不兼容。

软件商店 → 系统工具 → phpMyAdmin → 安装，选择 5.2.x 版本。
登录用 MySQL 账号密码，不是宝塔面板账号。
生产建议：改访问路径、加 IP 白名单，或用完停用。

5.10 Composer（部署代码时用）

宝塔一般已自带 Composer。使用时务必指定 PHP 8.1 绝对路径：

/www/server/php/81/bin/php /usr/bin/composer install --no-dev

面板"终端"里若直接敲 php 可能是旧版本，务必用绝对路径。

---

六、环境检查清单

部署业务代码前，确认以下全部完成：

• [ ] Nginx / MySQL 5.7.40 / PHP 8.1 / Redis 均为"运行中"
• [ ] PHP 扩展清单已勾齐；php -m 可见 pdo_mysql、gd 等
• [ ] 禁用函数已清理
• [ ] upload_max_filesize ≥ 50M，memory_limit ≥ 512M
• [ ] MySQL 已设 utf8mb4_general_ci
• [ ] Redis 已设密码；3306/6379 未对公网开放
• [ ] Supervisor 已安装
• [ ] 未在生产机安装 Node 做前端构建

---

七、阿里云特有注意点

---

八、常用宝塔命令

bt                  # 面板交互菜单
bt default          # 查看面板地址 / 用户名 / 密码
bt 14               # 查看面板错误日志
bt restart          # 重启面板
bt stop             # 停止面板
bt start            # 启动面板

卸载（慎用，会卸下面板相关组件，先备份）：

wget -O uninstall.sh http://download.bt.cn/install/bt-uninstall.sh && bash uninstall.sh

---

九、常见问题

装好面板后，不要在本机手工再装一套 PHP/Nginx，统一用宝塔"软件商店"管理版本与扩展。