宝塔面板不提供“一键安装hyperf”按钮，但可通过docker插件实现近似一键部署：先安装docker插件并启用容器管理，再准备hyperf项目代码挂载至服务器，接着创建容器（指定镜像、端口映射、卷挂载及启动命令php bin/hyperf.php start），最后配置nginx反向代理指向127.0.0.1:9501即可通过域名访问。
宝塔面板本身不直接提供“一键安装 Hyperf”的按钮，但通过 Docker 插件 + 可视化容器管理，可以实现接近“一键部署”的效果。Hyperf 是基于 Swoole 的高性能 PHP 框架，它依赖特定运行环境（PHP + Swoole + 扩展），不适合用传统 LNMP 方式部署，而 Docker 正是官方推荐的主流部署方式。宝塔恰好支持 Docker 图形化操作，让整个流程对新手友好。
安装 Docker 插件并启用容器管理
登录宝塔面板后，在左侧菜单进入软件商店，搜索“Docker”，点击安装。安装完成后，左侧会多出一个Docker图标。首次进入时，面板会自动初始化 Docker 服务。确认状态为“运行中”即可继续下一步。
准备 Hyperf 项目代码并挂载到服务器
你需要先在本地或服务器上准备好可运行的 Hyperf 项目（例如通过 composer create-project hyperf/hyperf-skeleton 创建）。然后将整个项目目录上传至服务器任意路径，比如 /www/wwwroot/hyperf-app。注意保持目录结构完整，尤其是 config/、runtime/ 和入口文件 bin/hyperf.php 都要存在。建议提前给 runtime/ 目录赋写权限：chmod -R 755 runtime。
创建并运行 Hyperf 容器
点击左侧Docker → 容器管理 → 创建容器，填写以下关键配置：
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
-
镜像名称：填
hyperf/hyperf:8.2-apache（根据你项目 PHP 版本选，常见有 8.1/8.2/8.3） -
容器名称：如
hyperf-prod -
端口映射：主机端口
9501→ 容器端口9501（Hyperf 默认监听 9501） -
卷映射（重要）：添加一条绑定挂载，主机路径选你上传的项目目录（如
/www/wwwroot/hyperf-app），容器路径填/var/www/html -
启动命令：填
php bin/hyperf.php start
提交后，容器会自动拉取镜像并启动。可在“容器列表”中查看状态是否为“运行中”，并点“日志”确认无报错（如找不到 config 或扩展缺失）。
配置反向代理让域名可访问
Hyperf 容器默认不暴露 80/443 端口，需通过 Nginx 反向代理接入。回到宝塔网站 → 添加站点（域名可填你备案好的域名或测试用二级域名），添加成功后点击该站点的设置 → 反向代理 → 添加反向代理：
- 代理名称：如 “hyperf-api”
-
目标URL：填
http://127.0.0.1:9501（注意不是容器 IP，而是宿主机本地转发） - 发送域名：留空或填你的站点域名
保存后，Nginx 会自动生成 proxy_pass 规则。此时访问你的域名，请求就会被转给本地 9501 端口的 Hyperf 服务。
补充建议：SSL 与进程守护
如果要用 HTTPS，在站点设置中点击SSL → Let's Encrypt → 申请，勾选“强制 HTTPS”即可生效。另外，Docker 容器默认重启策略为“no”，建议在创建容器时将重启策略设为“always”，避免服务器重启后服务中断。如需更精细控制（如健康检查、日志轮转），可在容器创建页切换到“高级设置”里配置。
