离线安装宝塔面板可行,包括预下载资源本地部署和Docker镜像构建两种方案:前者需在同系统联网机下载脚本、离线包及依赖并修改install.sh;后者通过构建含全部组件的Docker镜像后导入内网运行。

如果您的虚拟机处于内网环境,无法直接访问互联网,则无法通过常规方式在线安装宝塔面板。以下是针对该限制条件的多种离线安装可行性方案:
一、预下载安装脚本与依赖包后传输至内网
该方法基于宝塔官方安装脚本的可移植性,提前在可联网机器上完整获取安装所需全部资源,再拷贝至内网虚拟机执行。关键在于保留脚本调用逻辑与所有远程依赖的本地化替代。
1、在一台具备相同操作系统版本(如 CentOS 7.9 或 Ubuntu 20.04)且可联网的机器上,执行宝塔官方安装命令前先拦截其下载行为,或使用 wget --mirror 模拟抓取脚本及关联资源路径。
2、手动下载宝塔官网提供的离线安装包(如 bt_7.9.0_all.tar.gz),该包已包含核心面板文件、Python 运行时及基础 Web 服务组件。
3、将离线包、修正后的 install.sh 脚本(需注释掉所有 curl/wget 外网请求行,并替换为本地路径读取)、以及系统级依赖 RPM/DEB 包(如 python3-pip、libcurl、openssl-devel 等)统一打包为 tar.xz 文件。
4、通过 USB 设备或内网共享方式将压缩包传入虚拟机,解压后进入目录,赋予 install.sh 执行权限:chmod +x install.sh。
5、运行修改后的安装脚本:./install.sh,脚本将跳过网络检测,直接解压并部署本地资源。
二、基于 Docker 镜像构建离线运行环境
该方案绕过传统 Linux 系统级安装流程,利用 Docker 将宝塔面板及其依赖封装为静态镜像,在内网虚拟机中仅需 Docker 引擎即可启动,不依赖外部仓库拉取。
1、在可联网主机上安装 Docker,拉取一个轻量基础镜像(如 alpine:3.18 或 centos:7)。
2、依据宝塔官方 GitHub 开源的 Dockerfile(如有)或自行编写构建脚本,将面板前端静态文件、后端 Python 服务、Nginx 配置模板、数据库初始化脚本等一并 COPY 进镜像。
3、在构建过程中使用 ADD 指令将预下载的 bt-static.tar.gz 和 python3.9.tgz 等离线资源包注入镜像,并在 RUN 指令中完成解压与路径注册。
4、执行 docker build -t bt-offline:7.9 . 构建本地镜像,随后导出为 tar 文件:docker save bt-offline:7.9 > bt-offline-7.9.tar。
5、将该 tar 文件复制进内网虚拟机,导入镜像:docker load ,再运行容器并映射端口:docker run -d -p 8888:8888 -p 8889:8889 --privileged bt-offline:7.9。
三、使用 Ansible Playbook 实现无网节点批量部署
适用于拥有多个内网虚拟机且需统一管理的场景。Ansible 控制节点预先缓存全部安装资产,通过 SSH 推送执行,全程不触发目标机任何外网连接。
1、在控制机上创建 ansible-offline-bt 目录,将宝塔离线安装包、自定义 handlers.yml(处理 service 启停)、templates/(存放 nginx.conf.j2 等模板)全部放入 files/ 子目录。
2、编写 site.yml 主任务文件,在 tasks 中使用 unarchive 模块解压 bt_7.9.0_all.tar.gz 到 /www/server/,并用 copy 模块覆盖默认配置项,禁用自动更新检查。
3、在 vars/main.yml 中明确定义所有路径变量,例如 bt_install_dir: "/www"、python_bin: "/usr/bin/python3",确保与目标系统实际环境一致。
4、生成 inventory 文件,列出内网虚拟机 IP 及 SSH 认证方式(如密钥路径),并关闭 gather_facts 的远程探测行为:gather_facts: false。
5、执行离线部署命令:ansible-playbook -i inventory site.yml --connection=ssh,Playbook 将仅使用本地文件完成全部操作。
四、精简版手动部署:仅启用核心功能模块
当内网虚拟机资源极其有限(如仅 1GB 内存、1 核 CPU)时,可跳过宝塔图形安装器,直接提取其最小可用组件集进行手工集成,避免冗余服务占用。
1、从宝塔官网下载“极速安装包”(通常为 bt_minimal_7.x.zip),该包不含 PHP、MySQL 等大型组件,仅含面板主程序、基础 Nginx 和 Python WSGI 支持。
2、解压后进入 panel/ 目录,编辑 config.json,将 update_check 设为 false,web_port 改为非冲突端口(如 8081),并设置 login_path 为自定义入口路径。
3、执行 python3 /www/server/panel/BT-Panel.py start 启动服务进程,而非运行 install.sh。
4、使用 firewall-cmd 或 ufw 开放指定端口:firewall-cmd --permanent --add-port=8081/tcp,随后重载规则。
5、验证面板是否响应:curl -I http://127.0.0.1:8081,返回 HTTP/1.1 200 OK 即表示核心服务已就绪。










