1.2 DGather程序文件介绍

DGather程序的安装目录如下图所示。
- Windows版本
![DGather程序目录-Windows版本](/media/202406/2024-06-29_190005_5925710.4888091763001995.png "DGather程序目录-Windows版本")

- Linux版本

![DGather程序目录-linux版本](/media/202406/2024-06-29_190128_0669920.8154046827487808.png "DGather程序目录-linux版本")

* 目录下文件和文件夹的说明

|文件或文件夹名称|说明|
|---------------:|:----|
|conf|系统配置文件夹|
|data|系统数据存储文件夹，内有SQLite数据库文件。 尚未运行过的程序目录下可能不存在此文件夹，程序运行后会自动创建|
|driver|驱动程序文件夹，DGather系统的核心文件夹|
|log|系统日志文件夹。 尚未运行过的程序目录下可能不存在此文件夹，程序运行后会自动创建|
|Tools|用于存放调试工具的文件夹，内有OPCDA、OPCUA、Modbus、MQTT等通信协议的测试工具和模拟软件工具|
|static|用于存放程序页面系统的静态文件|
|views|用于存放DGather系统的页面文件|
|`dgather.exe`或者`dgather`|DGather系统主程序文件，双击(Windows下)可以直接启动运行DGather系统|
|dgather.service|用于linux系统下的系统服务配置文件|
|instsrv.exe, srvany.exe, run-install.bat, run-uninstall.bat|(仅Windows下)系统文件，不可双击运行|
|安装.bat, 卸载.bat, 启动服务.bat, 停止服务.bat, 重启服务.bat|(仅Windows下)系统控制文件，必须以管理员权限运行。运行后执行相应的操作|
|从控制台启动.bat|(仅Windows下)与直接双击运行`dgather.exe`程序的效果类似，但遇到致命错误导致程序停止运行时，直接运行`dgather.exe`的命令行窗口会自动关闭，而通过`从控制台启动.bat`启动的命令行窗口会保留程序退出时的状态，不会自动关闭，从而方便排查问题。`从控制台启动.bat`仅用于调试阶段|

# 重要子目录

## conf

* conf目录内的文件如下图所示
![配置文件夹conf](/media/202406/2024-06-29_190749_0490790.3720090302544421.png "配置文件夹conf")

* conf目录下的文件说明

|文件名称|说明|
|---------------:|:----|
|app.conf|系统配置文件|
|i18ndict.json|国际化多语言资源文件,用于添加多国语言资源|

* app.conf文件中的配置参数

```
appname = dgather

# 是否开启HTTP和HTTPS;可以两个同时开启,也可以只开启其一
enablehttp = false
enablehttps = true
# 允许访问的地址;为空时允许所有网口,127.0.0.1时仅允许本机
httpaddr = "127.0.0.1"
httpsaddr = ""
# HTTP端口和HTTPS端口;请确保该端口与其他应用不冲突，否则程序无法启动
httpport = 80
httpsport = 443
# HTTPS的证书文件路径
httpscertfile = driver/static/cert.pem
# HTTPS的私钥文件路径
httpskeyfile = driver/static/key.pem

# 运行模式,dev或者test为开发模式,prod为生产模式
runmode = prod

# 语言设置,可选:{zh-CN,en-US}
languige = zh-CN
# 国际化字典文件
i18nfilepath = ./conf/i18ndict.json

# 数据库类型，可选:sqlite3,mysql
databasetype = sqlite3
# 数据库的路径,sqlite3时为数据库文件的访问路径;mysql时为数据库的访问ip和端口号,例如:localhost:3306
databasepath = ./data/dgather.db
# databasepath = 127.0.0.1:3306
# 数据库名,选mysql时需要填写
databasename = dgather
# 数据库用户名,选mysql时需要填写
databaseusername = 
# 数据库密码,选mysql时需要填写
databasepassword = 
# API接口免校验授权白名单，多个API中间以“,”分割
apiwitelists = /api/time,/api/version
# Jwt授权过期时间,单位为秒,-1永不过期,不设置时默认为3600秒
jwtlifetime = 36000
# JWT加密秘钥，随意的字符串，不少于10个字符. 如果不设置，则采用系统默认值. 密钥不可视于人.
jwtsecret =

# Redis内存数据库设置
[redis]
# 用户名
username = 
# 密码
password = 
# Redis数据库的连接地址
ip = 127.0.0.1
# Redis数据库的端口号
port = 6379
# 监控周期,单位:秒.用于周期性的监控redis数据库是否正常运行
watchperiod = 30

[logs]
# 存储层级:调试阶段可以为6或者7，生产阶段应小于7
# ["emergency"=0, "alert"=1, "critical"=2, "error"=3, "warning"=4, "notice"=5, "info"=6, "debug"=7]
level = 6
# 路径
logpath = "./log/dgather.log" 
# 最大行数
maxlogsize = 100000 
# 最大存储日期          
savedays = 180 
# 显示文件名
showpath = false
```

## driver

driver目录下的文件和文件夹如下图所示。

- Windows下的Driver目录结构
![driver目录-windows](/media/202406/2024-06-29_191307_7394090.28280667166874696.png "driver目录-windows")

- Linux下的Driver目录结构
![driver目录-linux](/media/202406/2024-06-29_191550_3367590.4035794671356733.png "driver目录-linux")

- driver目录下的文件说明

|文件或文件夹名称|说明|
|---------------:|:----|
|static|程序需要用到的静态资源文件夹，比如HTTPS和OPC-UA的证书文件等|
|redis|Windows下Redis内存数据库程序的文件夹|
|dgmanager|DGather系统中的核心程序，用于变量的计算与存储，以及各个驱动程序的管理。 DGather页面中的`启动`与`停止`即是用来控制该程序启停的|
|dgmodbus|Modbus驱动程序，支持Modbus-TCP, Modbus-RTU, Modbus-ASCII|
|dgopcda|基于Microsoft DCOM的OPC-DA驱动程序,仅适用于Windows环境下|
|opcdaapi|通过OPCDA Proxy的API接口与OPC DA服务器交互数据的驱动程序|
|dgopcua|平台无关的OPC-UA驱动程序|
|dgmqtt|MQTT发布和订阅驱动程序|
|dgrypto.exe|用于生成对称加密秘钥文件和私钥文件的工具程序|
|opcdaproxy|将OPC-DA服务器代理为API接口和Modbus-TCP的工具程序|

>注意：driver目录下的内容可能会随着DGather的版本不同而发生变动。