全新安装说明

获取部署程序

近期发现部分用户在公网环境下部署的触达云屏未修改默认密码，有安全隐患。

安全隐患排查通知

警示：为了您的数据安全，请广大用户在部署和使用触达云屏时，数据库和系统账号切记设置复杂一点的密码。

触达云屏私有部署，软件包下载链接如下（速度快）：
链接： https://www.123pan.com/s/nJQbVv-K148A.html
提取码:VMMM

（123网盘最新限制需要用户登录才可以下载，如您不想注册123网盘帐号（建议网盘下载，速度快），可以点击这里联系我们扫码加QQ交流群，在群文件中下载）

目录名称	目录说明
0-基础软件包	c++运行时软件、mysql数据库、jdk、数据库管理工具等基础软件包
1-触达云屏[版本号]	触达云屏私有部署程序包必须下载，（0.集成安装包-推荐使用文件夹内的 app.zip 文件）
2-触达云屏客户端	windows、Andriod 客户端
3-大屏模板、设计资源	共享免费的模板和设计资源
999-老版本逐级升级到最新版	逐级升级的数据库脚本。逐级升级主要是数据库，应用请按照全新安装的步骤进行覆盖安装。

集成部署包，集成了：Mysql5.7 数据库、jdk1.8、触达云屏集成部署程序（管理端和设计器），一键安装启动数据库、一键启动触达云屏。
特别注意：首次使用集成部署包，请按照文档中描述的目录结构部署，减少不必要的异常问题。如想安装到其他目录，请参考如何变更部署目录

如果你精通Java、Nginx、Mysql数据库等的安装部署和使用以及熟悉 Linux 运维，可以参考文档专业用户-全新安装说明进行部署。
功能上和集成部署包功能完全一致，非精通请勿尝试。

有任何想法和需求，欢迎点击这里联系我们 交流沟通。

安装部署

Windows环境部署

将下载好的 app.zip 文件拷贝到 E盘根目录（如果没有E盘可拷贝到其他盘的根目录下）
鼠标右击 app.zip 文件，选择解压到 app目录 ,解压后的文件内容如下图所示
一键安装数据库：
进入到目录 E:/app/chudy_mysql5.7_winx64
鼠标右击 1_install_mysql_5.7.bat ，选择以管理员身份运行

默认数据库端口：3309 ，帐号 root 密码空
如安装数据库遇到类似如下图所示的提示，请到网盘 0-基础软件包/windows_c++库文件夹下，下载 c++运行时软件，按照年份顺序逐一安装，然后再次执行安装脚本。

如果要用自己本地已经有的mysql数据库(5.7+),按如下步骤：

a.创建数据库：chudy_datav（数据库名称可以自己指定，后面配置文件中配置正确即可）字符集：utf8_general_ci
b.使用数据库管理工具执行初始化脚本：/app/chudy_visual_[版本号] /doc 目录下的SQL脚本
c.修改配置文件：/app/chudy_visual_[版本号] /mgr/config 目录下的 application-dev.properties，按需修改数据库端口、名称、帐号、密码等信息。
一键启动管理后台
进入到目录 E:/app/chudy_visual_[版本号]_0/mgr
鼠标双击 start_0.bat
访问系统
在浏览器中输入网址：http://127.0.0.1:8088
登录帐号 sadmin 密码 111111

如果无法访问，请检查服务器防火墙是否开放8088端口。
异常问题反馈
如无法访问或使用过程中提示异常信息，可以向我们提供日志文件，协助分析。
日志文件所在目录默认是 /app/logs

安装为系统服务

使用 nssm工具将我们的应用安装为系统服务。
下载地址：http://www.nssm.cc/download
使用说明：http://www.nssm.cc/usage

简要步骤：
1，CMD命令窗口中，cd到nssm.exe所在目录

2，执行 nssm install chudy_visual_cms 命令，会弹出如下所示的配置界面
配置安装 mgr目录下的 start_0.bat

安装后，首次需要手动启动服务

NSSM常用命令

