folioci/mod-settings

FOLIO - mod-settings

概述

mod-settings 是 FOLIO 生态系统的核心模块之一，专注于为 FOLIO 提供安全的全局设置与用户级设置管理功能。该模块支持系统级配置参数与个性化用户配置的存储、访问及维护，确保配置数据的安全性与可靠性。

代码仓库：https://github.com/folio-org/mod-settings

核心功能与特性

• 安全的配置管理：支持两种维度的配置管理，包括系统级全局配置（适用于所有用户）和用户级个性化配置（针对单个用户）。
• 配置数据安全：通过 FOLIO 统一安全机制保障配置数据的访问控制与传输安全。

使用场景

适用于 FOLIO 系统中需集中管理配置参数的场景，包括但不限于：

• 系统级默认参数配置（如全局权限策略、基础功能开关）
• 用户个性化偏好设置（如界面布局、通知偏好、数据展示选项）
• 跨模块配置数据共享与同步

技术规格与配置说明

核心参数

Docker 部署示例

基础运行命令

bash
docker run -d \
  --name mod-settings \
  -p 8081:8081 \
  -e DB_HOST=folio-db \
  -e DB_PORT=5432 \
  -e DB_NAME=folio_modules \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=folio_password \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  --memory=2g \
  folio/mod-settings

参数说明

• -p 8081:8081：将容器内模块服务端口 8081 映射至主机，供 FOLIO 其他模块或外部系统访问
• 数据库环境变量（DB_HOST、DB_PORT 等）：需根据实际数据库部署环境配置，模块启动前需确保数据库可连接
• --memory=2g：容器内存限制，对应技术规格中 2147483648 字节（2GB）
• JAVA_OPTIONS：Java 虚拟机参数，控制内存使用占比，确保模块在容器内高效利用内存资源

注意事项

• 模块依赖数据库连接，部署前需确保数据库已初始化并配置正确的访问权限
• 全局配置与用户级配置的权限控制需通过 FOLIO 统一权限系统实现，模块本身不包含独立权限管理功能
• 容器内存配置建议不低于 2GB，避免因内存不足导致服务异常