配置文件说明
1 功能简介
Cordys CRM 的运行参数保存在数据目录的 conf/cordys-crm.properties。调整数据源、Redis、会话超时、IP 白名单等，一般改这个文件后重启即可。
2 配置文件位置
默认数据目录为 /opt/cordys（docker run 示例也可能是 ~/cordys）。主要文件如下：
表 1 主要配置文件
| 文件 | 默认路径 | 说明 |
|---|---|---|
cordys-crm.properties | /opt/cordys/conf/cordys-crm.properties | 主配置 |
my.cnf | /opt/cordys/conf/mysql/my.cnf | 内置 MySQL |
redis.conf | /opt/cordys/conf/redis/redis.conf | 内置 Redis |
3 修改与生效
修改前先备份：
cp /opt/cordys/conf/cordys-crm.properties /opt/cordys/conf/cordys-crm.properties.bak.$(date +%F)
vi /opt/cordys/conf/cordys-crm.properties
需要启用的项去掉行首 # 并改值，保存后重启：
docker restart cordys-crm
# 离线安装也可：
csctl reload
修改后需重启
配置不会热更新，须重启容器或执行 csctl reload / csctl restart。见 命令行工具。
4 参数说明
cordys-crm.properties 中常见参数如下（修改时去掉行首 #）：
表 2 参数说明
| 参数名称 | 默认值 | 可选项 | 说明 |
|---|---|---|---|
| mysql.embedded.enabled | true | true false | 是否使用内置 MySQL；使用外部库时设为 false，并配置 spring.datasource.* |
| spring.datasource.url | — | — | 外部 MySQL JDBC 地址 |
| spring.datasource.username | — | — | 外部 MySQL 用户名 |
| spring.datasource.password | — | — | 外部 MySQL 密码 |
| redis.embedded.enabled | true | true false | 是否使用内置 Redis；使用外部 Redis 时设为 false，并配置 spring.data.redis.* |
| spring.data.redis.host | — | — | 外部 Redis 地址 |
| spring.data.redis.port | 6379 | — | 外部 Redis 端口 |
| spring.data.redis.password | — | — | 外部 Redis 密码 |
| spring.session.timeout | — | — | 会话过期时间，例如 43200s（12 小时） |
| dashboard.whitelist.enabled | false | true false | 仪表板外链白名单；不开启则不限制访问 |
| dashboard.whitelist.allowed | — | — | 白名单开启后允许访问的 IP 或域名，多个用逗号分隔 |
更多说明见 在线安装。