安装服务：nssm install 服务名
删除服务：nssm remove 服务名
删除服务确定：nssm remove 服务名 confirm 
修改服务（显示界面修改）：nssm edit 服务名
启动服务：nssm start 服务名
停止服务：nssm stop 服务名
重启服务：nssm restart 服务名

卸载触达云屏

1，停止mgr服务
如果你使用的是 .bat 启动，则关闭该cmd窗口即可。
如果你使用nssm安装为了windows系统服务，则需要先停止服务，再使用 nssm remove 命令删除系统服务
如果你使用了其他开机自启动的方案，请自行参照其他方案的文档。
2，卸载数据库
右击以管理员身份执行 mysql-5.7.29-winx64/9_uninstall_mysql_5.7.bat
3，删除相关目录
如需保留数据，请保留文件夹目录以及内部的文件。

Linux 宝塔面板部署

推荐使用宝塔部署，运维更方便。

1，基础环境安装
使用宝塔面板，安装以下基础环境
（如果是全新刚安装的宝塔，没有php环境，还需要安装php环境，具体参考宝塔官方文档）
Nginx
Mysql 5.7+
phpMyAdmin

2，创建/导入数据库

创建数据库：chudy_datav（数据库名称可以自己指定，后面配置文件中配置正确即可）
字符集：utf8_general_ci
使用 phpMyAdmin 管理数据库，
执行初始化脚本：/app/chudy_visual_[版本号] /doc 目录下的SQL脚本

3，上传部署文件

创建安装目录：在服务器根目录下创建 app目录和 app/java目录

上传以下文件夹到服务器 /app 目录下

1 2	chudy_visual_[版本号]_0 filesystem

特别注意：app 文件夹及包含的子文件夹所有者和 java网站的项目用户（宝塔默认创建java网站后项目用户为 www）保持一致

给 filesystem 文件夹设置读写权限

特别注意：filesystem 文件夹所有者和 java网站的项目用户（宝塔默认创建java网站后项目用户为 www）保持一致

上传 jdk-8u221-linux-x64.tar.gz文件( 在网盘目录【0-基础软件包】中下载，根据自己的服务器平台选择相应的JDK )
到服务器 /app/java目录下
使用宝塔面板解压

修改数据库连接配置文件：

/app/chudy_visual_[版本号] /mgr/config 目录下 application-dev.properties
修改数据库端口、名称、帐号、密码等信息。

4，创建网站（JAVA项目，管理后台）

添加JDK

添加java项目
端口8088，勾选开机自启动，JDK选择上一步添加的自定义JDK

点击提交，创建完成后默认会自动启动。

5，访问系统
http://IP:8088/
初始帐号 sadmin 密码 111111

如果无法访问，
请检查服务器防火墙是否开放8088端口;
查看java网站的启动状态;
查看java网站项目的日志信息，确保正常启动。

6，异常问题反馈
如无法访问或使用过程中提示异常信息，可以向我们提供日志文件，协助分析。
日志文件所在目录默认是 /app/logs

Linux 环境部署

如果您不熟悉 linux运维，推荐使用宝塔面板部署，部署步骤参考上面的章节。

1，基础环境安装
安装以下基础环境(参考各官网)
Mysql 5.7+

2，创建/导入数据库

创建数据库： chudy_datav
初始化数据库：执行 /app/chudy_visual_[版本号] /doc 目录下的初始化SQL文件

3，创建安装目录
分别执行以下三行命令，创建安装目录

1
2
3

cd /
mkdir app
mkdir app/java

4，部署安装
上传以下文件夹到服务器 /app 目录下
chudy_visual_[版本号]
filesystem

到网盘目录【0-基础软件包】中下载 jdk-8u221-linux-x64.tar.gz
上传 jdk-8u221-linux-x64.tar.gz文件到服务器 /app/java目录下,解压。

#进入java目录
cd /app/java

#解压
tar -zxvf jdk-8u221-linux-x64.tar.gz

修改数据库连接配置文件：
/app/chudy_visual_[版本号] /mgr/config 目录下 application-dev.properties
修改数据库端口、名称、帐号、密码等信息。

防火墙中配置，放行端口 8088

6，启动应用

