Revive Adserver 6.0.8 配置参数详解

目标：详解 Revive Adserver 6.0.8 安装向导生成的全局配置文件（var/<主机名>.conf.php）的体系结构、加载机制与全部配置组参数，并给出手工修改配置的正确姿势与常见问题。文中所有参数值均取证自实测安装（2026-10-29，全新安装向导产物），源码行号取证自 6.0.8 源码包。安装过程见本站《Ubuntu 22.04 安装 Revive Adserver 6.0.8 指南》。

一、环境信息

💡 Revive Adserver 没有全局统一的 conf.ini.php：配置文件按"访问主机名"逐主机命名，这是它多主机部署设计的核心。本文以 10.89.71.2.conf.php 为蓝本讲解，你机器上的文件名以实际访问主机名为准。

二、配置体系与加载机制

2.1 var/ 目录的物理布局

安装完成后 var/ 目录与配置相关的文件（实测清单）：

10.89.71.2.conf.php   ← 主配置文件（按主机名命名）
default.conf.php      ← 兜底指针文件
.htaccess             ← Web 访问拦截
debug.log             ← 调试日志（[log] 段定义）
install.log           ← 安装/升级日志
INSTALLED             ← 安装完成标记（0 字节）
UPGRADE               ← 安装/升级触发标记（安装完成后被自动删除）
cache/                ← 菜单、权限、投递函数等运行时缓存
plugins/              ← 插件运行时数据
templates_compiled/   ← 模板编译产物

三道防直读设计（实测取证）：

1. var/.htaccess 内容为 Require all denied（Apache 2.4 段），直接拒绝一切 Web 访问；
2. 配置文件首行是 ;<?php exit; ?>——对 INI 解析器它是注释，对 PHP 引擎是立即退出指令，即便 .htaccess 失效也不会泄露内容；
3. 文件第二行注释 ;*** DO NOT REMOVE THE LINE ABOVE *** 提醒不可删除首行。

2.2 主机名路由：配置文件如何被选中

加载逻辑在 init-parse.php（实测逐行取证），规则有三层：

1. 取当前访问主机名：Web 请求取 $_SERVER['HTTP_HOST']；命令行取 $GLOBALS['argv'][1]（即 CLI 第一个参数）。命令行缺参直接抛异常，实测报错原文：

Revive Adserver was called via the command line, but had no host as a parameter.

2. 优先加载 var/<主机名>.conf.php（init-parse.php 第 92 行起）；
3. 主机配置不存在时回退到 var/default.conf.php——这个文件只有一个键 realConfig，指向真正生效的配置（实测内容）：

;<?php exit; ?>
;*** DO NOT REMOVE THE LINE ABOVE ***
realConfig="10.89.71.2"

若主机配置文件存在且带 realConfig 键，则把它当作"覆盖层"，与 realConfig 指向的配置合并后生效（第 101~113 行）。这个机制支持一台服务器多个投放域名共享一份主配置。

2.3 语法与取值约定

• 标准 INI 格式，[section] 分组，key=value；; 开头为注释；
• 空值（如 persistent=）表示"未启用/取默认"；1 为启用，0 为关闭；
• 含特殊字符的值带双引号，如 fromAddress="admin@example.com"；
• [plugins]、[pluginGroupComponents] 的 键=1 是"该插件/组件已启用"的注册表。

三、核心配置组逐项详解

3.1 [openads]——安装状态与 SSL

3.2 [ui]——管理界面

3.3 [database] 与数据库家族——连接参数

实测值（安装向导写入）：

[database]
type=mysqli
host=localhost
socket=
port=3306
username=admin
password=q1w2e3r4
name=revive_db
persistent=
protocol=tcp
compress=
ssl=
capath=
ca=

配套段：

3.4 [webpath]——三个入口的 URL

[webpath]
admin="10.89.71.2/admin"
delivery="10.89.71.2/delivery"
deliverySSL="10.89.71.2/delivery"
images="10.89.71.2/images"
imagesSSL="10.89.71.2/images"

admin/delivery/images 分别是后台、投递引擎、素材库的基准 URL（SSL 版本另配）。这些值直接写进生成的广告调用代码，也决定 CLI 的 host 参数——改动它等于"搬家"，需要同步更新已分发的调用代码。

3.5 [file]——投递端点文件名映射

把"逻辑端点"映射到 www/delivery/ 下的 PHP 文件名（共 20 项，实测全表）：

改这些名字等同于"给端点改名"，改完必须重新编译投递引擎（见第五节）。

3.6 [store]——广告素材存储

3.7 [allowedBanners]——允许的广告类型

3.8 [delivery]——投递引擎（最核心的一组）

3.9 [privacy]——访客隐私

两个默认就是开的，符合 GDPR 友好方向；关闭它们可获得更完整的访客画像与地域统计，需自行评估合规。

3.10 [logging]——投递日志

3.11 [maintenance]——维护调度

