自定义 Chromium 启动参数

CustomChromiumFlags 是自 v1.14.2 / 5.69.2 起在沙盘配置提供的一个沙箱设置。该设置允许在 Chromium 内核的浏览器被沙箱启动时，向其传递额外的命令行参数。Sandboxie 会自动将这些参数注入到浏览器的启动命令行，实现对浏览器行为的精细控制，以增强在沙箱环境下的兼容性和功能性。

用法

[DefaultBox]

CustomChromiumFlags=--disable-features=PrintCompositorLPAC --disable-gpu

语法

CustomChromiumFlags=--disable-features=PrintCompositorLPAC [<flag 1> <flag 2> ...]

技术细节

当配置了 CustomChromiumFlags 后，Sandboxie 会在进程初始化期间，针对检测为 Chromium 内核浏览器的应用程序，对其命令行进行修改：

浏览器识别：此设置仅适用于通过 SpecialImage 配置或自动检测为 Chrome 分类的应用程序¹
命令行注入：内核初始化期间，Sandboxie 会拦截进程参数，通过在可执行路径和现有参数之间插入自定义参数，对启动命令行进行重构⁷²
子进程过滤：参数仅注入到主浏览器进程中，不会对包含 --type= 参数的子进程生效，从而避免重复注入及潜在冲突³

默认配置

Sandboxie 内置默认值以确保浏览器兼容性：

CustomChromiumFlags=--disable-features=PrintCompositorLPAC

默认参数用于禁用 Print Compositor LPAC（低权限应用容器）功能，以防在沙箱环境中产生兼容性问题⁴

使用示例

基础 GPU 加速禁用：

CustomChromiumFlags=--disable-features=PrintCompositorLPAC --disable-gpu

多性能参数设置：

CustomChromiumFlags=--disable-features=PrintCompositorLPAC --no-sandbox --disable-web-security

调试选项：

CustomChromiumFlags=--disable-features=PrintCompositorLPAC --enable-logging --log-level=0

安全性注意事项

浏览器兼容性：默认的 PrintCompositorLPAC 参数可避免与打印相关的崩溃，确保浏览器在沙箱中的稳定运行
参数校验：用户应谨慎验证自定义参数，部分参数可能会影响沙箱安全性或浏览器稳定性
自动应用：此设置会自动应用于所有被识别为 Chrome 浏览器的应用程序，无论是手动配置还是自动检测

实现说明

在 Sandboxie 检测到 Chromium 内核浏览器时，该设置会在 DLL 初始化阶段被处理。系统会：

使用 SbieApi_QueryConfAsIs 以 CustomChromiumFlags 键查询配置⁵
分配额外内存以容纳注入自定义参数的扩展命令行
拷贝原始可执行路径、插入自定义参数，并附加剩余参数，重构命令行⁶
钩取 GetCommandLineW 与 GetCommandLineA 函数，将修改后的命令行返回给应用

浏览器支持

该设置兼容所有基于 Chromium 内核的浏览器，包括： - Google Chrome - Microsoft Edge (Chromium) - Brave 浏览器 - Opera - Vivaldi - 任何其他使用 Chromium 引擎构建的浏览器