适用系统：CentOS7+/Ubuntu20.04+，默认后台端口8080，全程宝塔可视化操作，附带完整操作截图。

一、前置安全准备 云服务器后台安全组放行TCP 8080端口； 宝塔面板左侧【安全】-防火墙，添加放行8080端口； 提前下载QQBot Linux安装压缩包 qqbot-linux-amd64-vxxx-install.zip 到本地电脑。 二、创建专属部署目录 登录宝塔面板，左侧菜单栏点击【文件】； 进入根目录 /www 文件夹； 点击顶部【新建】→【新建文件夹】，命名为 qqbot。

（图1：进入/www目录，点击新建文件夹创建qqbot目录）

三、上传程序安装压缩包 双击进入刚创建的 /www/qqbot 空目录； 点击左上角【上传/下载】按钮； 选择本地zip安装包，点击【开始上传】等待上传完成。

（图2：qqbot空白目录，左上角上传按钮位置）

（图3：选中安装包后弹出上传窗口，点击开始上传）

四、解压安装包 上传完成后，勾选zip压缩包，点击右侧【更多】； 下拉菜单选择【解压】，解压到当前qqbot文件夹。

（图4：选中上传完成的压缩包，更多菜单点击解压）

（图5：解压完成，目录内出现install.sh等全部程序文件）

五、宝塔终端执行一键安装脚本 保持在 /www/qqbot 文件目录，点击顶部【终端】按钮； 终端自动进入当前目录，执行两条命令： bash 复制代码

添加脚本执行权限

chmod +x install.sh

运行一键安装脚本

./install.sh 等待脚本自动校验文件、配置系统服务、启动程序； 终端输出【服务启动成功】、给出访问地址 http://服务器IP:8080 即脚本部署完成。

（图6：解压完成页面顶部，点击终端按钮打开内置终端）

（图7：一键脚本自动部署完成，终端显示服务启动成功日志）

六、浏览器访问8080端口，进入QQBot安装向导第一步 浏览器输入 http://服务器公网IP:8080，首先进入环境检测页面：

步骤1：环境检测 页面自动校验目录权限与运行依赖，全部项显示【通过】后点击右下角【下一步】。

（图8：安装向导第一步环境检测，全部检测项通过，点击下一步）

七、（可选）域名反向代理配置（不用带8080端口访问） 宝塔左侧菜单栏点击【网站】； 切换顶部【反向代理】标签，点击绿色【添加反代】按钮； 域名填写已解析到服务器的域名；目标URL地址填写 http://127.0.0.1:8080；（不知道可尝试127.0.0.1:8080，建议以安装宝塔面板时显示的内网地址为准） 发送域名(host)填写你的域名，备注同域名，点击【确定】保存。

（图9：左侧点击网站，切换反向代理标签，点击添加反代）

（图10：反向代理弹窗填写域名、内网8080地址等代理参数）

八、宝塔面板提前创建MySQL数据库（安装向导前置必备步骤） 宝塔左侧菜单栏点击【数据库】分类； 点击绿色【添加数据库】按钮，弹出配置窗口； 数据库名、用户名统一填写 bot，密码设置为 botbotbot；（非固定，自由填写） 访问权限选择【本地服务器】，点击【确定】完成数据库创建。

（图11：宝塔左侧打开数据库页面，找到添加数据库按钮）

（图12：数据库弹窗填写bot库名、用户名、密码，确认创建）

九、QQBot安装向导剩余4步完整配置 步骤2：数据库配置 数据库类型选择 MySQL（生产推荐）； 主机地址：127.0.0.1，端口 3306； 用户名 bot，密码 botbotbot，数据库名 bot； 点击【测试连接】提示连接成功后，点击【下一步】。

（图13：填写本地bot数据库信息，测试连接成功后下一步）

步骤3：网站信息设置 网站名称默认：QQBot管理平台，可自定义修改； 网站描述按需填写，服务端口固定8080无需改动； 确认信息后点击【下一步】。

（图14：自定义网站名称与描述，端口保持8080）

步骤4：管理员账户创建 用户名默认admin，可自定义； 填写管理员邮箱、登录密码（至少8位，大小写+数字）； 重复输入确认密码，点击【下一步】。

（图15：设置后台管理员登录账号、邮箱与登录密码）

步骤5：授权验证并完成安装 输入购买获取的授权码，点击【验证授权】； 提示授权有效后，查看底部安装摘要核对数据库、管理员信息； 确认无误点击【开始安装】，等待程序初始化完成即可登录后台。

（图16：授权验证初始空白页面，输入授权码后验证）

（图17：授权验证成功，核对安装摘要后点击开始安装）

常用服务管理命令（宝塔终端内执行） 查看运行状态：

systemctl status qqbot

查看运行日志：

journalctl -u qqbot -n 200 --no-pager

重启服务：

systemctl restart qqbot

十、常见问题排查

1. 无法打开8080页面 检查云服务商安全组、宝塔防火墙均放行8080端口； 终端执行 ss -tulnp | grep 8080 确认程序正常监听端口。

2. 脚本提示权限不足报错 备用运行命令：bash install.sh，无需手动授权即可直接执行脚本。

3. 端口8080被其他程序占用 修改程序配置更换监听端口，或关闭占用8080的进程后重新执行安装脚本。

4. 数据库连接失败 核对数据库名、用户名、密码是否和宝塔创建的完全一致； 确认数据库访问权限为本地服务器，127.0.0.1本地可正常连接。 本教程由@daiyu 提供，感谢支持