维护脚本本身的用法（含 host 参数）见本站《Revive Adserver 6.0.8 常用 CLI 命令与工具详解》。

3.12 [priority]——优先级引擎

3.13 [table]——表前缀、存储引擎与表名映射

[table]
prefix=rv_
type=INNODB

该段余下 49 个键是"逻辑表名 → 实际表名"映射（如 banners=banners、clients=clients），只在你想给单张表改名/分表时才需要动。历史命名彩蛋：affiliates 是"网站/媒体位"、clients 是"广告主"——OpenX 时代的遗产（沿革见本站《Revive Adserver 介绍与选型指南》）。

3.14 [email]——系统邮件

注意：这只影响 PHP mail() 发件；要接 SMTP 需要 rvMailer 插件的配置段（第四节）。

3.15 [log]、[deliveryLog] 与 [debug]——三份日志

3.16 [cookie]——访客 Cookie

3.17 [var]——投递 URL 变量名映射

prefix=OA_ 定义 JS 变量前缀；其余 30 余项把"逻辑变量"映射到 URL/JS 参数名。投放侧最常用的一组（实测值）：

与 [file] 一样，改这里的名字会改变对外 URL 形态，改完要重编译投递引擎。

3.18 [lb]——数据库负载均衡

[lb]
enabled=
type=mysql
host=localhost
port=3306

默认关闭。启用后可把部分读请求分流到从库（host/port/username/password/name 填从库信息），大流量站点才需要。

3.19 [sync] 与 [oacSync]——官方版本检查

离线/内网部署建议把 checkForUpdates 置 0，避免后台等超时。

3.20 [authentication] 与 [security]——认证与密码策略

3.21 [geotargeting]——地域定向

3.22 插件体系四段与 [audit]

四、插件自带配置组

以下 section 由插件安装时写入，属于"插件参数区"：

五、修改与生效：正确的姿势

1. 后台优先：绝大多数参数（界面、日志、维护、邮件等）在后台 Settings 界面修改即可，系统会自己写回 conf 文件并处理联动；
2. 手工编辑 conf：直接改 var/<host>.conf.php 对下一次请求即时生效，但注意两类缓存——
   • 投递缓存（var/cache/，有效期 [delivery] cacheExpire=1200 秒）：改投递相关参数后可清空 var/cache/ 立即生效；
   • 编译后的投递引擎（www/delivery/，由 www/delivery_dev/ 模板编译而来）：凡涉及 [file]、[var]、[deliveryHooks] 这类"改变投递代码形态"的修改，必须重编译——php scripts/maintenance/delivery/rebuild.php <host>，实测会输出 STARTING TO RE-COMPILE THE DELIVERY ENGINE FILES（详见 CLI 指南）；
3. 改数据库口令：conf 的 [database] 与数据库端要同步改，改完可先跑一次 maintenance.php 验证连接；
4. 备份：动手前 cp var/<host>.conf.php var/<host>.conf.php.bak（.bak 不会被加载，但注意它同样含敏感信息，别放进 Web 可访问目录）。

六、常见问题

6.1 用新域名访问，后台/投递行为异常

主机名路由（2.2 节）决定：用域名访问时若 var/<域名>.conf.php 不存在，会经 default.conf.php 的 realConfig 兜底到现有配置——系统不会报错，但 [webpath] 里仍是旧主机名，生成的广告代码全指向旧地址。正确做法：要么保持访问主机名与安装时一致，要么改 [webpath] 五项并同步更新已分发的广告代码。

6.2 CLI 工具报 "no host as a parameter"

CLI 没有 $_SERVER['HTTP_HOST']，必须显式传主机名（与 conf 文件名同名）：php scripts/maintenance/maintenance.php 10.89.71.2。源码依据：init-parse.php 第 69 行 $_SERVER['HTTP_HOST'] = trim($GLOBALS['argv'][1])。

6.3 改了 cacheExpire/定向，投放行为没变

投递缓存未过期（默认 20 分钟）。清 var/cache/ 或等过期；涉及投递引擎形态的改动还要跑 delivery/rebuild.php（第五节）。

6.4 var/debug.log 暴涨

[log] priority=7（DEBUG）或 [ui] gzipCompression 异常时可能产生大量日志。生产保持 priority=6；排障完记得改回。

6.5 忘记后台密码

改密码不是改 conf（conf 里不存后台口令，口令在 rv_users 表做哈希）。用数据库管理员账号在后台登录页走密码找回（[email] 邮件可用时），或临时建新管理员后重置。

七、参考链接

• 选型与背景：本站《Revive Adserver 介绍与选型指南》
• 安装与部署：本站《Ubuntu 22.04 安装 Revive Adserver 6.0.8 指南》
• 运维命令：本站《Revive Adserver 6.0.8 常用 CLI 命令与工具详解》
• 官方文档主页：https://www.revive-adserver.com/docs/
• 源码仓库（配置加载逻辑见 init-parse.php、lib/OA/Config 相关文件）：https://github.com/revive-adserver/revive-adserver