简介：蓝凌标准产品V16.0管理员手册-admin.do配置面向企业信息化系统的运维与实施人员，尤其是负责蓝凌EKP平台部署、调优与日常维护的管理员。手册围绕admin.do后台配置展开，系统梳理了数据库、全局参数、消息机制、存储、附件、REDIS缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集及GZIP压缩等模块的配置要点，并延伸至系统安全中的身份验证与会话管理，帮助读者建立从基础参数到安全策略的完整配置认知。资源包内含1个PDF文档，大小约2.65MB，结构按章节编排，目录层级清晰，便于按模块快速定位查阅。目前已有954人学习下载，适合需要对照官方手册完成系统初始化、缓存与索引调优或排查配置问题的技术人员参考使用。

1. 从 admin.do 入口说起：一份 20 页手册能省掉多少重启

接手一套协同办公系统的运维，最怕的不是业务代码出问题，而是某个全局开关改错了位置，导致整站白屏。蓝凌标准产品 V16.0 的管理员手册把 admin.do 这个后台配置入口拆成了四大页签——基础配置、系统安全、集团应用、应用配置，覆盖数据库、Redis、附件、全文索引、MQ、日志、多语言、分级授权等二十多个配置项。这份 PDF 只有 20 页，但每一页对应的都是“改完必须重启”的硬开关。它适合两类人：一是刚接手系统、需要快速摸清配置边界的运维，二是准备做私有化部署、要提前规划中间件依赖的实施人员。手册里反复强调一句话——admin.do 里的配置都是必须、需要、一定重启。这句话不是吓唬人，我见过太多因为漏掉重启导致配置不生效、排查半天的案例。

2. 基础配置：数据库、Redis 与附件的落地顺序

2.1 数据库连接与 JDBC 监控的取舍

数据库配置是 admin.do 里第一项必须填对的字段。连接类型推荐 JDBC，数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦。连接 URL 是标准 jdbc 格式，比如jdbc:jtds:sqlserver://192.168.1.146:1433/ekp。这里有个容易被忽略的选项：JDBC 监控。启用后可以在“管理员工具箱-请求监控-查看 JDBC 监控”里看到 SQL 执行情况，但生产环境长期开启会带来额外开销。我的习惯是上线前压测阶段打开，正式运行后关闭，需要排查慢查询时再临时启用。

测试数据库连接按钮做的是无损测试，不读写数据，点一下就能确认 URL、用户名、密码是否匹配。但要注意，这个测试只验证连通性，不验证库表结构是否完整。如果系统启动后报表不存在，问题不在连接配置，而在数据库初始化脚本没跑完。

2.2 Redis 缓存：宕机即停服的硬依赖

Redis 在 admin.do 里的配置有一个前置条件：必须在 Redis 启动之后才能配置。手册里用加粗字体写了一句“Redis 宕机会导致 EKP 无法使用”，这不是危言耸听。配置后的启动顺序必须是先 Redis 后 EKP，反过来系统起不来。

Redis 在本系统里承担三个用途：缓存机制（非必须，不勾选用系统默认缓存）、会话管理（集群环境必须勾选，多服务器 SSO 环境必须勾选）、以及配合多服务器验证的令牌环存储。安装部署部分手册给了源码编译方式：

# 下载并解压 Redis 源码包 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 # 编译，生成可执行文件在 src 目录 make # 启动 Redis 服务，默认端口 6379 src/redis-server # 另开终端用内置客户端验证 src/redis-cli redis> set foo bar OK redis> get foo "bar"

这段命令的逻辑很直白：下载指定版本、解压、编译、启动、验证。参数上唯一需要留意的是redis-server默认前台运行，生产环境一般会配合配置文件改成后台守护模式，并设置requirepass和bind限制访问来源。手册没有展开这些安全项，但实际部署时如果不做，Redis 裸奔在公网端口上就是事故。

2.3 附件存储与转换服务的边界

附件配置分两块：附件本身的存放规则，和附件转换服务的连接参数。存放位置默认是c:/landray/kmss/resource，Linux 下改成/usr/local/landray/kmss/resource，目录必须可写。普通附件和图片附件有各自的大小限制，大图宽度默认 1024 像素、小图宽度默认 512 像素，超过就压缩，设为 0 则不压缩。

