企业官网建设流程全解析

简介：蓝凌标准产品V16.0管理员手册-admin.do配置面向企业信息化系统的运维与管理人员，帮助其掌握蓝凌V16.0后台admin.do的配置方法，解决系统部署与日常运维中的参数设置问题。手册围绕基础配置展开，涵盖数据库连接与参数、全局参数、消息机制、存储与附件、REDIS缓存（含说明、安装部署及在本系统用途）、全文索引、MQ、JMX服务、日志参数、运营日志采集与GZIP压缩等模块，并延伸至系统安全中的身份验证与会话管理，目录结构清晰，便于按模块查阅。资源包共1个PDF文件，大小约2.65MB，适合作为配置参考随时翻阅。目前已有951人学习下载，可作为管理员快速定位配置项、理解各组件作用与排错思路的实用工具，也可供实施人员对照检查系统配置是否完整规范。

1. 拿到 admin.do 配置手册先别急着改：这份 20 页文档到底解决什么问题

很多做企业信息化运维的朋友第一次接触蓝凌 EKP 后台，都会在admin.do这个页面上翻车。它不像普通管理后台那样点两下就能生效，而是把数据库、缓存、附件、安全、集团应用这些底层开关全塞进一个页面，改完不重启等于白改。这份《蓝凌标准产品V16.0管理员手册-admin.do配置》一共 20 页，覆盖基础配置、系统安全、集团应用、应用配置四大页签，本质是一份给实施和运维人员看的“全局参数字典”。它适合三类人：正在部署 EKP 的实施工程师、接手老系统要做参数调优的运维、以及需要排查附件上传或登录异常的技术支持。文档里反复强调一句话——admin.do 里的配置都是必须、需要、一定重启，保存后还要备份配置再重启。这句话不是吓唬人，我见过太多人改完 Redis 地址直接刷新页面，结果会话全丢，用户被强制下线。所以这篇笔记不按目录顺序念文档，而是按“先立住原理、再动手复现、最后避坑”的节奏，把这份手册里真正影响系统能不能跑起来的关键配置拆开讲。

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

2.1 数据库配置为什么必须第一个填

admin.do 的基础配置页签里，数据库配置排在第一位，这不是随便排的。EKP 的业务数据、配置数据、日志数据都依赖这个连接，连接类型推荐 JDBC，数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦。URL 要写成 jdbc 形式，比如jdbc:jtds:sqlserver://192.168.1.146:1433/ekp。这里有个容易忽略的点：如果你用的是 SQLserver，驱动前缀是jtds而不是sqlserver，写错了启动直接报驱动找不到。测试数据库连接那个 Test 按钮是一次性无损测试，不做数据读写，上线前可以放心点。但要注意，数据库配置改完必须保存并备份配置，然后重启，否则新连接不会生效。我一般会先把 URL、用户名、密码在本地用客户端连一遍，确认网络和权限没问题再填进 admin.do，省得重启一次等五分钟才发现密码打错了。

2.2 Redis 缓存配置：启动顺序错了系统直接不可用

Redis 这块是 admin.do 里最容易出玄学问题的地方。手册里写得很直白：Redis 宕机会导致 EKP 无法使用，配置后的启动顺序必须是先启动 Redis，后启动 EKP。Redis 在本系统里有两个用途，一是缓存机制，勾选后用 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 # 编译，如果报 gcc 缺失先装编译工具链 make # 进入 src 目录启动服务端 cd src ./redis-server # 另开一个终端用内置客户端验证 ./redis-cli

连上之后执行set foo bar返回 OK，再get foo返回 "bar"，说明 Redis 本身没问题。参数上要注意，admin.do 里填的 Redis 地址必须是 EKP 服务器能访问到的 IP 和端口，不要填 127.0.0.1 除非 Redis 和 EKP 在同一台机器。如果是集群环境，会话管理必须勾选 Redis，否则单一用户限制功能不生效。手册里还提到一个细节：启用 Redis 存储有效期后，用户每次访问会延长有效期，类似 session 的续期机制，从 Redis 取到有效期时以 Redis 为准，取不到才用令牌环本身的有效期。这个逻辑在排查“用户莫名掉线”时非常关键。

2.3 附件配置：存储路径、大小限制与金格控件

