企业官网建设流程全解析

简介：面向蓝凌标准产品V16.0系统管理员与运维实施人员的配置参考手册，聚焦admin.do后台的各类基础参数设置，帮助读者解决部署与调优过程中配置项繁多、无从下手的实际问题。资源包共1个PDF文件，约2.65MB，内容按章节组织，从引言到基础配置逐项展开，涵盖数据库、全局参数、消息机制、存储、附件、Redis缓存、全文索引、MQ、JMX服务、日志参数、运营日志采集与GZIP压缩等模块，并延伸至系统安全与身份验证等章节。其中Redis部分细分为说明、安装部署与在本系统中的用途，便于按需查阅。目前已有956人学习，适合需要对照官方口径完成环境搭建、参数核对与日常维护的技术人员，可作为配置清单与排错时的案头资料。

1. admin.do 配置：一份 20 页手册里藏着多少“重启才能生效”的坑

拿到这份《标准产品 V16.0 管理员手册-admin.do 配置》PDF 的时候，我第一反应是“才 20 页，能有多复杂”。翻完才发现，这 20 页覆盖的是整个系统最底层、最不能出错的一层配置：数据库连接、Redis 缓存、附件存储、全文索引、MQ、JMX、日志采集、GZIP、身份验证、多服务器令牌环、集团分级授权、多语言、移动端 UA 适配，一直到后台角色分配和配置备份。手册开头就甩了一句狠话——admin.do 里的配置都是必须、需要、一定重启，配置完保存并备份后重启。这句话不是客套，是血泪经验：这一页改错一个字符，整个系统起不来是常态。

这份资料适合两类人：一是刚接手这套系统、需要把环境从零配到能跑的实施和运维；二是已经在跑、但遇到附件打不开、集群登录串号、日志表撑爆数据库这类问题、需要回头查参数的老手。它解决的不是“业务怎么配”，而是“底座怎么配才不翻车”。下面按我实际拆文档的顺序，把能抄作业的部分和容易翻车的地方分开讲。

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

2.1 数据库配置：连接类型和 URL 是第一个不能错的地方

数据库配置是整个 admin.do 的第一项，也是唯一一项“填错就什么都别谈”的配置。手册给的字段很克制：连接类型、数据库类型、连接 URL、用户名、密码。连接类型推荐 JDBC，JNDI 方式留给已有容器数据源的场景；数据库类型覆盖 SQLserver、ORACLE、MYSQL、DB2，以及神通、达梦这类国产库。URL 是 jdbc 形式，手册示例是jdbc:jtds:sqlserver://192.168.1.146:1433/ekp，注意这里用的是 jtds 驱动而不是微软官方驱动，老项目里很常见。

落地时我一般按这个顺序走：先确认数据库类型和驱动包是否已经在应用的 classpath 里，再填 URL，最后点“测试数据库连接”。手册特别说明这个 Test 是一次性连接、不做数据读写、无损测试，所以放心点，点不通就说明 URL、端口、库名、账号四者至少有一个不对。常见翻车是 URL 里库名写成了实例名，或者 ORACLE 用了jdbc:oracle:thin:@host:1521:orcl却把 service name 和 SID 搞混。这一步不通，后面所有配置都是空谈，别急着往下走。

2.2 全局参数：那几个默认值背后都有代价

全局参数这一节手册写得比较散，但有几个字段值得单独拎出来。服务器外网 DNS 填外网地址，内网 DNS 填 IP 形式，这两个值直接影响系统内部拼出来的链接和上线前测试。管理员帐号建议改成非 admin 的默认帐号，这是安全基线，不是可选项。视图默认显示行数默认 15，手册明确说建议值不要太大，防止使用者电脑配置差打开太慢——这条在低配客户端环境里非常真实。

最容易被忽略的是“帐户 trim() 函数”这一项。默认开启，但手册写得很直白：trim 会引起数据库检索性能下降，大用户量建议关闭；关闭后需要自己检查组织架构 Excel 导入和第三方同步引入的左右空格问题。这就是典型的“性能换数据质量”的取舍。我的做法是用户量过万就关掉 trim，然后在导入模板和同步接口侧做一次空格清洗，别指望数据库层兜底。样式调试模式也是同理：上线测试环境开启、生产环境关闭，开反了就是白白增加访问压力。

2.3 Redis 缓存：启动顺序比参数更重要

Redis 这一节是整份手册里语气最重的：配置必须在 Redis 启动之后进行，Redis 宕机会导致系统无法使用，配置后的启动顺序是先启动 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 # 编译 make # 进入 src 目录启动服务端 cd src && ./redis-server # 另开终端用内置客户端验证读写 ./redis-cli

这段命令的逻辑很直白：make编译出可执行文件，redis-server前台启动，redis-cli里set foo bar再get foo能返回"bar"就说明实例是活的。参数上要注意的是，生产环境别用前台裸启动，至少配daemonize yes和持久化策略；手册没展开这些，但这是合格运维的默认动作。Redis 在本系统里有两个用途：一是缓存机制（非必须，勾选才走 Redis），二是会话管理（集群环境和多服务器 SSO 环境必须勾选）。这两条决定了你后面集群能不能做单点登录，别等到上线才发现没开。

