企业官网建设流程全解析

简介：这份PDF文档面向蓝凌标准产品V16.0的系统管理员与实施运维人员，聚焦admin.do后台的配置操作，帮助读者解决部署与日常管理中参数设置不规范、组件对接不清晰等问题，适合具备一定企业信息化系统运维基础的技术人员查阅。资源包共1个文件，为PDF格式，大小约2.65MB，内容按章节组织，涵盖数据库、全局参数、消息机制、存储、附件、Redis缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集与GZIP压缩等配置项，并延伸至系统安全与身份验证等模块，目录层级清晰，便于按需检索。目前已有956人学习下载，说明其在同类管理员手册中具有一定参考价值。读者可借助它系统梳理各基础组件的配置要点与用途说明，对照检查现有环境的参数设置，减少因配置疏漏导致的运行异常，也可作为团队内部培训与交接时的操作依据。

1. 装完 EKP 才想起 admin.do：V16.0 里那套“改完必须重启”的配置

上周帮一个朋友救火，蓝凌 EKP V16.0 部署完，登录页能开，但附件传不上去、待办不推送、集群下两个人互相被踢。翻日志翻了半天，最后发现问题全出在admin.do这个后台配置页——数据库连的是测试库、Redis 没启、附件目录权限是 root 的。这套配置页看着朴素，实际是整个系统的黑匣子：基础配置、系统安全、集团应用、应用配置四大页签，每一项都写着“必须、需要、一定重启”。装蓝凌标准产品 V16.0 的人绕不开它，新手照着点容易漏项，熟手也常在版本差异上翻车。这篇就把我从装环境到验证跑通的完整路径记下来，照着走能少踩几个坑。

2. 装前把环境列清：V16.0 的依赖清单与版本取舍

2.1 数据库与连接方式怎么选

admin.do第一项就是数据库配置，这是业务系统的核心，填错后面全白搭。连接类型推荐 JDBC，JNDI 方式留给已有容器数据源的场景。数据库类型支持 SQLserver、ORACLE、MYSQL、DB2、神通、达梦，URL 必须是 jdbc 形式：

# SQLserver 走 jtds 驱动的典型写法 jdbc:jtds:sqlserver://192.168.1.146:1433/ekp # MySQL 的写法（驱动版本跟数据库大版本对齐） jdbc:mysql://192.168.1.146:3306/ekp?useUnicode=true&characterEncoding=utf8

URL 里的 IP、端口、库名按实际环境替换，库名一般就是ekp。这里有个取舍：SQLserver 用 jtds 驱动兼容性好，但如果你环境里已经统一用微软官方驱动，就按官方写法来，别混用。填完先点“测试数据库连接”，这是一次性 Test 连接，不做数据读写，无损，测通了再保存。

2.2 Redis 装在哪、什么版本

Redis 是这套系统里最容易翻车的组件，手册里写得很直白：Redis 宕机会导致 EKP 无法使用，启动顺序必须先 Redis 后 EKP。手册给的示例版本是 5.0.2，编译安装：

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 目录启动 src/redis-server

make之前确认机器上有 gcc 和 make，缺了会直接报错。启动后用内置客户端验证：

src/redis-cli redis> set foo bar OK redis> get foo "bar"

能 set 能 get 就说明服务活着。生产环境我一般会改redis.conf里的bind和requirepass，别裸奔在公网网卡上。Redis 在本系统里干三件事：缓存机制（非必须，勾选才用）、会话管理（集群环境和多服务器 SSO 环境必须勾选）、以及令牌环有效期的存储。这三项决定了你后面集群能不能跑起来。

2.3 附件目录与存储方式的前置准备

附件存放位置默认是c:/landray/kmss/resource，Linux 改成/usr/local/landray/kmss/resource，目录必须具有可写权限。这一步很多人栽在权限上：用 root 建了目录，应用跑在普通用户下，上传直接 500。我一般这么做：

mkdir -p /usr/local/landray/kmss/resource chown -R ekp:ekp /usr/local/landray/kmss/resource chmod -R 755 /usr/local/landray/kmss/resource

存储方式三选一：文件存储、阿里云对象存储、F4OSS 文件存储。选文件存储时还要定加密策略——不加密、简单加密、AES 加密，三者互相兼容但都“稍微影响性能”。我的建议是新建环境直接用 AES 加密，老系统迁移过来先保持原策略，别在迁移窗口里改加密方式，否则历史附件读不出来。

2.4 全文索引、MQ、JMX 的启用判断

全文索引依赖蓝凌统一搜索独立组件，定时任务时长按秒算，一般填 28800（8 小时），线程数默认 1，可设 1 到 10。搜索热词显示数量、相关搜索词数量、热词时间范围（比如 30 天）按运营需求填。是否启用独立搜索只跟“单独部署一应用作为搜索用”或 KMS 自定义搜索有关，跟统一搜索或其他搜索引擎无关，别乱勾。

