LingMeng V2.0

深浅模式

系统配置总览 ​

系统设置 → 系统配置 是灵萌全站级配置的集中入口。下方卡片可快速定位各 Tab；保存后多数项立即生效，带测试按钮的项须点通后再用于生产。

系统设置 → 系统配置12 个 Tab全站级配置
  • 需超级管理员或「系统配置」写权限
  • 微信支付 / 支付宝需 payment 模块
  • 文件存储需 cloud_storage 模块
  • 视频水印需 watermark 模块

建议配置顺序

首次上线按此顺序逐项完成，有测试按钮的 Tab 须点通再进入下一步

  1. 1微信小程序 + 公众号登录、订阅消息、H5 授权
  2. 2文件存储Logo、轮播、头像上传
  3. 3高德地图定位、距离限制、外卖跑腿
  4. 4腾讯云短信手机验证码（若需要）
  5. 5微信支付 + 支付宝收费、红包、提现
  6. 6区域配置决定单区还是多区
  7. 7功能与上传上传限制、新用户资料
  8. 8阿里云IP 归属地、快递查询（按需）
  9. 9视频水印视频业务按需
  10. 10系统信息查看版本、清缓存

微信生态

小程序、公众号登录与消息触达

支付

需 payment 模块已开通

存储 · 地图 · 短信

上传、定位与验证码基础设施

运营规则

区域模式、上传与用户侧体验

媒体 · 系统

配置详情 ​

系统配置示意

Tab 1：微信小程序 ​

作用： 小程序登录、小程序支付、订阅消息、获取手机号等。

字段必填在哪里找说明
小程序 AppID用小程序时必填微信公众平台 → 开发 → 开发管理 → 开发设置形如 wx 开头，勿与公众号 AppID 混用
小程序密钥 AppSecret必填同上，需管理员扫码后重置/查看泄露后立即在微信后台重置
原始 ID可选公众平台 → 设置 → 账号信息以 gh_ 开头，不是 AppID
Access Token只读系统自动刷新无需手填
立即获取 Token—填完 AppID/Secret 后点击成功=连通；失败检查 Secret 与服务器出网

操作步骤：

  1. 登录微信公众平台 → 复制 AppID、AppSecret
  2. 管理后台 系统设置 → 系统配置 → 微信小程序 Tab 粘贴
  3. 点击 立即获取 Token，提示成功
  4. 到 区域管理 → 用户配置 开启「允许微信小程序登录」
  5. 小程序后台 开发管理 → 开发设置 → 服务器域名 添加你的 API 域名

常见错误：

现象处理
Token 失败Secret 多空格；用了公众号 Secret；服务器无法访问 api.weixin.qq.com
小程序能打开但不能登录区域 用户配置 未开微信登录；AppID 与打包小程序不一致
订阅消息发不出需在 通知控制台 → 微信模板 单独配置模板 ID

→ 详见 微信功能开启

Tab 2：微信公众号 ​

作用： H5 网页微信登录、公众号模板消息。

字段必填在哪里找
公众号 AppIDH5 微信登录必填公众平台 → 开发设置（与服务号/订阅号对应）
公众号密钥必填同上
公众号原始 ID可选账号信息页 gh_
立即获取 Token—同小程序

额外必须在微信后台配置：

  1. 设置与开发 → 公众号设置 → 功能设置 → 网页授权域名
    填你的站点域名（不含 https://），须与 网站信息、初始化向导中的 网站地址 一致
  2. 若用模板消息：广告与服务 → 模板消息 申请模板

Tab 3：微信支付 ​

需 payment 模块已开通

作用： 用户支付、红包、转账、提现自动打款。

字段必填在哪里找说明
商户号必填微信商户平台10 位数字
支付密钥必填商户平台 → 账户中心 → API 安全注意 v2/v3 版本，按页面提示填
v3 证书序列号v3 必填API 证书管理证书过期需更新
支付公钥 ID部分场景商户平台验签用
转账场景 ID自动打款需要产品中心 → 商家转账 申请场景未申请勿开自动提现
CERT 证书退款/转账等下载 apiclient_cert.pem完整 PEM，含头尾行
KEY 私钥同上下载 apiclient_key.pem勿与公钥搞反
支付公钥v3 验签商户平台下载—

商户平台必配回调 URL：

text
https://你的域名/api/payment/wx-notify

路径：产品中心 → 开发配置 → 支付配置 → Native/JSAPI 等 → 通知 URL

操作 checklist：

  • [ ] 商户号与小程序 AppID 已在商户平台 AppID 账号管理 中绑定
  • [ ] 回调 URL 已填且为 HTTPS
  • [ ] 证书与密钥已粘贴保存
  • [ ] 发起 0.01 元测试单，财务管理 → 资金交易 有记录

→ 详见 支付与提现

Tab 4：支付宝 ​

需 payment 模块已开通

字段必填说明
App ID必填支付宝开放平台 应用 ID
生产环境上线必开关=沙箱，开=生产；密钥与环境必须匹配
应用私钥必填RSA2 私钥，不是应用公钥
支付宝公钥必填开放平台提供的 支付宝公钥，不是你自己生成的应用公钥

回调 URL：

text
https://你的域名/api/payment/alipay-notify

在开放平台应用 → 开发设置 → 接口加签方式 配置。

Tab 5：文件存储 ​

需 cloud_storage 模块已开通

字段说明
存储方式本地 / 腾讯云 COS / 阿里云 OSS / 七牛云
云存储时本地备份建议开启，云+本地双份更安全

选「本地」 ​

  • 文件存在服务器磁盘，适合小规模、内网
  • 需保证 uploads 目录可写，且 Nginx 能访问静态文件 或通过 API 代理

