宝塔Linux面板从入门到项目部署实战

宝塔面板（BT Panel）是国内使用最广泛的服务器运维管理面板之一。它的核心价值在于，把原本需要手动敲命令完成的 Linux 运维操作，转化为直观的网页图形界面。即使你不熟悉 apt、nginx -t、systemctl 这些命令，也能通过点击完成环境搭建、网站创建、数据库管理和项目部署。这篇教程会从零开始，带你认识宝塔、完成安装配置，并分别演示 Java、Node.js、Python、PHP 项目的部署方法，最后补上安全加固和常见问题的排查思路。

宝塔官网

一、宝塔面板是什么，适合谁用

宝塔面板把服务器上最常用的运维操作做成了可视化界面，核心功能包括：一键安装 Nginx / MySQL / PHP / Redis 等环境（LNMP/LAMP）、创建网站并绑定域名、管理数据库、在线编辑文件、申请免费 SSL 证书、设置计划任务、查看服务器负载和日志。

它特别适合以下场景：个人开发者不想在环境配置上耗费过多时间；小型团队没有专职运维，需要快速上线项目；传统企业将内部系统迁移到云服务器，希望降低管理门槛。需要注意的是，宝塔管理的是服务器本身的 Web 环境，如果你已经习惯用 Docker 编排一切，宝塔的 Docker 模块同样可用，但纯 Docker 工作流未必需要面板介入。

二、安装宝塔面板

2.1 服务器要求

安装宝塔 Linux 面板，服务器最低配置为 1 核 512M 内存，推荐 1 核 1G 及以上。必须使用全新纯净的 Linux 系统，如果服务器上已经存在 Apache、Nginx、PHP、MySQL 等 Web 环境，安装时会产生冲突。系统推荐 Debian 12、Ubuntu 22 或 CentOS 7。

在安装之前，需要在云服务商的安全组（或服务器自带防火墙）中提前放行以下端口：22 （SSH）、8888 （宝塔面板默认端口）、80/443 （网站访问）、3306（数据库，按需放行）。安全组不放行端口是新手最容易踩的坑------面板装好了却打不开，往往就是这一步遗漏了。

2.2 执行安装脚本

用 SSH 工具（如堡塔 SSH 终端、Xshell、FinalShell）连接服务器，根据系统类型执行对应命令。

CentOS：

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

Ubuntu / Debian：

wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

通用新版脚本（推荐）：

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

脚本执行后会提示 Do you want to install Bt-Panel to the /www directory now?(y/n)，输入 y 回车，等待自动安装完成。安装结束后，终端会显示面板的访问地址、用户名和密码，务必妥善保存。

2.3 首次登录与环境初始化

浏览器打开 http://服务器IP:8888，用终端中显示的账号密码登录。首次进入面板，会提示选择安装 Web 环境。新手推荐选择 LNMP（Nginx + MySQL + PHP），MySQL 版本按项目需求选择（5.7 或 8.0），PHP 选择 7.4 或 8.0 均可。点击一键安装后等待约 10 分钟，期间不要关闭页面。

如果服务器是阿里云轻量应用服务器或腾讯云轻量服务器，也可以直接在购买时选择"宝塔面板"应用镜像，省去手动安装步骤。

三、宝塔面板核心功能速览

登录面板后，左侧菜单是日常操作的主入口。几个最常用的模块：

网站：创建站点、绑定域名、设置伪静态、配置反向代理、申请 SSL 证书。PHP 项目在这一栏下的"PHP 项目"中创建；Java/Node/Python 项目则分别在对应的子菜单中管理。

数据库：创建数据库、导入导出 SQL、修改密码，支持 phpMyAdmin 在线管理。

文件 ：在线浏览 /www/wwwroot/ 目录（宝塔的默认建站根目录），上传、下载、解压、编辑文件，相当于一个网页版的文件管理器。

软件商店：安装各种运行环境和插件，如 Nginx、MySQL、Redis、Node 版本管理器、Python 项目管理器、Docker 管理器、PM2 等。

安全：管理防火墙端口、查看登录日志、设置 SSH 端口修改等。

计划任务：定时备份网站和数据库、定时执行 Shell 脚本或访问 URL。

四、部署前的通用准备（所有项目通用）

无论部署什么语言的项目，有几个步骤是共通的，提前做好可以避免大部分"打不开"的问题。

4.1 上传项目文件

通过左侧"文件"菜单进入 /www/wwwroot/，点击"上传"把项目压缩包传上去，然后右键解压。也可以使用 FTP/SFTP 工具上传。建议每个项目在 /www/wwwroot/ 下使用独立目录，目录名与域名或项目名对应，便于后续管理。

4.2 创建数据库（如项目需要）