附件配置分两块，一块是附件本身，一块是附件转换服务。附件存放位置默认是c:/landray/kmss/resource，Linux 下改成/usr/local/landray/kmss/resource，目录必须可写，否则上传直接失败。普通附件大小限制和图片附件大小限制按项目实际需求填，大图宽度默认 1024 像素，小图宽度默认 512 像素，设为 0 表示不压缩。不允许上传的附件类型建议至少加上.js;.bat;.exe;.sh，这是安全底线。只允许上传的类型如果配了，就要注意 wps 文件的实际扩展名可能是.wps或.jar，别漏了。

金格控件这块坑最多。iWebOffice2015 第一次启用时，客户端 IE 会提醒下载控件，但 Chrome 不会提醒，必须先拿 IE 装一遍再用 Chrome。有时候 Chrome 加载控件失败，要去开始菜单里手动运行 iWebOffice2015 目录下的“修复配置”。还有一点，EKPV15B2 之后支持 iWebOffice2003，如果选了 OFFICE，所有 word、excel、PPT 都要改成.doc/.xls/.ppt；选了 WPS 就改成.wps/.et/.dps，混用会打不开。附件转换服务不配置不影响上传下载，但移动端要看 office 文档就必须配，三个端口——注册心跳、监听、处理客户端请求——都要和附件转换服务组件互通。

2.4 全局参数与日志参数：几个影响性能的开关

全局参数里有两个开关值得单独说。一个是“帐户 trim() 函数”，默认开启，但手册明确写了 trim 会引起数据库检索性能下降，大用户量建议关闭。关闭后要自己检查组织架构 Excel 导入和第三方同步带来的左右空格问题，否则会出现用户名带空格登录不上的情况。另一个是“样式调试模式”，上线测试环境建议开启，样式不做缓存方便调整；生产环境必须关闭，否则访问压力会明显上升。日志参数配置里，应用日志、错误日志、后台日志、登录登出日志默认都保留 7 天，清除备份默认 90 天。运营日志采集开启后每个节点每天大约产生 100M 日志文件，访问量大的可能到 200M。如果 5 个节点保留 30 天，容量大概是 5 × (30+1) × 100M = 15500M，这个估算在做服务器磁盘规划时直接能用。

3. 系统安全与集团应用：身份验证、多服务器与分级授权

3.1 本系统身份验证与单一用户限制

本系统身份验证用于和第三方用户认证系统集成后（LDAP、其它 EKP、AD 等）的场景。开启禁用后，本系统不做用户名密码校验，但例外人员里的超管帐号依然在本系统验证。这里有个前提：虽然不做校验，但两边必须有对应的用户，用户名要一致，否则登录后找不到人。单一用户限制适用于全系统只允许一端登录的场景，A 用户在 Chrome 登录后，另一个人用 A 的账号登录会强制把 A 踢下线。例外是通过 SSO 单点的用户不会失效。启用前提要记牢：有集群必须配 Redis 才生效，启用多服务器也必须同时启用 Redis，单 EKP 不启用多服务器才直接生效。这个功能在排查“用户被莫名踢出”时是首要怀疑对象。

3.2 多服务器验证与令牌环配置

多服务器验证主要是配令牌环，实现跨 EKP 登录，多套系统共享令牌环，浏览器或 APP 登录一次进入其它系统免登。以 Domino 的 LtpaToken 方式为例，密钥类型可选 Domino 令牌环或 EKP 自主 LRToken，作用域一般直接填后缀，可以填多个域共用。有效期指定令牌环有效时间，过期后重新登录。如果勾了“使用 redis 存储有效期”，必须先启用 Redis 缓存，用户每次访问会延长有效期。令牌环名称多套系统必须保持一致，密钥可以随机生成一组拷贝到其它系统。登录关键字默认是 CN。这块配置错了的典型现象是：A 系统登录成功，跳 B 系统又让登录，或者跳过去报令牌无效。排查时先确认两边令牌环名称和密钥是否完全一致，再看作用域有没有覆盖目标域名。

3.3 集团分级授权与组织场所同步

集团应用页签里，多语言支持开启后登录页可以切换语言，官方语言是所有用户登录的默认语言。附加功能里有一句很重要：集群模式下需要开启此项，保证通讯安全（密钥）、系统独立（节点标识）、不受干扰（起始端口+20 不同）。组织场所同步涉及数据隔离，场所见数据隔离开启后各个场所相互独立。隔离方向有三个选项：对本场所数据可见、对上级场所数据可见、对下级场所数据可见。机构同步分平级同步和层级同步，部门同步同步创建 N 级对应的场所，管理员同步决定场所管理员是否需要同步。场所漫游同步可选直属用户或全部用户。多域名支持一般不用开，手册里也写了当前互联网骨干网延迟较低，除非确实在多线环境下才配。

