黑苹果 - 开发笔记分享

最后修改人	果农
最后修改时间	2023-06-04 13:52:13
创建人	果农
创建时间	2023-06-04 13:30:32

该文档由果农创建于 2023-06-04 13:30:32 ，果农在 2023-06-04 13:52:13 修改了该文档。

[TOCM]

## 先弄清楚SIP  
定义：SIP（System Integrity Protection）系统完整性保护。  
作用：保护macOS系统分区里面的文件不被修改，简单点说系统文件变成只读了，系统更加安全了。  
为何关闭：《美国往事》看过吧，总是要打开门进去才可以…，关闭SIP相当于安卓root，iOS越狱。PS 有很多好用的软件，需要关闭SIP才能运行，比如：totalfinder、一些学习版软件。

## 配置CSR Flags

可以参考：  
https://github.com/5T33Z0/OC-Little-Translated/blob/main/B_OC_Calculators/SIP_Flags_Explained.md

Flag | Bit | macOS req.  
-----|-----|:------------:  
CSR\_ALLOW\_UNTRUSTED_KEXTS            | 0 | 10.11+  
CSR\_ALLOW\_UNRESTRICTED_FS            | 1 | 10.11+  
CSR\_ALLOW\_TASK\_FOR_PID               | 2 | 10.11+  
CSR\_ALLOW\_KERNEL_DEBUGGER            | 3 | 10.11+  
CSR\_ALLOW\_APPLE_INTERNAL             | 4 | 10.11+  
CSR\_ALLOW\_UNRESTRICTED_DTRACE        | 5 | 10.11+  
CSR\_ALLOW\_UNRESTRICTED_NVRAM         | 6 | 10.11+  
CSR\_ALLOW\_DEVICE_CONFIGURATION       | 7 | 10.11+  
||  
CSR\_ALLOW_ANY\_RECOVERY_OS            | 8 | 10.12+  
CSR\_ALLOW\_UNAPPROVED_KEXTS           | 9 | 10.13+  
CSR\_ALLOW\_EXECUTABLE\_POLICY_OVERRIDE | 10 | 10.14+  
CSR\_ALLOW\_UNAUTHENTICATED_ROOT       | 11 | 11+

Flags 含义

### CSR\_ALLOW\_UNTRUSTED_KEXTS

允许加载未经苹果明确批准的未签名内核扩展（`kexts`）。默认情况下，macOS只允许加载由苹果签名或用户通过特殊流程批准的kext。此标志对于需要使用尚未签署或批准的kexts的开发人员或高级用户非常有用。

### CSR\_ALLOW\_UNRESTRICTED_FS

允许不受限制的文件系统访问，包括创建和删除系统文件和目录。默认情况下，macOS阻止修改根文件系统以保护系统的完整性。此标志对于需要为调试或自定义目的修改系统文件的开发人员或高级用户非常有用。

### CSR\_ALLOW\_TASK\_FOR_PID

允许根据提供的进程ID（`PID`）跟踪进程。默认情况下，macOS会限制这种能力，以防止未经授权访问敏感的系统信息。此标志对需要调试或分析系统流程的开发人员或安全研究人员非常有用。

### CSR\_ALLOW\_KERNEL_DEBUGGER

允许运行内核调试器和其他低级系统工具。默认情况下，macOS会限制使用这些工具，以防止未经授权访问敏感的系统信息。此标志对需要调试或分析低级系统行为的开发人员或安全研究人员非常有用。

### CSR\_ALLOW\_APPLE_INTERNAL

允许苹果内部功能集（主要用于苹果开发设备）。用于加载不属于标准macOS安装的Apple签名系统扩展。默认情况下，macOS仅加载作为标准安装一部分的扩展，以确保系统稳定性和安全性。此标志对需要使用其他系统扩展的开发人员或高级用户非常有用。

尽量避免设置此旗帜。否则，系统更新通知将无法在Big Sur及更新中工作，您将需要解决方法。

### CSR\_ALLOW\_UNRESTRICTED_DTRACE

