简介：蓝凌标准产品V16.0管理员手册-admin.do配置面向企业信息化系统的运维与管理人员，帮助其快速掌握蓝凌V16.0后台各项参数的配置方法与排错思路。手册围绕admin.do管理入口展开，涵盖数据库、全局参数、消息机制、存储、附件、REDIS缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集及GZIP压缩等模块，并延伸至系统安全中的身份验证与会话管理，目录结构清晰，便于按模块查阅。资源包内含1个PDF文档，压缩包约2.65MB，适合作为日常运维配置的案头参考。目前已有954人学习下载，读者可据此了解各配置项的作用与设置要点，快速定位系统运行中的配置问题，提升部署与维护效率。
1. 拿到 admin.do 配置手册先别急着改：这份 20 页文档到底解决什么问题
很多做企业信息化运维的同行，第一次拿到一份 20 页的 PDF 管理员手册，第一反应是“这么薄，能讲清楚什么”。但如果你手上正好有一套蓝凌标准产品 V16.0 需要部署或交接，这份 admin.do 配置手册的价值恰恰在于它够薄——它把后台那个“改错一个参数就得重启、重启完还可能起不来”的配置页面，按页签拆成了可对照的清单。admin.do 是这套系统里最底层的全局配置入口，数据库连接、Redis 缓存、附件存储、消息通道、多语言、三员管理这些开关全在这里，手册明确写了一句话：所有配置保存后必须备份并重启才生效。这意味着你在这个页面上的每一次保存，都是一次带风险的操作。这份文档适合两类人：一是刚接手系统、需要把配置项和实际环境对上的运维，二是做集成对接时要确认某个开关到底管什么用的开发。它不教你怎么装系统，但能让你在改配置之前知道每个字段的边界在哪。
2. 基础配置逐项拆解：从数据库连接到 GZIP 的落地顺序
基础配置是 admin.do 里字段最多、也最容易改出问题的页签。手册把它拆成数据库、全局参数、消息机制、存储、附件、Redis、全文索引、MQ、JMX、日志、运营日志、GZIP 共十二块。实际落地时不需要按手册顺序来，但有一个依赖关系必须遵守：数据库配置是第一步，Redis 配置必须在 Redis 服务启动之后才能填，否则保存后重启直接起不来。下面按“先能跑起来、再谈优化”的顺序把关键项过一遍。
2.1 数据库配置：连接类型和 URL 的写法差异
数据库配置是整个系统的命门，手册里字段说明写得很直白：连接类型推荐 JDBC，数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦。URL 必须是 jdbc 形式的地址。这里有一个新手容易翻车的点——不同数据库的 JDBC URL 前缀不一样，手册只给了一个 SQLserver 的示例，实际配 MySQL 或达梦时照抄那个格式会直接连不上。
# SQLserver 示例（手册原文格式） jdbc:jtds:sqlserver://192.168.1.146:1433/ekp # MySQL 常见写法（驱动类名不同，URL 前缀不同） jdbc:mysql://192.168.1.146:3306/ekp?useUnicode=true&characterEncoding=utf8 # 达梦常见写法 jdbc:dm://192.168.1.146:5236/ekp逻辑说明：连接类型选 JDBC 时，系统会用你填的 URL 去建立连接池；选 JNDI 则走容器托管的数据源，适合已经由中间件统一管理连接的场景。参数上重点看端口和库名，SQLserver 默认 1433，MySQL 默认 3306，达梦默认 5236，写错端口报的是连接超时而不是“库不存在”，排查时容易走弯路。手册里还提到一个“测试数据库连接”按钮，说明是一次性 Test 连接、不做数据读写，我一般会在改完 URL 后先点这个，确认通了再保存重启，能省掉一轮无谓的重启等待。
2.2 全局参数与消息机制：几个默认值建议改掉
全局参数里有两个字段值得单独拎出来说。一个是“视图默认显示行数”，默认 15，手册建议不要太大，防止使用者电脑配置差打开太慢——这个建议在实际上线后经常被忽略，有人为了“一页看全”调到 50 甚至 100，结果列表页加载时间翻倍。另一个是“帐户 trim() 函数”，默认开启，手册明确写了 trim 会引起数据库检索性能下降，大用户量建议关闭，但关闭后要自己检查组织架构 Excel 导入和第三方同步引入的左右空格问题。这是一个典型的“性能换数据干净度”的取舍，用户量过万时我一般会关掉，然后在导入环节加校验。
消息机制配置管的是全系统通知通道：待办、Email、短消息、DING 消息。手册里有一句提醒很关键——“默认通知方式的意思是默认勾选所有通道（不建议）”。原因是如果短信通道没有独立组件配合，勾了也发不出去，反而让用户以为通知发了。实际配置时按已采购的通道勾选，没集成的不要勾。
2.3 存储与附件配置：加密选项和上传类型白名单
存储配置提供三种方式：文件存储、阿里云对象存储、F4OSS 文件存储。选文件存储时会遇到附件加密选项，手册列了四种：不加密、简单加密、不加密（兼容简单加密和 AES）、AES 加密。这里手册的措辞有点绕，实际理解是——简单加密和 AES 加密都会稍微影响性能，选择时要考虑历史附件的兼容性。如果系统里已经存了大量不加密附件，直接切 AES 会导致老附件读不出来，得走兼容模式过渡。
附件配置里两个安全字段必须配：不允许上传的附件类型和只允许上传的附件类型。手册给的格式是分号分隔，比如.js;.bat;.exe;.sh。这里有个细节，WPS 文件的实际扩展名是.wps或者.jar，如果只允许上传的列表里写了.docx却没写.wps，用户传 WPS 文档会被拦。附件存放位置默认是c:/landray/kmss/resource，Linux 下改成/usr/local/landray/kmss/resource，手册特别标注目录需要具有可写权限——这个权限问题在 Linux 部署时是高频翻车点，后面避坑章节会展开。
2.4 Redis 缓存配置：启动顺序是硬约束
Redis 这块手册用了加粗的强调语气：“Redis 宕机会导致 EKP 无法使用”“配置后的启动顺序：先启动 Redis，后启动 ekp”。这不是建议，是硬约束。手册给的安装步骤是源码编译方式：
# 下载、解压、编译 wget http://download.redis.io/releases/redis-5.0.2.tar.gz tar xzf redis-5.0.2.tar.gz cd redis-5.0.2 make # 启动服务 src/redis-server # 用内置客户端验证 src/redis-cli redis> set foo bar OK redis> get foo "bar"逻辑说明：make编译完成后可执行文件在src目录下，redis-server不带配置文件启动会用默认端口 6379。set和get是验证服务是否正常的最简命令，返回 OK 和 bar 说明读写通。参数上，生产环境不会用默认配置直接跑，但手册只给了最简启动方式，实际部署时我一般会指定配置文件并设置持久化策略。Redis 在本系统里有两个用途：缓存机制（非必须，不勾选用系统默认缓存）和会话管理（集群环境必须勾选，多服务器 SSO 环境必须勾选）。这两个用途的勾选状态直接决定集群能不能正常做单点登录。
2.5 全文索引、MQ、JMX 与日志参数
全文索引配置依赖蓝凌统一搜索独立组件，手册里“全文索引定时任务时长”默认 28800 秒（8 小时），“全文索引线程数”默认 1、可设 1 到 10。线程数调太高会抢数据库资源，调太低索引更新慢，一般 3 到 5 是折中值。MQ 配置只有 URL、用户名、连接密码三项，说明消息队列是外挂的，不走 EKP 内部。JMX 服务提供管理扩展能力，端口可以在这里填，也可以通过 JVM 参数指定，两种方式选一种就行，同时配可能冲突。
日志参数配置里有一组默认值需要留意：应用日志、错误日志、后台日志、登录登出日志的备份天数默认都是 7 天，清除备份的天数默认 90 天。手册还给了一个容量估算公式：每个节点每天约产生 100M 日志文件，访问量大可能到 200M。如果有 5 个节点、保留 30 天，容量约5 * (30 + 1) * 100M = 15500M。这个估算在做磁盘规划时直接能用，公式里的“30+1”中的 1 是当天日志，别漏算。
3. 系统安全与集团应用：身份验证、三员管理和多语言配置
系统安全和集团应用这两块，配置项数量不多，但每一个都涉及权限边界，改之前要想清楚影响范围。手册把系统安全拆成本系统身份验证、多服务器验证、三员管理三部分，集团应用拆成多语言、分级授权、组织场所同步、多域名四部分。
3.1 本系统身份验证与单一用户限制
本系统身份验证用于和第三方用户认证系统集成后（LDAP、其它 EKP、AD 等）的场景。手册写了两条规则：开启禁用则本系统验证不做用户名密码校验；例外人员里部分超管账号依然在本系统做验证。这里有一个容易误解的地方——开启禁用后虽然不做校验，但手册备注了“需要确保两边有对应的用户（用户名一致）”，也就是说账号还是得在两边都存在，只是密码不在这边验。
会话管理里的“单一用户限制”适用于全系统只允许一端登录的场景。手册举的例子是：A 用户在谷歌浏览器登录了，另一个人用 A 的账号登录，会强制下线先登录的 A 用户。例外是通过 SSO 单点的用户不会失效。启用前提写得很清楚：有集群需要配置 Redis 才生效，启用多服务器也需要同时启用 Redis，单 EKP 不启用多服务器则直接生效。这个前提条件如果不满足，勾了也不会起作用，排查时先确认 Redis 状态。
3.2 多服务器验证与令牌环配置
多服务器验证解决的是跨 EKP 登录问题——多套系统共享令牌环，浏览器或 APP 登录一次，进入其它系统免登。手册以 Domino 的 LtpaToken 方式为例，字段包括密钥类型、作用域、有效期、令牌环名称、密钥、登录关键字。密钥类型可选 Domino 令牌环或 EKP 自主 LRToken，根据对接系统选。作用域一般填直接后缀，可以填多个域共用。有效期指定令牌环有效时间，过期后重新登录。
这里有一个和 Redis 联动的字段：“使用 redis 存储有效期”。手册说明使用该功能必须先启用 Redis 缓存，不配置表示不使用。用户每次访问时会延长该有效期，类似 session 的有效期。当从 Redis 取到有效期时以该有效期为准，否则以令牌环有效期为准。这个逻辑在排查“为什么用户登录状态时长短于预期”时很关键——先看 Redis 里有没有值。
3.3 三员管理与集团分级授权
三员管理默认关闭，手册有一句警告：“开启三员管理后不能再访问 admin.do”。这意味着开启这个开关等于把后台配置入口锁掉，后续要调整只能走三员管理操作手册里的流程。所以开启前一定要先备份配置文件，手册第六章专门有一节“备份配置文件”，导出后妥善保存以防泄漏。
集团分级授权里的“场所见数据隔离”是一个权限方向配置，隔离选项包括对本场所数据可见、对上级场所数据可见、对下级场所数据可见。组织场所同步则管机构同步（平级还是层级）、部门同步、场所管理员同步、场所漫游同步。这些配置直接影响用户能看到哪些数据，改之前建议先在测试环境验证隔离方向是否符合组织架构的实际汇报关系。
3.4 多语言支持与多域名
多语言支持开启后，登录页可以切换语言，备选项来源于此处的语言配置，官方语言是所有用户登录的默认语言。语言样式定义三项：单屏登录页、多屏滑动登录页、随机背景登录页。手册还提到一个附加功能：集群模式下需要开启此项，保证通讯安全（密钥）、系统独立（节点标识）、不受干扰（起始端口+20 不同）。这个“起始端口+20”是集群节点间通讯的端口分配规则，部署多节点时如果端口冲突，先检查这里。
多域名支持针对多线环境，手册的说明是“当前互联网骨干网建设已基本完成，延迟较低，所以一般不开启此项”。这是一个明确的“默认不配”建议，除非确实遇到运营商网间延迟问题，否则不用动。
4. 应用配置与后台配置：KMS、移动端和角色分配
应用配置和后台配置是 admin.do 里相对“上层”的部分，管的是知识专辑、移动组件、个人中心、表单和角色。这些配置不像数据库那样一错就起不来，但配错了会影响具体功能的使用体验。
4.1 KMS 知识专辑与流水号兼容
KMS 知识专辑配置里有三个字段值得关注。批量下载最大个数限制知识专辑的批量下载数量，设太大对服务器压力大。建模日志存放路径用于存放业务建模的日志。流水号生成规则兼容配置是给老客户用的——系统默认启用新版流水号生成机制，老客户会有兼容性问题，可以进入对应模块重新配置编号生成规则，或者勾选对应模块让它使用原有机制。这个配置在系统升级后如果发现流水号格式变了，就是这里没设对。
4.2 移动组件扩展与个人中心
移动组件扩展配置里，“扩展支持的 UA 信息”默认已适配大部分手机 UA，遇到无法识别特定机型时，手册给了一个排查方法：在手机上访问域名/third/pda/ua.jsp获取 UA。移动终端访问域名可以分配一个专属移动端地址，这样不用识别 UA 直接展现移动端。“仅允许移动端访问”启用后 PC 端不能访问，“禁止本服务器的登录功能”在启用 SSO 多服务器配置后可以禁用掉此服务器的登录，安全考虑。“代理服务器”用于 EKP 无法访问微信第三方时通过此处连通。
个人中心配置里，头像来源可选 EKP 个人头像或 KK 头像。二维码分享配置开启后在模块文档查看页面会显示二维码，这个功能看场景决定是否开。
4.3 表单配置与角色分配
表单配置主要是移动端对自定义 JSP 的支持，手册有一句操作提醒：“当切换此功能，请务必重新生成 JSP（后台管理员工具箱中）”。这是一个容易漏的步骤——改了表单配置不重新生成 JSP，移动端页面不会更新。
后台配置里的角色分配，手册用表格列了角色名称、角色权限说明、群组角色、考勤管理员、模块管理员。模块管理员只有管理员才具有访问权限。角色分配本身不复杂，但要注意的是角色和权限的对应关系在系统里有默认值，调整前先确认现有角色是否已经被业务流程引用。
5. 避坑与排查：admin.do 配置里最容易翻车的五个点
这一章把前面各环节里散落的坑集中起来，按“现象 → 原因 → 解决”的格式写。这些都是实际部署和运维中反复出现的问题，不是理论推演。
5.1 保存配置后重启，系统起不来
现象：在 admin.do 改完配置点保存，重启 EKP 后服务无法启动，日志里报连接类错误。
原因：最常见的是 Redis 配置在 Redis 服务未启动时保存，或者数据库 URL 改错但没点“测试数据库连接”就保存了。手册明确写了 Redis 配置必须在 Redis 启动之后配置，且启动顺序是先 Redis 后 EKP。
解决：重启前先确认 Redis 服务状态（redis-cli ping返回 PONG），数据库连接用测试按钮验证通过。如果已经起不来，用第六章的备份配置文件回滚，或者直接改回上一次的配置值。
5.2 Linux 下附件上传失败，报权限错误
现象：Windows 环境正常，迁到 Linux 后上传附件报错，日志提示无法写入。
原因：附件存放位置默认是c:/landray/kmss/resource，Linux 下要改成/usr/local/landray/kmss/resource，手册标注了“目录需要具有可写权限”。很多人改了路径但没给运行账号写权限。
解决：确认路径后执行chown -R 运行账号:运行账号 /usr/local/landray/kmss/resource和chmod -R 755，然后重启。注意不要给 777，安全上不合适。
5.3 单一用户限制不生效
现象：勾选了会话管理的单一用户限制，但同一账号还是能在多处同时登录。
原因：手册写了启用前提——有集群需要配置 Redis 才生效，启用多服务器也需要同时启用 Redis，单 EKP 不启用多服务器才直接生效。如果环境是集群但 Redis 没配或没勾选，这个功能就是摆设。
解决：先确认环境类型，集群或多服务器环境必须启用 Redis 缓存并确保 Redis 服务正常，然后重新保存配置并重启。
5.4 附件类型白名单拦住了正常文件
现象：配置了只允许上传的附件类型，用户传 WPS 文档或某些 Office 文件被拒绝。
原因：手册特别提示 WPS 文件的实际扩展名是.wps或者.jar，如果白名单里只写了.docx、.xlsx而没写.wps、.et、.dps，WPS 用户就会被拦。另外如果金格控件选了 OFFICE 模式，所有 Word、Excel、PPT 都要改成.doc/.xls/.ppt后缀，选了 WPS 则改成.wps/.et/.dps。
解决：根据实际使用的办公软件类型，把对应扩展名加进白名单。金格控件的模式选择要和用户实际文件格式匹配，混编场景要确认版本是否支持。
5.5 日志表膨胀导致查询变慢
现象：系统运行一段时间后，日志查询越来越慢，数据库磁盘占用增长快。
原因：日志参数配置里，应用日志、错误日志、后台日志、登录登出日志的备份天数默认 7 天，清除备份天数默认 90 天。如果没调整过，90 天的备份日志会一直堆在历史日志表里。手册给的容量估算显示 5 节点 30 天就约 15G，实际访问量大的环境增长更快。
解决：根据磁盘容量和合规要求调整备份天数和清除天数。如果开启了运营日志采集，手册提到可以禁用系统操作日志，但禁用后不能直接从系统查看操作日志，需要权衡。调整后观察一段时间数据库增长趋势。
6. 配置备份与版本升级时的参数迁移技巧
admin.do 的配置项加起来几十个，每次升级或迁移环境都靠手工对照填，出错概率不低。手册第六章的“备份配置文件”功能就是为这个场景准备的——导出后妥善保存，既防泄漏也防丢失。我自己的习惯是：每次改动 admin.do 之前先导出一份当前配置，命名带上日期和环境标识，改完再导出一份，两份对比就能看出这次到底动了哪些参数。
升级场景下，参数迁移有几个技巧。第一，数据库配置和 Redis 配置是环境相关的，升级包里的默认值不能直接用，必须按目标环境填。第二，附件存放位置和附件转换服务的端口配置，如果升级前后服务器不变，可以直接沿用；如果换了服务器，路径和端口都要重新确认。第三，多服务器验证的密钥和令牌环名称，多套系统之间必须保持一致，升级时如果重新生成了密钥，其它系统也要同步更新，否则免登会失效。第四，三员管理如果已开启，admin.do 是访问不了的，升级前要先确认三员管理的配置流程，别把自己锁在外面。
验证配置是否生效，除了看功能是否正常，还可以通过几个入口快速确认：JDBC 监控在“管理员工具箱-请求监控-查看 JDBC 监控”里看，能确认数据库连接池状态；获取客户端 IP 地址参数可以在服务器 DNS/resource/jsp/testip.jsp页面查看，用于日志分析时确认 IP 字段是否正确；移动端 UA 识别问题可以通过手机访问域名/third/pda/ua.jsp获取实际 UA 来比对。
有一个细节我踩过坑：手册里说“部分选项因组件不具备不会显示”，意思是 admin.do 页面上的字段是动态的，没装某个组件就不会出现对应配置项。所以对照手册排查时，如果找不到某个字段，先确认对应组件是否已部署，而不是怀疑手册版本不对。从那以后我每次拿到新环境，都先把 admin.do 每个页签截一遍图存档，升级后再截一遍对比，哪些字段因为组件变化消失了、哪些新增了，一目了然。希望帮到你。
本文还有配套的精品资源，点击获取
