outsource/live-forum

Fork 0

zpc cc1c644b44 重新推送

2026-03-24 11:27:37 +08:00

9.7 KiB

Raw Blame History

AgileConfig 配置管理功能使用指南

功能概述

本系统集成了 AgileConfig 配置管理功能，允许管理员通过可视化界面管理业务项目的配置。配置修改后会自动推送到 AgileConfig 配置中心并发布，业务项目可实时获取最新配置。

快速开始

1. 访问配置页面

登录系统后，导航到：系统管理 > AgileConfig配置管理

2. 页面说明

配置页面包含以下几个部分：

页面顶部

测试连接 按钮：验证与 AgileConfig 服务器的连接状态
配置说明 区域：显示功能说明和注意事项

配置区域

配置按分组折叠展示，点击分组标题可展开/折叠：

应用配置 (AppConfig)
- 送花间隔时间
- 上传服务类型
- 上传配置（图片/视频大小、压缩质量等）
- 应用图标
数据库配置 (ConnectionStrings)
- 业务数据库连接字符串
JWT配置 (JwtTokenConfig)
- 访问令牌过期时间
- 受众、签发者、密钥
Redis配置 (Redis)
- Redis 连接字符串
- 实例名称
敏感词配置 (SensitiveWord)
- 缓存过期时间
- 词库路径
- 过滤模式
腾讯云COS配置 (TENCENT_COS)
- APPID、密钥
- 存储桶、域名
- 地域
微信小程序配置 (Wechat)
- AppId、AppSecret
- Token、EncodingAESKey

页面底部

保存配置 按钮：保存所有修改并自动发布
重置按钮：放弃所有修改，恢复到原始状态

3. 修改配置

修改步骤：

展开需要修改的配置分组
找到对应的配置项
修改配置值
点击"保存配置"按钮
等待保存成功提示

配置项类型说明：

数字输入框

送花间隔时间、图片压缩质量等
可以使用上下箭头或直接输入数字

文本输入框

数据库连接字符串、域名等
直接输入文本

下拉选择框

上传服务类型：cos（腾讯云COS）或 server（本地服务器）

密码输入框

JWT密钥、数据库密码、COS密钥等
显示为 ****，点击眼睛图标可显示/隐藏

图片上传

应用图标、帖子精华图标
点击上传按钮选择图片
支持拖拽上传

4. 保存配置

点击"保存配置"后，系统会：

增量更新：只更新修改过的配置项（未修改的配置项不会被更新）
自动发布：保存成功后自动发布到 AgileConfig 配置中心
实时生效：业务项目会在下次读取配置时获取最新值

5. 重置配置

如果修改后想撤销，点击"重置"按钮：

所有未保存的修改将被撤销
配置恢复到页面加载时的状态
需要确认操作

配置说明

应用配置 (AppConfig)

送花间隔时间 (FlowerSendInterval)

类型：数字（秒）
说明：用户送花的最小间隔时间
默认值：3600（1小时）
示例：设置为 7200 表示 2 小时

上传服务类型 (uploadServiceType)

类型：下拉选择
选项：
- cos：使用腾讯云COS存储
- server：使用本地服务器存储
说明：选择文件上传方式

上传配置 (upload_config)

图片压缩质量 (imagequality)

类型：数字（1-100）
说明：图片压缩质量，越高质量越好但文件越大
默认值：80
建议值：70-90

图片最大大小 (imagemaxsize)

类型：数字（KB）
说明：允许上传的图片最大大小
默认值：10240 (10MB)

视频最大大小 (videomaxsize)

类型：数字（KB）
说明：允许上传的视频最大大小
默认值：102400 (100MB)

COS域名 (cosdomain)

类型：文本
说明：腾讯云COS域名地址
格式：https://bucket-appid.cos.region.myqcloud.com

应用图标 (AppIcon)

类型：图片上传
说明：应用的主图标
支持格式：jpg, png, gif
建议尺寸：512x512 或更大

帖子精华图标 (AppPostEssenceIcon)

类型：图片上传
说明：标记精华帖子的图标
支持格式：jpg, png, gif
建议尺寸：64x64

数据库配置 (ConnectionStrings)

LiveForumConnection

类型：文本（多行）
说明：业务数据库连接字符串
格式：SQL Server 连接字符串

示例：

