简介面向蓝凌标准产品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、用户名、密码。连接类型推荐 JDBCJNDI 方式留给已有容器数据源的场景数据库类型覆盖 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/resourceLinux 改成/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线程数和定时任务时长怎么定全文索引配置里定时任务时长按秒算手册给的参考值是 288008 小时线程数默认 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。下面这张表是我自己用的最小核对表配置项关键参数验收动作数据库连接类型、URL、库名点测试连接通过Redis缓存、会话管理勾选先起 Redis 再起应用附件存放路径、大小、类型白名单实传一个附件并下载日志存储方式、备份/清除天数按容量公式核磁盘安全例外人员、令牌环名称密钥跨系统免登实测一次验证方法也别偷懒数据库看测试连接Redis 看redis-cli读写附件实传实下令牌环跨系统真登一次日志看表增长。配置这东西没实测过就等于没配。从那以后我每次动 admin.do都强制先导出备份、改完重启、再按清单逐项实测一遍宁可多花二十分钟也不想再经历一次“改了一个参数、排查一整天”的循环。希望帮到你。本文还有配套的精品资源点击获取