限制使用`DTrace`的安全功能，`DTrace`是macOS内置的强大诊断和调试工具。默认情况下，macOS限制使用`DTrace`，以防止未经授权访问敏感系统信息。此标志对于需要使用`DTrace`进行调试或性能分析的开发人员或高级用户来说非常有用。

`DTrace`允许用户跟踪和调试系统活动，但它也有可能用于恶意目的，例如监控按键或访问敏感信息。为了防止这种情况，苹果在macOS 10.12 Sierra及更高版本中实现了`CSR_ALLOW_UNRESTRICTED_DTRACE`功能。

当`CSR_ALLOW_UNRESTRICTED_DTRACE`被禁用时，只有授权的系统组件和特权用户才能使用`DTrace`。这为系统提供了额外的安全层，防止未经授权访问敏感数据。

重要的是要注意，启用此功能可能会损害系统安全性，因此只有在绝对必要时，并且由具有适当知识和权限的用户才能完成。

### CSR\_ALLOW\_UNRESTRICTED_NVRAM

允许修改非易失性RAM（`NVRAM`）设置，这可能会影响系统行为和性能。默认情况下，macOS限制对NVRAM的修改，以防止对系统设置进行未经授权的更改。此标志对于需要为测试或性能优化目的修改系统设置的高级用户非常有用。

### CSR\_ALLOW\_DEVICE_CONFIGURATION

允许加载未由苹果签名的设备驱动程序。默认情况下，macOS只加载由苹果签名的设备驱动程序，以确保系统稳定性和安全性。此标志对需要使用自定义或实验设备驱动程序的开发人员或高级用户非常有用。

### CSR\_ALLOW\_ANY\_RECOVERY_OS

允许启动进入任何macOS恢复模式，即使它没有经过苹果的签名。默认情况下，macOS只允许启动进入由苹果签名的恢复模式，以防止对系统进行未经授权的修改。此标志对需要使用自定义恢复模式进行测试或恢复的高级用户非常有用。

### CSR\_ALLOW\_UNAPPROVED_KEXTS

允许加载未经用户明确批准的未签名内核扩展（kexts）。默认情况下，macOS只允许加载由苹果签名或用户通过特殊流程批准的kext。此标志对于需要使用尚未签署或批准的kext的高级用户非常有用。

### CSR\_ALLOW\_EXECUTABLE\_POLICY_OVERRIDE

允许运行被macOS的Gatekeeper阻止的可执行文件。当使用OCLP或其他安装后修补程序时，需要设置此标志，这些补丁程序为已从macOS Monterey及更新版本中删除的显卡重新安装遗留驱动程序。启用此标志后，您将无法下载增量（或增量）系统更新。只有完整的安装程序可用。

### CSR\_ALLOW\_UNAUTHENTICATED_ROOT

允许引导自定义APFS快照（主要用于修改后的根卷）。该标志不是SIP的公开记录或官方支持的功能。它是在macOS测试阶段被一些用户和开发人员发现的。

①以最新的13系统为例，一共有12个配置项，每个配置项都对应一个Hex16进制数值，开启几个项目，就把几个项的数值相加，然后做小端转换，将得到的数值，填入`opencore`的`config.plist`文件里`csr-active-conflgs`项目里即可。  
②如果你不明白这些配置项具体是干什么的，那么建议直接使用上图最后一行的建议`csr`数值，按照你的系统照抄到`config.plist`里就行了。比如：11-13系统就选`67080000`。

备注1：苹果其实提供了命令行工具：`csrutil`。这个命令适合白果和原生`NVRAM`的黑果机器，但因为要进`recovery`修改，所以比较麻烦，不如直接在`config.plist`里修改来的直接。  
备注2：`csrutil`只可以配置前7个项目，如果启用了第7项后面的项目，在`csrutil status`里是查询不到的，会出现`unknown`。 iShot_2023-06-04_00.50.09.png iShot_2023-06-04_01.04.28.png

## 一个方便的计算工具

地址：https://github.com/webfalter/OCToolBox  
这个工具能计算opencore里很多项目，大家可以自己去开发。