进入"数据库" → "添加数据库"，填写数据库名、用户名和密码。如果项目自带初始化 SQL 文件，在数据库列表中找到刚创建的库，点击"导入"上传 SQL 文件即可。之后记得在项目的配置文件中修改数据库连接信息（地址通常填 127.0.0.1，库名、用户名、密码对应宝塔中创建的值）。

4.3 放行应用端口

如果项目监听的是非 80/443 端口（如 Spring Boot 的 8080、Node 的 3000、Gunicorn 的 8000），需要同时在宝塔面板的"安全" 和云服务商的安全组中放行该端口。两处都放行才算真正开放，漏掉任何一处，外部都无法访问。

五、分语言部署实战

5.1 Java（Spring Boot / Jar 包）部署

Spring Boot 项目内置了 Tomcat 容器，只需要 JDK 环境即可运行 Jar 包，不需要额外安装 Tomcat。

第一步：安装 JDK。 进入"网站" → "Java 项目" → "Java 环境管理"，选择项目需要的 JDK 版本（1.8、11、17 等）点击安装。这种方式由宝塔统一管理，比手动配置环境变量更省事。

第二步：上传 Jar 包。 将 Spring Boot 项目打包为 .jar 文件，通过"文件"菜单上传到 /www/wwwroot/你的项目目录/。

第三步：添加 Java 项目。 进入"网站" → "Java 项目" → "添加 Java 项目"。项目类型选择 "Spring Boot 项目"，项目路径选择上传的 Jar 包，JDK 版本选择已安装的版本，填写应用端口（如 8080）。提交后宝塔会自动启动项目。

第四步：配置 80 端口访问（可选）。 如果希望通过域名或 IP 直接访问（不带端口号），需要先安装 Nginx，然后在 Java 项目的设置中配置"外网映射"，将 80 端口的请求转发到应用端口。

5.2 Node.js 项目部署（以 Next.js / Express 为例）

宝塔对 Node.js 项目的支持比较完善，推荐使用 Node 版本管理器 + PM2 守护的方式。

第一步：安装 Node 版本管理器。 进入"软件商店"，搜索"Node 版本管理器"并安装。打开后选择项目所需的 Node.js 版本（推荐 v18 LTS 或更高）进行安装，并在"网站" → "Node 项目"中设置命令行使用的 Node 版本。

第二步：上传项目并安装依赖。 将项目上传到 /www/wwwroot/项目目录/，在宝塔终端中进入该目录，执行 npm install（或 yarn install / pnpm install）安装依赖。如果需要构建（如 Next.js），执行 npm run build。

第三步：添加 Node 项目。 进入"网站" → "Node 项目" → "添加 Node 项目"，填写项目名称、项目路径，启动文件或启动命令按项目实际情况填写（如 Next.js 可填 node_modules/next/dist/bin/next，启动命令 start -p 3000），端口填应用监听的端口，Node 版本选择已安装的版本。提交后项目会自动启动。

第四步：配置外网映射。 在 Node 项目列表中点击"设置"，找到"外网映射"，开启后将外网端口设为 80（HTTP）或 443（HTTPS），内网端口填应用端口（如 3000），保存后即可通过域名或 IP 直接访问。

补充： 如果你的 Node 项目使用 PM2 作为进程管理器，也可以在"软件商店"安装 PM2 管理器，在 PM2 中启动项目并设置守护，效果类似。

5.3 Python（Flask / Django）项目部署

这是宝塔部署中最需要手动配置 的一类，因为宝塔不提供 Python Web 应用的"一键部署"按钮。正确的架构是：Flask/Django 应用 → Gunicorn（WSGI 服务器） → Nginx（反向代理） → 用户访问 。直接在生产环境运行 python app.py 或 python manage.py runserver 会导致进程不稳定、性能极差，不推荐。

第一步：安装 Python 环境。 进入"软件商店"，搜索"Python 项目管理器"并安装。在其中安装与开发环境一致的 Python 版本（推荐 3.8+）。

第二步：上传项目并创建虚拟环境。 将项目上传到 /www/wwwroot/项目目录/，在宝塔终端中进入该目录，执行：

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install gunicorn

虚拟环境可以把项目依赖与系统 Python 隔离，避免版本冲突。

第三步：创建站点并配置反向代理。 进入"网站" → "添加站点"，域名填你的域名（无域名可暂填服务器 IP），运行环境选择"纯静态"或禁用 PHP。创建完成后，进入该站点的"设置" → "反向代理" → "添加反向代理"，目标 URL 填 http://127.0.0.1:8000，保存。

第四步：启动 Gunicorn。 在虚拟环境中执行启动命令。Flask 项目：