MQ 配置只有三项：URL、用户名、连接密码，消息队列发送不走 EKP 内部而走 MQ server 时才需要。JMX 端口有两种指定方式，admin.do 里填或者 JVM 参数指定，二选一，别两边都配导致端口冲突。

3. 逐项配置 admin.do：从数据库到消息机制的落地步骤

3.1 全局参数里几个容易写错的字段

全局参数配置里有一批综合参数，看着杂但每个都有坑。服务器外网 DNS 填外网地址，内网 DNS 填 IP 形式如http://192.168.0.1/ekp，供上线前测试用。管理员帐号建议改成非 admin 的默认帐号，这是安全基线。视图默认显示行数默认 15，别贪大，使用者电脑配置差时打开会明显变慢。

获取客户端 IP 地址参数和获取 http 协议参数，都要去服务器DNS/resource/jsp/testip.jsp页面看实际能显示的字段，填错了日志分析里 IP 全是空的。样式调试模式：上线测试环境开启（样式不缓存，便于调整），生产环境关闭（降低访问压力）。帐户 trim() 函数默认开启，但大用户量下 trim 会引起数据库检索性能下降，建议关闭——关闭后要自己检查组织架构 Excel 导入和第三方同步引入的左右空格问题，这个坑我见过不止一次。

3.2 消息机制：默认勾选所有通道是大忌

消息机制提供全系统通知通道：待办、Email、短消息（短信）、DING 消息。启用通知方式后，Notify 类的业务（流程待办待阅提醒、任务下发提醒）才能选对应通道。短信需要短信系统集成的独立组件配合。

手册里专门标了一句“默认通知方式的意思是：默认勾选所有通道！（不建议）”。原因很实际：全通道默认勾选意味着每条待办都同时发邮件、短信、DING，短信是要花钱的，用户也会被轰炸。我一般只默认勾待办，Email 和 DING 按部门策略开，短信只留给审批超时这类关键节点。JDBC 监控启用后可以在“管理员工具箱-请求监控-查看 JDBC 监控”看结果，排查慢查询时很有用，平时可以关着。

3.3 附件配置：大小限制、类型白名单与转换服务

附件配置分两块：附件本身和附件转换服务。普通附件大小限制、图片附件大小限制按业务定；大图宽度默认 1024 像素、小图宽度默认 512 像素，超过才压缩，设 0 则完全不压缩——大图用于查看页，小图用于列表页，设 0 会让列表页加载变慢，不建议。

不允许上传的附件类型基于安全考虑，格式如.js;.bat;.exe;.sh，分号分隔；只允许上传的类型如.docx;.xlsx;.txt;.pdf，注意 WPS 文件实际扩展名是.wps或.jar，白名单里漏了就会有人传不上来。金格控件不配不影响上传下载，只影响在线编辑批注；附件转换服务不配也不影响上传下载，但移动端等不具备 Office 的环境要阅读附件就必须配。第一次启用金格控件或控件版本更新，客户端 IE 访问会提醒下载控件，Chrome 第一次用不会提醒，得先用 IE 装一遍；Chrome 里加载 iWebOffice2015 失败时，让客户端手动运行开始菜单里 iWebOffice2015 目录下的“修复配置”。

3.4 日志参数与运营日志采集的容量账

日志参数包括本地文件存储和数据库存储，默认数据库存储。操作日志、登录/登出日志、应用日志、错误日志、后台日志各有备份天数，默认 7 天，7 天前的自动备份到历史日志表；清除备份天数默认 90 天。记录错误日志条数可以限制每天入库的错误日志数量，防止异常刷爆数据库。

运营日志比操作日志记录更详细，用于热点分析、使用情况分析，开启后可以禁用系统操作日志，但禁用后就不能直接从系统查看操作日志了。容量要提前算：一般每个节点每天约 100M 日志文件，访问量大可能到 200M，超过 200M 说明单台服务器请求已超负荷。5 个节点、保留 30 天，就是 5 × (30 + 1) × 100M = 15500M，那个 +1 是当天的日志。磁盘规划时把这个数留出来，别等写满了才发现。

4. 系统安全与集团应用：会话、令牌环与多语言

4.1 单一用户限制与 Redis 的绑定关系

本系统身份验证用于和第三方用户认证系统（LDAP、其它 EKP、AD 等）集成后。开启禁用则本系统不做用户名密码校验，例外人员里的超管帐号仍在本系统验证。注意：开启后虽然不做校验，但要确保两边有对应的用户，用户名一致。