不允许上传的附件类型基于安全考虑，格式是.js;.bat;.exe;.sh，分号分隔。只允许上传的类型同理，比如.docx;.xlsx;.txt;.pdf。这里有个坑：WPS 文件的实际扩展名可能是.wps或.jar，如果只允许列表里没写全，用户上传就会被拦。

附件转换服务不配置不影响上传下载，但移动端或不具备 Office 的环境要在线阅读就必须配。金格控件的启用也有类似逻辑——不配不影响基本功能，要在线编辑批注才需要。手册特别提醒，iWebOffice2015 第一次启用时，Chrome 浏览器无法提醒用户下载控件，必须先用 IE 安装一次，之后 Chrome 才能正常加载。如果 Chrome 里加载失败，需要手动运行开始菜单里 iWebOffice2015 目录下的“修复配置”。这个细节在实施现场非常实用，省得以为是系统 bug 去翻日志。

3. 系统安全与集团应用：会话限制、令牌环与分级授权

3.1 单一用户限制与多服务器验证的配置逻辑

会话管理里的“单一用户限制”解决的是同一账号多端登录的问题。启用后，A 用户在 Chrome 登录，另一个人用 A 的账号在别处登录，前者会被强制下线。但通过 SSO 单点登录的用户不会失效。启用前提写得很清楚：有集群需要配 Redis 才生效，启用多服务器也需要同时启用 Redis，单 EKP 且不启用多服务器则直接生效。

多服务器验证用于跨 EKP 登录场景，多套系统共享令牌环，浏览器或 APP 登录一次进入其它系统免登。以 Domino 的 LtpaToken 方式为例，需要配置密钥类型、作用域、有效期、令牌环名称、密钥、登录关键字。其中“使用 redis 存储有效期”这个选项必须先启用 Redis 缓存，不配置则表示不使用。用户每次访问会延长有效期，类似 session 机制。从 Redis 取到有效期时以 Redis 为准，否则以令牌环有效期为准。

三员管理默认关闭，开启后不能再访问 admin.do。这个开关一旦打开就没有后悔药，只能通过后台数据库或配置文件回退。所以实施时如果客户没有明确的三员分立要求，不建议主动开启。

3.2 集团分级授权与组织场所同步的参数含义

集团应用页签下的多语言支持开启后，登录页会出现语言切换选项，官方语言是所有用户的默认语言。语言样式定义有三种：单屏登录页、多屏滑动登录页、随机背景登录页。集群模式下还需要开启附加功能，保证通讯安全（密钥）、系统独立（节点标识）、不受干扰（起始端口+20 不同）。

集团分级授权的核心是“场所见数据隔离”。开启后各场所相互独立，隔离方向有三个选项：对本场所数据可见、对上级场所数据可见、对下级场所数据可见。组织场所同步则控制机构同步是平级还是层级、部门同步创建几级、场所管理员是否需要同步、场所漫游同步的范围是直属用户还是全部用户。这些参数直接决定集团内部谁能看到谁的数据，配错会导致要么信息孤岛、要么越权查看。

多域名支持用于多线环境应对运营商网间延迟，但手册明确说当前互联网骨干网建设已基本完成，延迟较低，所以一般不开启。这个判断很务实，不是所有选项都值得打开。

4. 应用配置与后台配置：KMS、移动端与备份

4.1 KMS 知识专辑与流水号兼容

KMS 知识专辑配置里有几个关键参数：批量下载最大个数限制、建模日志存放路径、流水号生成规则兼容配置。系统默认启用新版流水号生成机制，老客户升级后可能有兼容性问题，需要进入对应模块重新配置编号规则，或者勾选对应模块让它继续用旧机制。这个设计是为了平滑升级，但实施时如果没注意到，会出现新旧编号混用的情况。

4.2 移动组件扩展与表单配置

移动组件扩展配置里，UA 信息默认已适配大部分手机，遇到无法识别的机型可以在手机上访问域名/third/pda/ua.jsp获取 UA 再填入。移动终端访问域名可以分配专属地址，不用识别 UA 直接展现移动端。仅允许移动端访问启用后 PC 端无法访问，禁止本服务器登录功能在启用 SSO 多服务器后可以禁用掉本机登录入口。代理服务器用于 EKP 无法访问微信第三方时连通外部。移动端开发模式适用于上线前调试样式，二维码分享开启后在文档查看页显示二维码。