特别注意：app 文件夹及包含的子文件夹所有者和启动应用的用户保持一致。

#进入目录
cd /app/chudy_visual_[版本号]/mgr/
#授予mgr.sh 执行权限
chmod u+x mgr.sh 
#执行mgr.sh启动
./mgr.sh start

mgr.sh 支持启动、停止、重启、查看状态
./mgr.sh start | stop | restart | status

7，访问系统

http://IP:8088/
初始帐号 sadmin 密码 111111
如果无法访问，请检查服务器防火墙是否开放8088端口。

8，异常问题反馈
如无法访问或使用过程中提示异常信息，可以向我们提供日志文件，协助分析。
日志文件所在目录默认是 /app/logs

配置文件其他配置说明

application-dev.properties 配置文件

修改配置文件后，需要重启应用。

自定义登录后的首页

V4.3开始无需修改配置文件，通过内置的系统配置功能配置地址，即时生效

1 2	##登录后的首页页面地址，支持配置为自主设计的数据看板 custom.homeurl=http://demo.datav.chudayun.com/datav/view/1539916447218663424

新创建用户的默认密码

V4.3开始无需修改配置文件，通过内置的系统配置功能配置密码，即时生效

创建用户时无需指定密码，通过配置文件配置用户的默认密码。
用户可自行修改密码，或者由管理员重置密码。

1 2	#创建新用户帐号的默认密码 sys_password=000000

文件数据集服务器目录配置

V4.3开始无需修改配置文件，通过内置的系统配置功能配置目录，即时生效

需要从服务器的指定目录读取数据文件，则需要先配置服务器的目录信息，支持配置多个目录。

配置示例如下：配置值为json格式，k为服务器磁盘目录（windows带盘符、linux不带盘符），n 为文件夹中文描述。

1	data.datasetfile.dirs=[{"k":"E:/app_doc/数据集-测试文档","n":"业务文件夹1"},{"k":"/abcd/0002","n":"业务文件夹2"},{"k":"/abcd/0003","n":"业务文件夹3"}]

设计器根路径

V4.3开始无需修改配置文件，通过内置的系统配置功能勾选配置

#大屏编辑器根路径，chudy_visual，4.2开始支持配置为 datav
visual.editer.v2ctx=/datav
visual.editer.v2buildurl=/datav/build/
visual.editer.v2viewurl=/datav/view/

仅显示模式

有时候，集成商给用户只交付最终的大屏看板，设计功能不给用户开放。
此时可以开启仅显示模式，开启后，用户无法进入设计管理后台。
运维人员可以通过配置的特定参数进入管理后台。

#显示模式，限制进入设计后台
login.displaymode=1  # 1开启 
login.displaymodeCode=1  # 配置特定参数，传入特定参数可以进入设计后台 displaymode=此处配置的modecode的值
login.displayPage=/chudy_visual/view/1670449144893800448  #默认显示页面，当用户尝试进入后台时自动跳转至该页面

设备注册接入

支持2.0.0 版本的大屏展示客户端接入可视化平台，实现统一管理推送。
在配置文件中配置设备连接密码，在大屏展示客户端内配置连接时输入此密码。

V4.3开始无需修改配置文件，通过内置的系统配置功能配置密码，即时生效

1 2	##设备连接密码 device.connect.pwd=chudy_visual

平台皮肤设置

所需的图片资源文件，放置到 mgr/static/skin 目录下
在配置文件中，配置相应的图片路径

##设置登录后首页左上角logo图片
skin.logo=/skin/apple-touch-icon-72x72.png
##设置页面浏览器图标
skin.ico=/skin/apple-touch-icon-72x72.png
##设置登录界面背景图
skin.login.bg=
##设置登录页面中的logo图片
skin.login.logo=
##设置登录页面中的logo图片位置，可选值：left、right
skin.login.logoalign=
##设置登录页面中的logo图片高度
skin.login.logoheight=
##设置隐藏登录界面中的系统标题和说明
skin.login.displaytitle=none
##登录页面中标题和副标题的背景颜色
skin.login.titlebgcolor=rgba(52, 126, 188, .5)
##自定义登录页面，登录框左侧的标题 unicode
skin.login.title=\u0058\u0058\u0058\u6570\u636e\u53ef\u89c6\u5316\u5206\u6790\u5e73\u53f0
##自定义登录页面，登录框左侧的副标题 unicode
skin.login.subtitle=\u7269\u8054\u7f51\u3001\u4e91\u7ec4\u6001\u6570\u636e\u5206\u6790
##自定义浏览器中显示的页面标题 unicode
skin.app.pagetitle=\u0058\u0058\u5927\u6570\u636e
##可选配其他登录页 login01、login02
skin.login.page=login01