4. 避坑排查：admin.do 改完不生效的五个血泪经验

4.1 改完配置没重启，页面刷新一百遍也没用

现象：在 admin.do 改完数据库 URL 或 Redis 地址，点保存后刷新前台，发现还是连的旧地址。原因：手册第一章就写了，admin.do 里的配置都是必须、需要、一定重启，保存配置并备份配置后重启才生效。解决：养成习惯，每次改完 admin.do 先点备份配置，导出文件妥善保存，然后重启 EKP 服务。备份文件不仅是后悔药，也是出问题时对比参数差异的依据。

4.2 Redis 先于 EKP 启动顺序反了，系统直接起不来

现象：服务器重启后 EKP 无法访问，日志里一堆连接 Redis 超时。原因：配置了 Redis 缓存或会话管理后，EKP 启动时就要连 Redis，如果 Redis 还没起来，EKP 初始化失败。解决：把 Redis 做成系统服务并设置开机自启，确保启动顺序在 EKP 之前。如果是容器化部署，用 depends_on 或启动脚本控制顺序。手册里那句“Redis 宕机会导致 EKP 无法使用”不是夸张，是实测结论。

4.3 附件目录没写权限，上传报错但日志不明确

现象：用户上传附件失败，前台提示模糊，后台日志只看到文件写入异常。原因：附件存放位置配的目录没有可写权限，Linux 下尤其常见，默认路径/usr/local/landray/kmss/resource如果属主不对，EKP 进程写不进去。解决：确认目录存在且 EKP 运行用户有读写权限，用chown -R和chmod调整。改完路径后同样要重启。另外不允许上传的类型里一定要包含.jsp和.sh，这是安全加固的基本操作。

4.4 金格控件 Chrome 装不上，是因为没先走 IE

现象：用户反馈 Chrome 里打不开在线编辑，控件加载失败。原因：iWebOffice2015 第一次使用时 Chrome 不会提醒下载控件，必须先拿 IE 浏览器安装一遍，之后 Chrome 才能正常加载。有时候 Chrome 加载失败还需要手动运行开始菜单里 iWebOffice2015 目录下的“修复配置”。解决：把这两步写进用户操作指引，别指望用户自己摸索。另外确认 admin.do 里版权支持信息填了安装说明里许可号双引号之间的字段，没填控件也起不来。

4.5 三员管理开启后 admin.do 进不去了

现象：手滑开启了三员管理，再访问 admin.do 直接拒绝。原因：手册第三章写得很清楚，开启三员管理后不能再访问 admin.do。解决：开启前三员管理前先确认三员管理操作手册的配置流程，并且确保有其它管理入口可用。如果已经开启又需要改底层参数，只能按三员管理手册的流程走，或者从数据库层面处理。这个开关没有后悔药，点之前想清楚。

5. 进阶技巧：用备份配置做参数对比与快速回滚

admin.do 的“备份配置文件”功能很多人只当成一个导出按钮，其实它最大的价值在于参数对比和快速回滚。我一般会在每次变更前先导出一份备份，命名带上日期和变更内容，比如admin_backup_20250115_redis_change.properties。改完之后如果系统异常，直接把备份文件导入回去再重启，比逐项回忆改了哪里快得多。更进一步，可以把两份备份文件用 diff 工具对比，快速定位本次变更了哪些参数。下面这个 bash 片段是我常用的对比方式：

# 假设两份备份文件在同一目录 diff -u admin_backup_before.properties admin_backup_after.properties > admin_diff.txt # 只看有变化的行，忽略注释和空行 grep -E '^[+-]' admin_diff.txt | grep -vE '^[+-]{3}' | grep -v '^[+-]$'

逻辑说明：diff -u输出统一格式的差异，grep过滤出真正变化的行，去掉文件头标记和空行。参数上没什么要调的，关键是养成“改前备份、改后备份、对比确认”的习惯。另外，全文索引配置里的定时任务时长默认 28800 秒，线程数默认 1 可设 1 到 10，搜索热词显示数量和时间范围按业务需求调。MQ 配置只有 URL、用户名、连接密码三项，JMX 端口可以在这里填也可以通过 JVM 参数指定。这些参数单独看都不复杂，但组合在一起改的时候，没有备份对比就很容易漏掉某一项。从那以后我每次动 admin.do 都强制走一遍“备份、改、再备份、diff、重启、验证”的流程，希望帮到你。

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