跳到主要内容

宝塔手动部署开源版

宝塔手动部署适合自己上传 jar 包，并在 /setup 页面完成数据库初始化的场景。

使用场景​

  • 宝塔的一键部署不满足你的服务器环境。
  • 你已经拿到了 surveyking.jar。
  • 你能接受按页面提示配置 Java 项目和 MySQL。
提示

如果你只是想快速部署，先看 宝塔一键部署。手动部署步骤更多，出错点也更多。

准备文件​

只需要准备一个文件：

文件下载地址用途
surveyking.jarhttps://download.surveyking.cn/files/surveyking.jar卷王应用程序

获取方式：

在本地浏览器打开下面地址下载：

https://download.surveyking.cn/files/surveyking.jar
注意

v1.12.0 不需要手动导入 init-mysql.sql。选择 MySQL 时，系统会在 /setup 页面自动初始化数据库。

QQ群文件

操作步骤​

1. 安装并打开宝塔面板​

如果还没有安装宝塔，可以从下面的链接进入宝塔官网安装：

宝塔服务器面板

安装完成后，保存宝塔面板地址、账号和密码。

宝塔面板地址

如果是云服务器，在云服务商控制台放行宝塔面板端口和卷王端口。

云服务器安全组

2. 安装 Java 项目环境​

进入 软件商店，搜索 java，安装 Java 项目一键部署。

安装 Java 项目一键部署

安装完成后，打开设置，在容器管理里安装 Tomcat 8。安装 Tomcat 时会一起安装 JDK。

安装 Tomcat 8

安装完成后，停止 Tomcat 服务。卷王使用 jar 方式运行，不需要 Tomcat 一直运行。

停止 Tomcat

3. 如果要用 MySQL，先创建空数据库​

如果你只是试用，可以跳过这一步，后面在 /setup 选择 H2 内置数据库。

正式使用建议安装 MySQL。进入宝塔左侧 软件商店，安装 MySQL，版本选择 5.7 或 8.0。

宝塔安装 MySQL

安装完成后，进入 数据库，初始化 MySQL root 密码。示例密码可以用 surveyking，正式使用建议换成更复杂的密码。

初始化 MySQL 密码

创建数据库，数据库名填写：

surveyking

创建数据库

注意

这里只创建空数据库，不要手动导入 SQL。第一次打开系统时，/setup 会自动初始化表结构和默认数据。

4. 上传 jar 并添加 Java 项目​

进入宝塔左侧 文件，新建一个目录，比如：

/www/wwwroot/surveyking

把 surveyking.jar 上传到这个目录。

上传 jar 文件

进入 网站 → Java 项目 → 添加 Java 项目。

需要填写：

配置项填写内容
项目 jar 路径选择刚上传的 surveyking.jar
项目端口1991，或你想使用的其他端口
运行用户root，避免上传文件时出现权限问题
提示

v1.12.0 不需要在项目执行命令里追加数据库参数。数据库连接信息在 /setup 页面填写即可。

添加 Java 项目

5. 打开 /setup 完成初始化​

浏览器访问：

http://服务器公网IP:1991

如果你设置了其他端口，把 1991 改成实际端口。

第一次打开会进入 /setup 页面。

  • 试用：选择 H2 内置数据库。
  • 使用宝塔 MySQL：选择 MySQL 数据库，部署方式选择 其他 MySQL 服务。

MySQL 信息按下面填写：

配置项填写内容
数据库地址localhost
端口号3306
数据库名称surveyking
用户名root 或你创建的用户
密码第 3 步设置的密码

然后按 初始化、备份和升级 填写系统信息并完成初始化。如果选择 MySQL，系统会自动重启，等一会再进入登录页。

6. 登录并修改密码​

初始化完成后，按 初始化、备份和升级 里的默认账号登录，并马上修改密码。

登录系统

你也可以进入系统设置，修改系统名称、图标等信息。

系统设置

常见问题​

为什么打开后进入 /setup，不是登录页？

这是 v1.12.0 的首次初始化页面。系统需要先确认你使用 H2 还是 MySQL。

按 初始化、备份和升级 完成初始化后，再访问系统就会进入登录页。

MySQL 初始化失败怎么办？

按顺序检查：

  • MySQL 版本是否为 5.7 或 8.0。
  • 数据库名是否是 surveyking。
  • /setup 里数据库地址是否填写 localhost。
  • 用户名和密码是否正确。
  • 宝塔 MySQL 服务是否正在运行。

不要再手动导入 init-mysql.sql，也不要在项目执行命令里追加旧版数据库参数。

手机为什么不能访问 localhost:1991？

localhost 只代表当前设备。手机输入 localhost，访问的是手机自己，不是服务器。

手机访问宝塔服务器时，使用：

http://服务器公网IP:1991

如果打不开，检查云服务商安全组、宝塔防火墙和项目端口。

项目启动失败，应该看哪里？

进入 网站 → Java 项目，找到卷王项目，查看项目日志。

优先看最后几行错误。常见错误是端口被占用、jar 路径选错、Java 环境没有安装好，或项目目录没有写入权限。

怎么升级？

先导出备份，再替换新版本 jar 或重新部署新版本。

具体步骤见：初始化、备份和升级。

获取帮助​

遇到 BUG 或需要新功能，可以通过下面的方式反馈：

如果你已经成功部署，也欢迎在 Gitee 仓库 给项目点 star。

Gitee star

最后于 更新