BShost

BShost 是一款基于Ruoyi开发的 Spring Boot 3 + Vue 3 的宝塔虚拟主机管理系统，提供后台管理、OpenAPI 接入和用户自助 Portal面板。 如果您喜欢本项目，欢迎点一个Star。

作者

Carrey 快速联系 QQ：1580128384

功能概览

• 宝塔虚拟主机全生命周期管理：通过调用宝塔底层API，实现套餐、实例、开通、暂停、恢复、销毁等功能
• OpenAPI 对接：API Key + IP 白名单，支持财务/主控/代理系统调用
• Portal 面板自助：重新设计的现代化简约风面板，提供登录、站点配置、文件管理、上传/下载/压缩/解压等虚拟主机功能，提供高效的可视化建站能力
• 后台系统管理：API管理、服务器监控、虚拟主机实例管理
• 前后端分离：Spring Boot 3 + Vue 3

技术栈

• Java 17 / Spring Boot 3 / Spring Security / JWT
• MyBatis + PageHelper + Druid
• Redis
• Springdoc OpenAPI
• Vue 3 + Vite + Element Plus

项目结构

目录	说明
admin	Spring Boot 入口与 Web 层控制器
framework	安全、配置、拦截器、切面等基础能力
system	系统模块领域、服务与 Mapper
common	通用工具、常量、异常与基础模型
vhost	虚拟主机业务、OpenAPI、宝塔对接、Portal面板服务
BShostVue	前端工程 (管理端 + Portal面板)

快速开始

• Wiki-快速开始

快速在生产环境中使用(推荐基于宝塔面板配置)

• Wiki-快速在生产环境中使用

OpenAPI 对接

• 文档：Wiki-API_Doc
• 基础路径：/openapi/vhost
• 鉴权方式：Authorization: Bearer <prefix.token> (API Key 在后台生成，支持 IP 白名单)
• 典型接口：/create、/suspend、/unsuspend、/delete

Portal 说明

• 登录：POST /portal/login (使用ftpUsername + ftppassword完成登录)
• 鉴权：Authorization: Bearer <portalToken>
• 能力范围：站点概览、PHP 版本、伪静态、SSL、域名管理、文件管理

其他说明

• 日志默认输出到 ./logs。

演示说明