快速开始

在线尝试

可以直接在 SurveyForm 上进行在线尝试。

也可以通过 一键部署 几分钟就可以完成部署，直接部署在本机上。

源码安装

前置准备

当前最新版本：DWSurvey 社区版 V6.13

通过 GIT 下载源码

前端下载

$ git clone https://gitee.com/wkeyuan/DWSurvey.git

后端下载

$ git clone https://gitee.com/wkeyuan/dwsurvey-vue.git

如果对您有帮助，请点亮 调问源码仓库 右上角 Star🌟，支持我们继续迭代产品！

前端环境

• Node.js 18 及以上版本。
• 开发工具推荐 Visual Studio Code

后端环境

• JDK 1.8
• MySQL 8.0 及以上版本
• ElasticSearch 8 及以上版本 （可选），不安装 Es 的影响
• Redis 5.0 及以上版本（可选），不安装 Redis 的影响
• 开发工具推荐 IntelliJ IDEA

编译启动

启动前端

1. 进入前端下载的项目目录 dwsurvey-vue 运行安装依依赖

npm

$ npm install

pnpm

$ pnpm install

yarn

$ yarn install

yarn (pnp)

$ yarn install

bun

$ bun install

2. 继续执行启动命令

npm

$ npm run dev

pnpm

$ pnpm install

yarn

$ yarn install

yarn (pnp)

$ yarn install

bun

$ bun install

3. 打开浏览器输入如下

浏览器打开

$ http://localhost:5173

浏览器能打开登录页面表示已经编译启动成功

注意

调问前端默认配置连接了一个官网 DEMO 服务，后端安装完成请修 config/index.js 里面的代理地址为本地服务地址。更多详情请参考 调问 故障排除指南。此外，此配置只影响开发环境。

修改后端配置

进入前端下载的项目目录 dwsurvey 修改配置

MYSQL 连接信息

src/main/resources/application-dev.yml

$ mvn package

启动应用

命令行方式启动

如果有 mvn 环境可以直接输入编译打包命令

1. 编译 dwsurvey 后端源码

maven

$ mvn package

2. 启动 dwsurvey 后端服务

进入编译后的目录

TIP

当前命令行目录位置，应在 dwsurvey 项目根目录下，其目录下包括 src,target 目录与 pom.xml 文件

cd target

命令行启动

$ java  -Dfile.encoding=utf-8 -jar dwsurvey-oss-vue-v.*.*.jar --spring.profiles.active=prod --server.port=8080 --spring.datasource.username=root --spring.datasource.password=123456

参数说明

dwsurvey-oss-vue-v.6.*.jar 替换成你真实的 jar 包名称

• --spring.profiles.active=prod #关联的配置文件
• --server.port=8080 #端口
• --spring.datasource.username=root #MYSQL 数据库用户名
• --spring.datasource.password=123456 #MYSQL 数据库密码

具体配置文件位置 src/main/resources/application.yml ，更多配置请参考 后端配置。

IntelliJ IDEA 方式

如果使用 IntelliJ IDEA 已经打开项目，也可以通过其集成环境完成，如图所示。

1. 编译 dwsurvey 后端源码

2. 启动 dwsurvey 后端服务

修改前端配置

社区版

本地开发环境只需修改 config/dev.env.js dev.proxyTable.target 为实际后端地址

TIP

如果后端也是本机环境，默认端口就是 8080，所以对应地址就是

 target: "http://localhost:8080/"

config/dev.env.js

"use strict";
// Template version: 1.3.1
// see http://vuejs-templates.github.io/webpack for documentation.

const path = require("path");

module.exports = {
  dev: {
    // Paths
    assetsSubDirectory: "static",
    assetsPublicPath: "/",
    proxyTable: {
      "/api": {
        target: "http://localhost:8080/", // 本地开发环境只需要修改这个配置，修改为后端服务地址即可 //
        changeOrigin: true, //如果需要跨域
        pathRewrite: {
          "^/api": "/api",
        },
      },
    },
    ...
  },
  ...
};

企业版

config/.env.development

/**
 * 注意：开发环境不需要修改这里
 * 只需要修改 vite.config.js server.proxy.target 地址为后端地址
 */
NODE_ENV = "development";
VITE_DW_API_URL = "http://localhost:5173";
VITE_DW_WEB_URL = "http://localhost:5173";
VITE_DW_RESOURCE_URL = "http://localhost:5173";

TIP

修改完成后重新启动前端应用测试

至此服务应该会运行在 http://localhost:5173 上。

在浏览器中访问 URL 以查看新站点的运行情况吧！

http://localhost:5173

默认账号密码

service@diaowen.net

123456

下一步

• 想要进一步了解 DWSurvey 文件是怎么部署，请继续阅读一键部署。

• 要了解有关基于 DWSurvey 二开更多信息，例如 API、新组件，请参见指南的“API”部分。

• 要探索系统怎么操作使用，例如一些功能细节，特色功能等，请查看帮助。一个很有用的功能DSL 建议可以先阅读说明了解下。

• 如果想进一步自定义站点的外观，参见扩展默认主题