mosparo 1.5.13 配置参数详解

本文是 mosparo 专栏的配置篇。全部参数取值取自 2026-10-28 实测的 v1.5.13 实例(Debian 12 + Apache + MariaDB,部署过程见《mosparo 1.5.13 安装部署指南》),关键参数均做了"改动 → 清缓存 → 观察行为"的生效验证,验证过程在对应小节给出实测回显。命令行运维见《mosparo 1.5.13 常用 CLI 命令详解》。

一、配置体系:四层来源与优先级

mosparo 基于 Symfony 6.4,配置分散在四个位置,从低到高生效顺序如下(php bin/console debug:dotenv 实测输出的 Scanned Files 节):

Scanned Files (in descending priority)
--------------------------------------

 * ⨯ .env.local.php
 * ⨯ .env.prod.local
 * ⨯ .env.prod
 * ⨯ .env.local
 * ✓ .env

✓ 表示该文件存在并被加载,⨯ 表示不存在。结合实测,四层含义为:

注意一个反直觉点:第 2 层(config/env.mosparo.php)在文件优先级上并不高于 .env.local 的同名变量,但数据库连接参数(database_* 键)由 mosparo 专用逻辑读取并拼装 DATABASE_URL,因此改数据库连接要么走后台设置页,要么直接改 env.mosparo.php,只写 .env.local 的 DATABASE_URL 不被安装配置逻辑采纳。手动覆盖系统类变量(如本文第三节那些 MOSPARO_*)用 .env.local 是正确姿势。

改完任何环境变量必须清缓存才生效:

root@mosparo-lab:/var/www/mosparo# php bin/console cache:clear
root@mosparo-lab:/var/www/mosparo#

(实测:命令成功时无输出,直接返回提示符。)

二、安装配置文件 env.mosparo.php 逐项

安装向导完成后生成 config/env.mosparo.php,实测全文(密码脱敏):

<?php

return array (
  'database_system' => 'mysql',
  'database_driver' => 'pdo_mysql',
  'database_host' => '127.0.0.1',
  'database_port' => '3306',
  'database_name' => 'mosparo',
  'database_user' => 'mosparo',
  'database_password' => '****',
  'database_version' => '10.11.19-MariaDB-0+deb12u1',
  'mosparo_name' => 'mosparo-lab',
  'encryption_key' => 'c50c348c21795be18d80ce62bacd3b9ff959d98011ea737eae05175a32ef83c7',
  'secret' => '10e790aa4d66a6afed9407f926851a44f2b4cdac2de15db45dfdfcf4c2c3b356',
  'mosparo_installed' => true,
  'mosparo_installed_version' => '1.5.13',
  'mosparo_initial_version' => '1.5.13',
  'mosparo_assets_version' => 'CmCHCGFBI0g',
);

逐项说明(键名均实测如上):

后台「Administration → Settings」修改邮件、代理等设置后,同样写入本文件,不改 .env。

三、环境变量逐项(.env 层)

以下清单取自 php bin/console debug:dotenv 实测输出的 Variables 节(值列 = 发行包默认值),按功能分组解读:

3.1 数据保留与清理(核心生产参数)

清理任务靠计划任务驱动(后台 Webcron 或系统 crontab 调 CLI),不配置计划任务这些参数不会生效,见《mosparo 1.5.13 常用 CLI 命令详解》计划任务一节。

3.2 健康检查(实测验证)

生效验证实录(2026-10-28 实测):默认白名单下,从另一台内网机器(10.89.67.1)访问健康端点,得到的不是 403 而是 404——mosparo 对白名单外来源直接隐藏端点存在性:

monitor@10.89.67.1:~$ curl -s -m 5 -w '\nHTTP %{http_code}\n' http://10.89.67.2/api/v1/health/check

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
...
        <title>Not found - mosparo-lab</title>
...
HTTP 404

在服务器上创建 .env.local 把监控机加入白名单并清缓存:

root@mosparo-lab:~# cd /var/www/mosparo
root@mosparo-lab:/var/www/mosparo# printf 'MOSPARO_HEALTH_ALLOW_LIST=127.0.0.1,::1,10.89.67.1\n' > .env.local
root@mosparo-lab:/var/www/mosparo# php bin/console cache:clear

再从同一台监控机访问,实测立刻放行:

monitor@10.89.67.1:~$ curl -s -m 8 -w '\nHTTP %{http_code}\n' http://10.89.67.2/api/v1/health/check
{"service":"mosparo","healthy":true,"databaseStatus":"connected","error":null,"statusCode":200}
HTTP 200

结论:MOSPARO_HEALTH_ALLOW_LIST 走 .env.local + cache:clear 链路即刻生效,无需重启服务;监控接入时别忘把监控机 IP 加进来,否则会被 404 迷惑。

3.3 更新检查

3.4 规则包

3.5 缓存与锁

3.6 数据库 TLS(MySQL 专用)

3.7 框架级

四、Webcron 相关配置键

后台「Administration → Cron jobs」配置的值同样落在 config/env.mosparo.php,相关键(自源码与实测确认):

实测:未启用时访问 Web Cron 端点被拒:

root@mosparo-lab:~# curl -s http://localhost/cron-jobs/execute
400 Bad Request

运维建议:Web Cron 依赖"有人来访问"才触发,裸机生产更稳的做法是系统 crontab 直接调 CLI(每 5 分钟跑 mosparo:cleanup-database),命令与实测回显见《mosparo 1.5.13 常用 CLI 命令详解》。

五、项目级参数(后台 / 数据库层)

mosparo 以项目(Project)为防护单元,每个项目独立一套参数。以下默认值取自实测执行 php bin/console mosparo:export 1 导出的 JSON(项目刚按向导默认创建,未做任何人工调整):

5.1 通用与高级

5.2 安全特性默认值

调参经验:这些默认值对普通联系表单够用;minimumTimeSeconds 若误伤快速填写者可降到 5;延迟/锁定的触发阈值按业务峰值流量调整,别把正常秒杀活动用户锁掉。

六、配置变更的操作路径速查

七、参考

• 组件定位与竞品对比:《mosparo 1.5.13 介绍与选型指南》
• 部署过程与目录结构:《mosparo 1.5.13 安装部署指南》
• 命令行与计划任务:《mosparo 1.5.13 常用 CLI 命令详解》
• 官方文档:documentation.mosparo.io(Installation / Settings 章节,查询日期 2026-10-28)