2.4 附件与存储：路径权限和加密兼容性是两大雷区

附件配置字段多，但真正会让人半夜爬起来的是三个：附件存放位置、大小限制、上传类型白名单/黑名单。存放位置默认c:/landray/kmss/resource，Linux 改成/usr/local/landray/kmss/resource，手册特意强调目录需要具有可写权限——这句话翻译过来就是“权限没给对，上传全部失败，日志里还不一定写得清楚”。普通附件和图片附件的大小限制分开配，大图宽度默认 1024、小图宽度默认 512，设 0 表示不压缩，这两个值直接决定列表页和查看页的加载速度。

不允许上传的附件类型格式是.js;.bat;.exe;.sh，分号分隔；只允许上传的类型同理。这里有个细节：手册提醒 WPS 文件的实际扩展名是.wps或.jar，白名单里漏了就等于用户传不上去。存储配置那边，文件存储可以选加密方式，不加密、简单加密、AES 加密之间互相兼容但都“稍微影响性能”，选之前想清楚历史附件要不要兼容。阿里云对象存储和 F4OSS 各自要填 EndPoint、Bucket、根目录或签名地址，这些属于对接参数，填错的表现是上传成功但下载 404，排查时先看 Bucket 和根目录拼出来的路径对不对。

3. 系统安全与集团应用：令牌环、三员和分级授权的边界

3.1 身份验证与单一用户限制：例外人员是后悔药

本系统身份验证这一项，用在和第三方认证系统（LDAP、AD、其它同构系统）集成之后。开启禁用意味着本系统不再做用户名密码校验，但手册补了一句关键：例外人员里的超管帐号依然在本系统验证，而且两边必须有用户名一致的对应用户。这就是典型的“集成后把自己锁在门外”的预防针——先把例外超管配好，再开禁用。

会话管理的单一用户限制解决的是“同一账号全系统只允许一端登录”，A 在某个浏览器登录后，别人再用 A 的账号登录会把 A 强制下线。例外是通过 SSO 单点的用户不会失效。启用前提写得很清楚：有集群要配 Redis 才生效，启用多服务器也要同时启用 Redis，单机不启多服务器则直接生效。很多人配完发现不生效，八成是 Redis 没勾或者没起。

3.2 多服务器验证：令牌环参数怎么对齐

多服务器验证是为了跨系统共享令牌环、登录一次免登进入其它系统。以 Domino 的 LtpaToken 方式为例，字段包括密钥类型（Domino 令牌环或自主 LRToken）、作用域（一般直接写后缀，可填多个域共用）、有效期、是否用 Redis 存储有效期、令牌环名称、密钥、登录关键字（默认 CN）。这里最容易翻车的是“多套系统令牌环名称和密钥必须保持一致”，密钥可以随机生成一组再拷贝到其它系统，拷贝漏一个字符就是免登失败。勾了“使用 Redis 存储有效期”就必须先启用 Redis 缓存，用户每次访问会延长有效期，取不到 Redis 时才回落到上面的固定有效期。

3.3 三员管理与集团分级授权：开了就回不去

三员管理默认关闭，手册一句话带过但分量很重：开启后不能再访问 admin.do。也就是说这是一个单向门，开之前必须把该配的都配完，具体参考单独的三员管理操作手册。集团分级授权和组织场所同步是集团型部署的核心：场所见数据隔离开启后各场所相互独立，隔离方向可以对本场所、对上级、对下级分别可见；机构同步分平级和层级，部门同步创建 N 级对应场所，管理员同步和场所漫游同步按需开。多语言支持开启后登录页出现语言切换，官方语言是所有用户的默认语言，集群模式下还要靠这一项保证通讯安全（密钥）、节点标识和起始端口加 20 不冲突。多域名支持手册直接说当前网络条件下一般不开，这种“官方劝退”的配置就别硬上了。

4. 应用配置与日志：全文索引、MQ 和日志容量的算法

4.1 全文索引与 MQ：线程数和定时任务时长怎么定

全文索引配置里，定时任务时长按秒算，手册给的参考值是 28800（8 小时），线程数默认 1、可设 1 到 10。我的经验是线程数别一上来拉满，先按 CPU 核数的一半给，观察索引延迟再调；搜索热词显示数量、相关搜索词数量、热词时间范围（比如 30 天）这些是前台体验参数，按运营需求调。是否启用独立搜索只对单独部署搜索应用或自定义搜索有意义，和统一搜索、其它搜索引擎无关，别看到“独立”两个字就勾。

MQ 配置只有 URL、用户名、连接密码三项，作用是让消息发送不走系统内部而通过 MQ server 处理。JMX 端口可以在这里填，也可以通过 JVM 参数指定，二选一，别两边都配导致端口冲突。这两块配置本身简单，难的是“配了但没验证”——MQ 配完要实际触发一条通知看是否经 MQ 出去，JMX 配完要用管理工具连一下端口，不然等于没配。

4.2 日志参数与运营日志：容量估算必须提前算