表单配置主要是移动端对自定义 JSP 的支持，切换功能后务必重新生成 JSP，入口在后台管理员工具箱。这个操作容易被遗漏，导致移动端页面样式错乱。

4.3 备份配置文件与角色分配

后台配置里的角色分配定义了群组角色、考勤管理员、模块管理员等权限。模块管理员只有管理员才具有访问权限。备份配置文件导出后要妥善保存，因为里面包含数据库连接信息等敏感内容。手册没有展开备份文件的加密方式，实际保存时建议放在受控目录，不要随手丢在桌面。

5. 避坑排查：admin.do 配置里最容易翻车的五件事

5.1 改完配置没重启，以为系统有 bug

现象：在 admin.do 里修改了数据库连接或 Redis 地址，保存后页面刷新，功能没变化，甚至报错。 原因：手册开篇就写了“admin.do 里面的配置都是必须，需要，一定重启”，但实际操作时容易顺手点保存就去验证。 解决：每次保存配置后，先点备份配置，再重启 EKP 服务。重启顺序遵循先 Redis 后 EKP，集群环境逐节点重启。

5.2 Redis 未启动就配 EKP，启动直接失败

现象：EKP 启动日志报连接 Redis 超时，服务起不来。 原因：配置了 Redis 缓存但 Redis 服务没先启动，或者启动顺序反了。 解决：确认 Redis 进程存在且端口可通，再启动 EKP。如果是集群，所有节点都要能访问同一个 Redis。

5.3 附件上传被拦，只允许列表漏了 WPS 扩展名

现象：用户上传.wps文件提示类型不允许。 原因：只允许上传的附件类型里只写了.docx;.xlsx;.txt;.pdf，没包含.wps或.et、.dps。 解决：根据实际使用的办公软件补充扩展名。如果用的是 WPS 且选择了对应控件类型，所有 Word、Excel、PPT 都要改成 WPS 对应后缀。

5.4 金格控件在 Chrome 里加载失败

现象：第一次启用 iWebOffice2015，Chrome 浏览器没有弹出控件下载提示，页面空白或报错。 原因：Chrome 不支持首次自动提醒下载控件，必须先通过 IE 安装一次。 解决：先用 IE 访问并安装控件，再换 Chrome。如果 Chrome 里仍然失败，运行开始菜单 iWebOffice2015 目录下的“修复配置”。

5.5 开启三员管理后无法访问 admin.do

现象：启用三员管理后，再打开 admin.do 提示无权限或直接跳转。 原因：三员管理开启后设计上就禁止再访问 admin.do，这是预期行为。 解决：如果确实需要回退，只能通过数据库或配置文件修改，所以开启前务必确认客户有明确的三员分立需求，并提前备份配置。

6. 日志容量估算与运营日志采集的取舍

运营日志采集是 admin.do 里比较容易被忽视但影响存储规划的一项。手册给了一个估算公式：每个节点每天产生约 100M 日志文件，访问量大时可能到 200M。如果有 5 个节点、保留 30 天，总容量约为5 × (30 + 1) × 100M = 15500M，其中 30+1 里的 1 是当天日志。这个数字直接决定磁盘规划，如果没提前算，上线一个月后磁盘告警是大概率事件。

日志参数配置里，应用日志、错误日志、后台日志、登录登出日志的备份天数默认都是 7 天，清除备份天数默认 90 天。记录错误日志条数可以设置每天超过指定数量就不记录到数据库，防止错误风暴打满磁盘。开启运营日志后可以禁用系统操作日志，但禁用后不能直接从系统查看操作日志，只能通过运营日志平台看。

我一般会建议客户：如果不需要热点分析和系统使用情况分析，直接关闭运营日志采集，用系统自带的日志参数配置就够了。如果确实要开，先按公式算磁盘，再决定保留天数。日志上传到服务网站或通过运营日志上传工具自动上传，上传后可以在服务网站查看分析图表，但开通需要联系客服。

从那以后我每次改 admin.do 配置，都强制走一遍“保存→备份→重启→验证”的流程，并且把备份文件按日期归档。希望这份拆解能帮到你，少走一次因为漏重启而怀疑人生的弯路。

本文还有配套的精品资源，点击获取