data source=192.168.195.15;User Id=sa;Password=xxx;
MultipleActiveResultSets=False;Encrypt=False;
initial catalog=LiveForumDB;pooling=true;max pool size=100

JWT配置 (JwtTokenConfig)

访问令牌过期时间 (accessTokenExpiration)

类型：文本（数字）
说明：访问令牌过期时间（分钟）
默认值：120
建议值：30-1440

受众 (audience)

类型：文本
说明：JWT受众（Audience）
默认值：MP

签发者 (issuer)

类型：文本
说明：JWT签发者（Issuer）
默认值：LiveForum

密钥 (secret)

类型：密码
说明：JWT签名密钥
要求：至少32位随机字符串

Redis配置 (Redis)

连接字符串 (Configuration)

类型：文本（多行）
说明：Redis连接字符串
格式：host:port,defaultDatabase=n
示例：192.168.195.15:6379,defaultDatabase=2

实例名称 (InstanceName)

类型：文本
说明：Redis键名前缀
默认值：LiveForum:

敏感词配置 (SensitiveWord)

缓存过期时间 (CacheExpiration)

类型：文本（数字）
说明：敏感词缓存过期时间（秒）
默认值：86400（24小时）

缓存键 (CacheKey)

类型：文本
说明：敏感词缓存键名
默认值：SensitiveWords:Industry

词库路径 (CommonWordsPath)

类型：文本
说明：敏感词库文件路径
默认值：wwwroot/sensitivewords

过滤模式 (Mode)

类型：文本
说明：敏感词过滤模式
选项：Filter（过滤）或 Replace（替换）

替换字符 (ReplaceChar)

类型：文本（单字符）
说明：替换敏感词的字符
默认值：*

腾讯云COS配置 (TENCENT_COS)

应用ID (APPID)

类型：文本
说明：腾讯云账号的APPID
获取方式：腾讯云控制台 > 账号信息

存储桶名称 (BUCKET_NAME)

类型：文本
说明：COS存储桶名称（不含APPID）

域名URL (DOMAIN_URL)

类型：文本
说明：COS访问域名
格式：https://bucket-appid.cos.region.myqcloud.com

最大大小 (MAX_SIZE)

类型：文本（数字）
说明：上传文件大小限制（MB）
默认值：100

地域 (REGION)

类型：文本
说明：COS地域标识
示例：ap-shanghai、ap-beijing

密钥ID (SECRET_ID)

类型：密码
说明：腾讯云API密钥ID

密钥KEY (SECRET_KEY)

类型：密码
说明：腾讯云API密钥KEY

微信小程序配置 (Wechat)

AppId

类型：文本
说明：微信小程序AppId
获取方式：微信公众平台 > 开发 > 开发设置

AppSecret

类型：密码
说明：微信小程序AppSecret
获取方式：微信公众平台 > 开发 > 开发设置

EncodingAESKey

类型：文本
说明：消息加密密钥
要求：43位随机字符串

Token

类型：文本
说明：消息校验Token
要求：3-32位字符串

注意事项

配置安全

敏感信息保护
- 数据库密码、API密钥等敏感信息显示为密码样式
- 建议定期更换密钥
权限控制
- 只有具有相应权限的管理员才能访问和修改配置
- 配置修改会记录操作日志

配置生效

自动发布
- 配置保存后会自动发布到 AgileConfig
- 无需手动发布操作
业务项目更新
- 业务项目会在下次读取配置时获取最新值
- 某些配置可能需要重启业务项目才能生效

最佳实践

测试环境验证
- 重要配置修改前建议在测试环境验证
- 确认配置正确后再应用到生产环境
备份配置
- 修改前可以记录原始配置
- 如有问题可快速回滚
批量修改
- 可以同时修改多个配置项
- 一次性保存，减少发布次数
配置验证
- 保存后验证业务功能是否正常
- 查看 AgileConfig 后台确认配置是否正确

常见问题

Q1: 配置保存后业务项目没有生效？

A: 可能原因：

业务项目使用了配置缓存，需要等待缓存过期
某些配置需要重启业务项目
检查业务项目的 AgileConfig 客户端配置是否正确

Q2: 测试连接失败？

A: 检查项：

AgileConfig 服务器是否正常运行
网络是否可达（防火墙、安全组设置）
用户名密码是否正确
应用ID和环境是否正确

Q3: 图片上传失败？