选「腾讯云 COS」 ​

字段来源
SecretId / SecretKey腾讯云 CAM
Bucket形如 name-1250000000
Region如 ap-guangzhou，须与 Bucket 一致
访问域名CDN 或 COS 默认域名，必须公网 HTTPS 可访问

选「阿里云 OSS」 ​

字段来源
AccessKeyId / AccessKeySecretRAM 控制台
Bucket / EndpointOSS 控制台（注意内网/外网 Endpoint）
访问域名绑定 CDN 域名

选「七牛云」 ​

字段来源
AccessKey / SecretKey七牛控制台
Bucket / 访问域名须 HTTPS 绑定
存储区域与 Bucket 区域一致（华东/华北/华南等）

保存前点击「连接测试」，上传测试文件成功后再用于生产。

→ 详见 文件存储

Tab 6：腾讯云短信 ​

字段必填来源
SdkAppId必填短信控制台
短信签名必填控制台 → 签名管理（须审核通过）
模板 ID必填正文模板（验证码类）
测试手机号测试用11 位手机号，点 发送测试

TIP

短信测试用的 SecretId/Key 若此处留空，会 复用文件存储 Tab 里腾讯云 COS 的密钥。

到 区域管理 → 用户配置 开启「注册/登录验证码」后才会实际发送。

→ 详见 短信验证码

Tab 7：高德地图 ​

字段必填类型说明
Key (原生)后端必填Web 服务POI 搜索、距离计算等后端接口
WebKey (JS API)前端必填Web端(JS API)H5/小程序地图组件
安全密钥JS API 必填jscode2021 年后前端必配，否则地图报错

申请地址：高德控制台

注意： Web 服务 Key 和 JS API Key 不是同一个，各填各的输入框。

→ 详见 地图与定位

Tab 8：阿里云 ​

主要用于 IP 归属地（距离限制）、快递查询、地址解析等。

字段说明
IP 归属地接口四选一，见下表
AppCode阿里云市场 AppCode（lundear/kzipquery 查 IP 必填；选高德 IP 或 ip2region 时可不填，但快递等仍可能需要）
选项配置值适用场景
IP/IPv6 归属地查询lundear有 CDN、需 IPv6
高精准全球 IPkzipquery纯 IPv4、无 CDN
高德高级 IPamap已有高德 Web 服务 Key
ip2region 离线库ip2region本地 xdb，无需 AppCode；见 地图与定位

页面内 前往开通 链接可跳到对应商品页。

Tab 9：区域配置 ​

字段说明
区域模式平台模式（全站单区）/ 多区域自选 / 固定区域
固定区域选「固定区域」时，点 选择 指定区域 ID，不能填 0
首次须选区域仅 多区域自选：开启时用户须先进入区域选择页；关闭时可直接进入平台页
隐藏平台入口仅 多区域自选：开启后区域选择页不展示「平台」选项
平台距离限制（米）多区域自选下进入「平台」的最大距离，默认 1000；0 表示不限制
平台中心纬度 / 经度平台距离校验圆心（GCJ-02）；未填则不校验
模式用户侧表现
平台模式所有人不绑定区域，无需选择
多区域自选可配置是否必须先选区域、是否展示平台入口
固定区域新用户自动绑定指定区域

与 区域管理 配合：此处定 规则，区域列表定 有哪些区域。

Tab 10：功能与上传 ​

字段说明建议
显示公众号绑定前端是否展示「关注公众号」入口需同时上传二维码
新用户信息模式空白 或 随机头像昵称空白=用户自己填；随机=减少冷启动空白感
公众号二维码引导关注的图片从媒体库上传
禁止的后缀上传黑名单，逗号分隔 不含点如 exe,bat；留空=内置默认黑名单
最大文件大小（MB）单文件上限，默认 20须 ≤ Nginx client_max_body_size 与后端限制

区域级上传规则可在 区域管理 → 笔记配置 等页面覆盖。

Tab 11：视频水印 ​

需 watermark 模块已开通；视频封面与整段视频水印依赖服务器 ffmpeg + ffprobe 均在 PATH 中可执行（见页内「服务端媒体依赖」检测）。宝塔软件商店 FFmpeg 插件常缺 ffprobe，建议用终端 apt/yum/dnf install ffmpeg 安装完整包，见 快速部署。

字段说明
启用水印总开关
水印类型文字（须 .ttf 字体 URL）或 图片
视频封面也打水印封面图叠加
视频文件打水印整段视频（仅图片水印；需 ffmpeg）

文字水印额外字段： 文案、字号、颜色、描边、字体文件 URL（必须 .ttf 公网可访问）

图片水印额外字段： 水印图 URL、相对宽度（0～1）

位置： 左上/右上/居中/左下/右下 + 透明度 + 边距 X/Y

Tab 12：系统信息 ​

只读： 应用版本、数据库版本、迁移状态、配置 ID、最后更新时间等。

可操作：

操作说明注意
全局违禁词跳转违禁词管理敏感词拦截策略
清除缓存清客户端相关缓存策略不是清服务器所有缓存
恢复默认设置重置全部系统配置生产环境慎用，不可撤销

保存与验证 ​

  1. 每个 Tab 改完后点该 Tab 或页面底部 保存（以实际 UI 为准）
  2. 有 测试/获取 Token 的 Tab 必须点测试通过
  3. 客户端验证：对应功能走一遍（登录、上传、支付、地图）
  4. 失败时查 系统监控 → 系统状态 与服务器日志

相关文档 ​

灵萌 Lingmeng 使用手册

Copyright © 2026 Lingmeng