日志参数分本地文件存储和数据库存储，默认数据库存储。运营日志比操作日志记录更详细，用于热点分析和使用情况分析，可以上传到服务网站查看图表，不需要就关掉。手册给了一个非常实用的容量估算：每个节点每天大约产生 100M 日志文件，访问量大可能到 200M，超过 200M 说明单台服务器请求已经超负荷；5 个节点、保留 30 天，容量约5 * (30 + 1) * 100M = 15500M，其中加 1 是当天。这个公式我每次做部署方案都会抄一遍，因为它直接决定磁盘规划。

各类日志的备份天数默认 7 天、清除备份天数默认 90 天，记录错误日志条数可以限制每天入库的错误日志上限。开启运营日志后可以禁用系统操作日志，但禁用后就不能直接从系统查看操作日志——这是取舍，不是优化。GZIP 压缩开启后压缩传输数据、降低压力，属于低风险高收益项，生产环境基本都开。

4.3 移动端与表单：UA 和 JSP 重新生成别忘

移动组件扩展配置里，扩展支持的 UA 默认已适配大部分手机，遇到识别不了的机型，在手机上访问域名/third/pda/ua.jsp拿到 UA 再补进去。移动终端访问域名可以填专属地址，跳过 UA 识别直接展现移动端；仅允许移动端访问开启后 PC 端（Win、MAC）就进不来；禁止本服务器的登录功能配合 SSO 多服务器时使用；代理服务器用于系统访问不到外部第三方时做连通。移动端开发模式只用于上线前调样式，二维码分享开启后文档查看页会显示二维码。

表单配置这块主要是移动端对自定义 JSP 的支持，手册用加粗提醒：切换此功能务必重新生成 JSP，入口在后台管理员工具箱。这一条我见过太多人漏掉，表现是移动端页面还是旧样式，查半天以为是缓存，其实是 JSP 没重新生成。后台配置里的角色分配按群组角色、考勤管理员、模块管理员区分权限，模块管理员才有对应访问权限；备份配置文件导出后要妥善保存，手册原话是“以防泄漏”——这份导出文件里是明文连接信息，别随手丢在共享目录。

5. 避坑排查：五条从现场捡回来的记录

5.1 改完配置没重启，现象是“改了跟没改一样”

现象：在 admin.do 改完参数、点了保存，前台行为完全没变化。原因：手册开篇就写明这些配置一定需要重启，保存只是落盘。解决：保存后先备份配置，再按“先 Redis 后应用”的顺序重启；集群环境逐节点重启并观察，别一次性全停。

5.2 Redis 没起或后起，系统直接不可用

现象：应用启动后大量报错、页面打不开。原因：Redis 宕机或启动顺序反了，而缓存和会话都压在 Redis 上。解决：把“先 Redis 后应用”写进启动脚本和值班手册；Redis 做持久化和监控，别当前台进程裸跑。

5.3 附件上传全失败，日志却语焉不详

现象：所有附件上传报错，下载历史附件正常。原因：附件存放目录没有可写权限，或白名单漏了实际扩展名（比如 WPS 的.wps/.jar）。解决：先ls -ld看目录属主和权限，再核对只允许上传类型的后缀清单；改完记得重启。

5.4 集群下单一用户限制不生效

现象：同一账号还能在多端同时在线。原因：启用了集群或多服务器但没勾 Redis，会话管理没有共享存储。解决：确认 Redis 已启用且连通，再验证单一用户限制；SSO 单点用户本来就不受此限制，别误判。

5.5 日志表把数据库撑爆

现象：数据库体积异常增长，查询变慢。原因：日志默认走数据库存储，备份和清除天数没按访问量调。解决：按每节点每天 100M 到 200M 估算容量，调小备份天数、设好清除天数，访问量大的环境考虑本地文件存储或独立日志组件。

6. 进阶技巧：把 admin.do 当配置基线来管

这份手册最值钱的用法，不是出问题时翻，而是部署时当基线清单用。我的习惯是：新环境按“数据库 → 全局参数 → Redis → 附件存储 → 全文索引/MQ → 安全 → 集团应用 → 应用配置 → 日志”的顺序过一遍，每改完一个大项就导出一次备份配置文件，按环境名加日期归档。这样做的直接好处是，下次迁移或扩容时不用凭记忆重配，直接对照上一份导出逐项核对，差异一目了然。

几个值得固化成检查项的参数：帐户 trim() 在大用户量环境关闭并配套导入清洗；视图默认显示行数控制在 15 上下；附件目录权限和上传类型白名单每次部署都验一遍；Redis 启动顺序写进脚本；日志容量按节点数 × (保留天数 + 1) × 100M提前算磁盘；三员管理开启前确认不再需要 admin.do。下面这张表是我自己用的最小核对表：

验证方法也别偷懒：数据库看测试连接，Redis 看redis-cli读写，附件实传实下，令牌环跨系统真登一次，日志看表增长。配置这东西，没实测过就等于没配。从那以后我每次动 admin.do，都强制先导出备份、改完重启、再按清单逐项实测一遍，宁可多花二十分钟，也不想再经历一次“改了一个参数、排查一整天”的循环。希望帮到你。

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