配置信息中需要的中文对应的 unicode 可以使用下面的在线工具转换
https://www.bejson.com/convert/unicode_chinese/

数据门户APP

数据门户APP给有移动端报表查阅需求的用户提供了一个拿来即用的安卓客户端。
支持配置企业个性化的登录页样式。

##登录页背景图片
mobile.skin.login.bg=图片网址
##底部版权栏信息
mobile.skin.login.footercp=\u6570\u636e\u4e0a\u5c4f
##设置在可视化平台首页是否显示APP设置信息二维码
mobile.index.qrcode=true

启用/停用登录验证码

设置为 true 开启登录验证码，设置为 false 停用登录验证码

1	login.verificationCode=false

设置会话超时时长

用户登录系统后，长时间无操作，超过下面配置的时长（默认单位秒）后，再访问系统功能时会提示会话超时，需要重新登录后继续使用。
默认时长：30分钟

1	server.servlet.session.timeout=3600

数据库密码加密配置

mgr应用的数据库连接密码加密（配置文件中配置加密后的密码）
1, 使用java命令生成密码加密信息：

1	java -cp druid-1.2.13.jar com.alibaba.druid.filter.config.ConfigTools 123456 >db_key_123456.txt

打开生成的文本文件

1
2
3

privateKey: 后面的为公钥信息，可以忽略。
publicKey: 后面的为公钥，需要配置到配置文件中。
password: 后面的为密码串，需要配置到配置文件中

2，拷贝密码串password 和公钥publicKey 到配置文件，同时配置开启密码加密：

1
2
3

spring.datasource.password=S7RIO+915XSI0ivNkoNcbRTS5H5hdGt8zI8A7hZQywym5P/PN6FIdSIXA7XOcTwxjU5lFQLw+dJYTfx4p7L8Ew==
spring.datasource.druid.connect-properties.config.decrypt=true
spring.datasource.druid.connect-properties.config.decrypt.key=${druid.publickey}

公钥可以配置为表达式，从启动参数命令中获取

配置开启https访问

1，准备证书

以阿里云等云平台购买到的证书为例，将 xxx.pfx 证书文件放到 config 目录下

2，配置证书

修改配置文件 application-dev.properties ，在 server.port 配置项后面，添加下面两项
server.ssl.key-store=config/真实的证书文件名称
server.ssl.key-store-password=换成真实的证书密码

如何变更部署目录

为了使得大家能快速部署体验到触达云屏，文档中，我们约定了默认的部署目录为 /app/ 目录，
很多用户希望能自由修改部署目录，只需要同步修改配置文件即可。
请阅读以下内容：

1，数据库部署目录变更
如果您已经安装了集成部署包内的mysql，则需要先卸载
进入到数据库目录 /app/chudy_mysql5.7_winx64
鼠标右击 9_uninstall_mysql_5.7.bat ，选择以管理员身份运行
卸载成功后，修改 app 为你所需的目录名称

2，变更了部署目录后，同步修改配置文件（application-dev.properties），如下图所示

关键配置项：

1
2
3

logging.file.name
file.local.root
file.static.root

3，修改 .bat .sh 等启动命令文件中的jdk地址（使用宝塔部署请忽略此步骤）

4，修改 nginx(设计器网站) 的配置文件，将静态资源文件指向新的路径
（使用集成部署包，请忽略此步骤）

location / {  
    try_files $uri $uri/ /index.html;
    root /app/chudy_designer;
    index index.html index.htm;
}