gunicorn -w 4 -b 127.0.0.1:8000 --chdir /www/wwwroot/项目目录名 主文件名:app

Django 项目：

gunicorn -w 4 -b 127.0.0.1:8000 --chdir /www/wwwroot/项目目录名 项目名.wsgi:application

-w 4 表示 4 个工作进程，-b 127.0.0.1:8000 绑定本地端口，--chdir 指定项目根目录。

第五步：处理静态文件（Django 必做）。 Django 的静态文件不由 Python 进程处理，需要 Nginx 直接服务。先在终端执行 python manage.py collectstatic --noinput，然后在站点的 Nginx 配置中添加 location /static/ { alias /www/wwwroot/项目目录/staticfiles/; }，路径与 STATIC_ROOT 保持一致。

第六步：配置进程守护（Supervisor）。 Gunicorn 进程在 SSH 断开后可能会退出，需要用 Supervisor 将其变为守护进程。在"软件商店"安装"Supervisor 管理器"，添加守护进程，启动命令填 Gunicorn 命令，运行目录填项目目录，即可实现开机自启和异常自动拉起。

5.4 PHP 项目部署

PHP 是宝塔原生支持最好的技术栈，部署最简单。

第一步：创建站点。 进入"网站" → "PHP 项目" → "添加站点"，填写域名（支持多个域名换行，也支持泛域名 *.example.com），根目录默认为 /www/wwwroot/域名，PHP 版本按项目要求选择（如 8.0/8.2）。在同一个表单中可以选择是否同时创建 FTP 账号和数据库。

第二步：上传项目并配置。 将 PHP 项目文件上传到站点根目录，如果项目使用 Composer，在终端进入项目目录执行 composer install。然后根据项目文档配置数据库连接、伪静态规则（宝塔站点设置中有常见程序的伪静态模板）等。

第三步：绑定域名和 SSL。 在站点设置中绑定域名（如果创建时没填），进入"SSL"选项卡，可以一键申请 Let's Encrypt 免费证书，开启 HTTPS。

六、安全加固建议

面板和服务器上线后，花 10 分钟做几项安全设置，能显著降低风险。

修改面板端口和安全入口。 默认的 8888 端口是公开已知的，建议在"面板设置"中改为一个高位随机端口（如 28643），并保持安全入口（一个随机路径）开启，这样即使有人扫描到端口，也不知道入口地址。

启用面板 SSL 和域名绑定。 在"面板设置" → "SSL"中为面板开启 HTTPS，避免登录密码在传输中被截获。如果服务器有域名，可以在"面板设置"中绑定域名，之后只能通过域名访问面板。

修改默认 SSH 端口并限制来源 IP。 如果条件允许，将 SSH 的 22 端口改为其他端口，并在安全组中限制 SSH 的来源 IP 为你的常用 IP，减少暴力破解的风险。

定期查看日志和更新面板。 宝塔的"安全"模块会记录登录日志和操作日志，定期检查有无异常 IP。同时保持面板版本更新，官方会修复已知漏洞。

七、常见问题排查速查

部署失败时，按以下顺序排查，可以解决大部分问题。

网站打不开，但面板正常。 第一检查安全组和宝塔防火墙是否都放行了网站端口（80/443 或应用端口）；第二检查 Nginx 是否正常运行；第三查看站点错误日志（站点设置 → 日志），常见原因是权限问题或伪静态规则错误。

Node/Java 项目显示"运行中"，但访问 502。 应用进程可能已经挂了，只是面板显示不准确。在终端执行 ps aux | grep 进程名 检查进程是否真实存在，然后查看应用自身的日志（Node 看 PM2 日志或项目日志，Java 看项目目录下的日志文件）。80% 的情况是启动命令路径写错、端口冲突，或 .env 文件未正确读取。

Python 项目 502 或静态文件 404。 先检查 Gunicorn 是否在 127.0.0.1:8000 正常监听（curl http://127.0.0.1:8000）。静态文件 404 说明 Nginx 的 location /static/ 配置与 Django 的 STATIC_ROOT 路径不一致，或者忘记执行 collectstatic。

数据库连接失败。 检查项目配置中的数据库地址是否为 127.0.0.1，库名/用户名/密码是否与宝塔中创建的一致。如果应用和数据库不在同一台服务器，还需要在宝塔数据库设置中开启远程访问并放行 3306 端口。

宝塔面板把服务器运维的门槛降到了"会用浏览器就能管理"的程度，但它本质上是一个工具，理解背后的运行逻辑（Web 服务器、应用进程、反向代理、进程守护）仍然重要。部署项目时，建议先用一个简单项目走通"上传 → 启动 → 反向代理 → 外网访问"的完整链路，再部署复杂项目，遇到问题时根据日志定位，而不是反复重装面板。