会话管理的单一用户限制适用于全系统只允许一端登录的场景：A 用户在 Chrome 登录后，别人用 A 的账号再登录，会强制下线前一个。例外是通过 SSO 单点的用户不会失效。启用前提很关键：有集群需要配置 Redis 才生效，启用多服务器也需要同时启用 Redis，单 EKP 且不启用多服务器才直接生效。这就是为什么 Redis 那章要先装——安全配置依赖它。

4.2 多服务器验证的令牌环参数

多服务器验证用于多套系统之间共享令牌环，浏览器或 APP 登录一次进入其它系统免登。以 Domino 的 LtpaToken 方式为例，密钥类型可选 Domino 令牌环或 EKP 自主 LRToken，按对接系统选。作用域一般直接填后缀，可填多个域共用；有效期指定令牌环有效时间，过期需重新登录；使用 Redis 存储有效期必须先启用 Redis 缓存，用户每次访问会延长有效期，类似 session。令牌环名称任意但多套系统必须一致，密钥可以随机生成一组拷贝到其它系统，登录关键字默认 CN。

4.3 三员管理与集团分级授权

三员管理默认关闭，开启后不能再访问 admin.do，具体配置参考三员管理操作手册。这是个单向门：开了就回不去 admin.do，上线前想清楚，测试环境先演练一遍。

集团分级授权里，场所见数据隔离开启后各场所相互独立；隔离方向分三种：对本场所数据可见、对上级场所数据可见、对下级场所数据可见。机构同步分平级同步和层级同步，部门同步同步创建 N 级对应场所，管理员同步按需开启，场所漫游同步可选直属用户或全部用户。多语言支持开启后登录页可切换语言，官方语言是所有用户默认语言，语言样式定义单屏、多屏滑动、随机背景三种登录页。集群模式下要开启附加功能，保证通讯安全（密钥）、系统独立（节点标识）、不受干扰（起始端口 +20 不同）。

5. 避坑排查：admin.do 配置里最常见的五个翻车现场

5.1 改完配置没重启，以为配置没生效

现象：保存了数据库或 Redis 配置，页面刷新还是旧行为。原因：admin.do 里的配置都是“必须、需要、一定重启”，保存配置并备份配置后必须重启。解决：养成“保存 → 备份配置 → 重启 → 验证”的固定动作，备份配置文件导出后妥善保存，防泄漏也防手滑。

5.2 Redis 先于 EKP 启动的顺序搞反

现象：EKP 启动报缓存相关错误，或集群下会话丢失。原因：Redis 宕机会导致 EKP 无法使用，启动顺序必须先 Redis 后 EKP。解决：把启动脚本里的顺序固定死，Redis 健康检查通过再拉起 EKP；Redis 配置必须在 Redis 启动之后配。

5.3 附件目录权限不对导致上传失败

现象：附件上传报错或 500，日志里是权限拒绝。原因：目录用 root 创建，应用用户无写权限。解决：按 2.3 节 chown 到应用用户，chmod 755，Linux 路径确认是/usr/local/landray/kmss/resource而不是默认的 Windows 路径。

5.4 附件类型白名单漏了 WPS 后缀

现象：用户传 WPS 文档被拒。原因：只允许上传的类型里没写.wps、.et、.dps，而 WPS 文件实际扩展名可能是.wps或.jar。解决：白名单按实际办公软件补齐，改完重启验证。

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

现象：开启三员管理后 admin.do 打不开。原因：这是设计行为，开启后不能再访问 admin.do。解决：开启前导出备份配置文件，配置变更走三员管理操作手册的流程；测试环境先验证一遍再上生产。

6. 装完怎么验证：一套五分钟跑通的检查清单

配置全部保存、备份、重启之后，别急着交付，按这套清单走一遍。先看登录：用非 admin 的超管帐号登录，确认身份验证和会话策略符合预期；再开两个浏览器用同一账号登录，验证单一用户限制是否按预期踢人（集群环境记得先确认 Redis 已启用）。

附件链路单独验：传一个普通文档、传一张超过 1024 像素的大图、传一个白名单外的.exe，三个动作分别验证上传成功、图片被压缩、非法类型被拒。移动端如果有转换服务需求，用手机打开一个 Office 附件看能否在线阅读。

数据库和缓存用监控确认：管理员工具箱里看 JDBC 监控是否有数据，Redis 用redis-cli ping确认返回 PONG。日志方面，触发一次登录登出，去日志参数页确认登录日志有记录、IP 地点显示正常。

这套清单我每次交付前都强制走一遍，有一次就是靠“传非法类型”那步发现白名单被前一个人改宽了。从那以后我每次改完 admin.do 都先导出备份配置文件再重启，验证清单一项不落。希望帮到你。

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