xiis服务器与管理面板及安全配置说明

服务器节承接前台运行参数，管理面板节集中面板自身的端口、监听地址与登录防护，安全节则覆盖内容安全策略、访问控制与上传限制。三节配置都支持热更新，涉及端口与监听地址的修改会触发程序自动重启。

服务器参数

服务器节包含前台端口、三类超时、请求头与请求体上限、响应大小上限、默认站点路径、运行模式、最大并发连接数、优雅关闭时间与全局默认索引文件列表。超时设置防止慢连接占住连接池，请求体上限是上传校验的全局闸门。

请求体上限同时是插件上传的唯一权威来源，插件侧不再单独设置正文上限；调整上传能力时优先检查该值，再核对安全节的最大上传大小，两处取最小值生效。

管理面板配置

管理面板节包含面板端口、监听地址、管理密钥、登录失败限制与锁定时长以及请求令牌签名密钥。监听地址设置为仅本机时面板只允许本地访问，多机运维场景可放开为所有网卡；登录失败超过阈值锁定来源地址一段时间，防止暴力尝试。

安全策略开关

安全节的策略开关注明各项响应头的开关状态：内容安全策略是现代浏览器最核心的跨站脚本防御手段，建议保持开启；内容类型选项防止资源类型混淆；帧保护与来源策略按实际需要启用。服务器响应头用于隐藏真实服务器信息，可按站点自定义。

访问控制

域名校验开启后只允许白名单内的域名访问，白名单支持通配符；地址黑名单支持单个地址与网段写法，兼容两种协议；请求代理头只有在直连地址命中可信代理列表时才会被信任，防止伪造来源地址绕过黑名单。用户代理黑名单支持正则，用于拦截扫描器与异常客户端。

频率限制与上传限制

频率限制按来源地址计数，窗口内超出请求数返回限流响应，默认关闭，风险暴露的站点建议开启。上传限制分两级：请求层面的最大上传大小与数据库中的单文件上限配合使用，扩展名白名单与禁止访问名单共同决定可上传的文件类型，禁止名单优先于白名单生效。

安全基线建议保持默认的拒绝策略：可疑扩展名默认禁止 HTTP 直访，源码与配置文件不会通过浏览器直接暴露；白名单与黑名单冲突时黑名单优先，这一顺序在 CMS 上传与插件上传两条通道上保持一致。

配置的生效方式

三节配置的修改都走热更新：保存后自动应用到运行中的进程，不需要人工重启；端口与监听地址两项例外，保存后面板触发程序自动重启完成切换。数据库中的站点业务配置与配置文件是两套体系：配置文件管服务器层，站点业务参数存数据库，各自有独立的生效路径与缓存周期。

站点级覆盖

带站点覆盖能力的配置节可以在站点配置内单独书写同名键覆盖全局值，未设置项自动回退全局；面板以覆盖与回退标签标明每一项的来源，避免多站点场景下改了不生效的排查成本。管理面板与服务器节的关系可以概括为一句话：面板是配置的编辑入口，服务器是前台运行参数的载体，安全节是两者的共同防线。