大家好，我是聪明积极的小象。

最近，有收到一些用户给 datart 团队的留言或反馈，即他们在安装部署的过程中遇见一些问题，不知道怎么解决。

小跑象通过分析这些问题，整理出一套常见部署问题教程，希望帮助更多的用户快速上手部署安装，少走弯路。

插播介绍一下，数据可视化应用 datart，其本身的团队是由 DBus、Wormhole、Moonbox、Davinci 等四大开源项目研发的主创人员组成，在基础平台研发、数据中台建设和数据应用等方面，妥妥滴大佬啊。

datart 是开源的，也就是免费使用的数据可视化应用，有需要的搜一下跑象（公众号），关注找小编，就可以免费使用了，有技术支持，小白都会用的开源数据可视化应用。

好了，言归正传

datart 常⻅部署问题可以归纳为两种：使用安装包部署问题和使用源码部署问题。

使⽤安装包部署的常⻅问题

1. 为什么在配置⽂件中进⾏了 mail 部分配置，仍然提示“邮件发送服务不可⽤，检查 config/application- config.yml，确保邮件配置正确”？

检查 application-config.yml 中 email 属性配置部分的缩进，mail 要和上⾯的 datasource 对⻬，且 mail 下⾯的⼦属性要严格保持原有的的缩进。

2. 正确配置了邮件，发送时没有提示“检查 config/application-config.yml”等信息，⽽是邮件发送失败，控制台打印错误⽇志。

这种情况是配置⽂件格式正确，但是配置内容有误。可能有以下⼏类常⻅原因：

• SSL 问题
  
  ssl 需要邮件服务⽀持的情况下才能设置为 true，否则设置为 false。开启或关闭 ssl 时，对应端⼝号不同（参照 http://running-elephant.gitee.io/datart-docs/docs/#3-3-%E9%82%AE%E4%BB%B6%E6%9C%8D%E5%8A%A1%E9%85%8D%E7%BD%AE-
  %E5%8F%AF%E9%80%89）
• password 问题
  
  password 是邮箱服务密码，需要注意的是常⻅免费邮箱（如 163 邮箱、QQ 邮箱、gmail 等）这⾥应填客户端独⽴密码，可前往对应邮箱账号设置⻚⾯开启 SMTP 服务，并申请客户端授权码（或独⽴密码，各邮箱提供商叫法不同）。

3. 应⽤内中⽂为乱码

在 application-config.yml 中，数据库的连接串中加上 characterEncoding=utf-8

4. server.address 与 datart.server.adddress 区别

server.address 是⽤于指定应⽤绑定的 IP 地址，这个 IP 地址必须是应⽤部署服务器的其中⼀个⽹卡的 IP 地址；如果要绑定到全部⽹卡，则填写 0.0.0.0 datart.server.address 是⽤于配置外部访问 datart 时的请求地址，如 http://192.168.0.10:8080；发送

⽤户激活/邀请邮件时，邮件中的链接就是 http://192.168.0.10:8080/xxxxx

5. 如何使⽤ docker 部署

可以⽤安装包内的 Dockerfile 在本地构建 docker 镜像

⾸先在安装包根⽬录执⾏以下命令

镜像构建完成以后，在 config ⽬录下修改好配置⽂件，然后运⾏以下命令

6. 邮件可以不配置么？

可以，在config/application-config.yml 中，设置 datart.user.active.send-mail 为 false， 在⽤户注册时，会跳过邮件认证步骤。此时在组织邀请⽤户时，需要把邮件确认取消勾选；且定时任务中的邮件发送功能不可⽤。

7. 默认⽤户名和密码是什么

datart 没有默认⽤户，安装后⾃⾏注册

8. 安装包如何升级

升级时，⼀定要把安装包解压到⼀个全新的路径下，不能直接覆盖原有⽂件。然后把旧项⽬的 config ⽂件夹和 files ⽂件夹复制到新的安装路径下即可。

使⽤源码部署的常⻅问题

1. 部署步骤是怎样的

• 准备环境：JDK1.8 以上，Maven 最新版本，Mysql5.6 以上，NodeJS 环境 12.20.0 以上，Datart 最新版源码
• 把 bin/datart.sql 导⼊数据库，并配置 config/application-config.yml ⽂件
• 在项⽬根⽬录下执⾏ mvn compile，会⾃动下载前后端依赖并编译前后端代码，⽣成项⽬所需⽂件
• 运⾏ datart.DatartServerApplication，启动应⽤，然后就可以在浏览器访问http://127.0.0.1:8080

2. datart.data.provider.calcite.parser.impl.SqlParserImpl 找不到

这个⽂件是编译后⽣成的，在项⽬根⽬录下执⾏ mvn compile 会⾃动⽣成。不要引⽤org.apache.calcite.sql.parser.impl.SqlParserImpl

3. parser.js 找不到

这个⽂件是前端编译后⽣成的，在项⽬根⽬录下执⾏ mvn compile 会⾃动⽣成

以上就是小跑象整理出来的安装部署问题教程，小伙伴们觉得有用的话，记得要点赞、关注、转发三联哦~ 

也可以直接加入我们的开源社群