> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/openbsd/miscellaneous/openbsd-for-macos-users.md).

# macOS 用户视角的 OpenBSD

本快速入门面向 macOS 管理员，通过将熟悉的概念映射到 OpenBSD 7.8 工具与惯例来介绍 OpenBSD。文中突出实际差异，并非详尽对比，也不涉及理念讨论。本指南假设 OpenBSD 已安装完毕，且你已有命令行访问权限。

## Shell

OpenBSD 上 root 与普通用户的默认 shell 都是 Korn shell [ksh(1)](https://man.openbsdhandbook.com/ksh.1/) 。现代 macOS 系统中，新建用户账号默认使用 `zsh`。OpenBSD 的 [ksh(1)](https://man.openbsdhandbook.com/ksh.1/) 实现了传统 Bourne shell 语言的一个超集。

其他 shell（如 Bash、Zsh）以软件包形式提供，参见 [pkg\_add(1)](https://man.openbsdhandbook.com/pkg_add.1/) 与 [chsh(1)](https://man.openbsdhandbook.com/chsh.1/) 。

**建议：** 不要把 root 的 shell 改成由软件包提供的 shell。非基本系统的 shell 位于 `/usr/local/bin`，在受限恢复场景下可能不可用。基本系统的 [ksh(1)](https://man.openbsdhandbook.com/ksh.1/) 位于 `/bin`。

```sh
# 在普通账号下通过 doas(1) 安装常用替代 shell
$ doas pkg_add bash zsh  # 安装 Bash 与 Zsh
$ chsh -s /usr/local/bin/zsh  # 将登录 shell 改为 Zsh
```

## 提权：doas（取代 macOS 的 sudo）

OpenBSD 基本系统自带 [doas(1)](https://man.openbsdhandbook.com/doas.1/) 用于提权（macOS 自带 `sudo`）。通过 [doas.conf(5)](https://man.openbsdhandbook.com/doas.conf.5/) 配置 OpenBSD 的工具。`/etc/examples/` 下有已说明的示例。

```sh
$ doas cp /etc/examples/doas.conf /etc/doas.conf  # 从示例配置开始
```

默认情况下，每次调用都会要求输入密码。要像许多 sudo 配置那样缓存认证，加入 `persist`：

```
permit persist keepenv :wheel
```

如确有需要，可安装 `sudo` 软件包，参见 sudo(8)。

## 软件管理

macOS 上常见的第三方包管理器是 Homebrew 或 MacPorts；OpenBSD 则不同，提供官方且集成的二进制软件包系统。优先使用预编译软件包，参见 [packages(7)](https://man.openbsdhandbook.com/packages.7/) 。从 ports 构建见 [ports(7)](https://man.openbsdhandbook.com/ports.7/) 。

### 安装与删除软件包

用 [pkg\_add(1)](https://man.openbsdhandbook.com/pkg_add.1/) 安装预编译软件包：

```sh
$ doas pkg_add nginx  # 安装 Nginx
```

用 [pkg\_delete(1)](https://man.openbsdhandbook.com/pkg_delete.1/) 删除软件包：

```sh
$ doas pkg_delete nginx  # 删除 Nginx
```

用 [pkg\_info(1)](https://man.openbsdhandbook.com/pkg_info.1/) 列出已安装软件包：

```sh
$ pkg_info  # 列出已安装软件包
```

### 更新（同一发行版内）

OpenBSD 通过 [syspatch(8)](https://man.openbsdhandbook.com/syspatch.8/) 为**基本系统**提供二进制补丁。这大致相当于 macOS 针对操作系统（而非第三方软件）的软件更新。

```sh
$ doas syspatch -c  # 查看可用的基系统补丁
$ doas syspatch     # 应用基系统补丁（按需重启）
```

将已安装软件包升级到当前发行版的最新版本：

```sh
$ doas pkg_add -Uu  # 在当前发行版内升级全部软件包
```

### 升级（到新发行版）

用 [sysupgrade(8)](https://man.openbsdhandbook.com/sysupgrade.8/) 拉取并执行发行版升级。重启后若收到提示，用 [sysmerge(8)](https://man.openbsdhandbook.com/sysmerge.8/) 完成配置合并，再更新软件包。

```sh
$ doas sysupgrade  # 将基本系统升级到下一 OpenBSD 发行版
$ doas pkg_add -Uu # 基本系统升级后更新软件包
```

## 网络

macOS 上接口常以 `en0`、`en1` 等形式出现。OpenBSD 按驱动名命名接口，例如 `em0`（Intel）、`re0`（Realtek）、`bge0`（Broadcom）。详见 [ifconfig(8)](https://man.openbsdhandbook.com/ifconfig.8/) 。

### 用 hostname.if 配置接口

每接口配置存放在 [hostname.if(5)](https://man.openbsdhandbook.com/hostname.if.5/) 中，`if` 为接口名（例如 `/etc/hostname.em0`）。这取代了 macOS 上 `networksetup`、`scutil` 等命令行工具用于持久化设置。

静态 IPv4：

```
inet 10.0.0.100 255.255.255.0
```

静态 IPv6：

```
inet6 2001:db8:6000:9344::154 64
```

DHCP：

```
dhcp
```

从文件应用配置时，使用 [netstart(8)](https://man.openbsdhandbook.com/netstart.8/) ：

```sh
$ doas sh /etc/netstart      # 重新载入全部接口
$ doas sh /etc/netstart em0  # 重新载入单个接口
```

临时性的运行时改动可用 [ifconfig(8)](https://man.openbsdhandbook.com/ifconfig.8/) 完成：

```sh
$ doas ifconfig em0 10.0.0.100 255.255.255.0  # 设置临时 IPv4 地址
```

### 主机名

在 [myname(5)](https://man.openbsdhandbook.com/myname.5/) （`/etc/myname`）中设置系统的全限定域名。这取代了 macOS 上的 `scutil --set HostName`。

```
host.example.com
```

修改后用 `sh /etc/netstart` 重新载入网络。

### 默认网关

在 [mygate(5)](https://man.openbsdhandbook.com/mygate.5/) （`/etc/mygate`）中设置默认网关。每行一个地址；每个协议族取第一条。

```
192.0.2.1
2001:db8:6000:9344::1
```

修改后用 `sh /etc/netstart` 重新载入网络。

### DNS 解析器

在 [resolv.conf(5)](https://man.openbsdhandbook.com/resolv.conf.5/) 中配置解析器，而非使用 `scutil --dns` 或“系统设置”界面：

```
nameserver 192.0.2.1
lookup file bind
```

修改后用 `sh /etc/netstart` 重新载入网络。

## 守护进程与启动

macOS 使用 `launchd` 与 `launchctl` 管理服务。OpenBSD 采用传统 BSD init 与 rc 系统，参见 [init(8)](https://man.openbsdhandbook.com/init.8/) 、[rc(8)](https://man.openbsdhandbook.com/rc.8/) 与 [rc.conf(8)](https://man.openbsdhandbook.com/rc.conf.8/) 。系统默认值在 `/etc/rc.conf`。不要直接编辑该文件，应在 `/etc/rc.conf.local` 中覆盖并本地化设置。

用 [rcctl(8)](https://man.openbsdhandbook.com/rcctl.8/) 控制并启用守护进程。例如管理基本系统的 Web 服务器 [httpd(8)](https://man.openbsdhandbook.com/httpd.8/) ：

```sh
$ doas rcctl start httpd    # 立即启动 httpd（类似 `launchctl kickstart`）
$ doas rcctl stop httpd     # 停止 httpd（类似卸载 launchd 服务）
$ doas rcctl reload httpd   # 重新载入 httpd 配置
$ doas rcctl enable httpd   # 开机自启（持久生效）
$ doas rcctl disable httpd  # 取消开机自启
```

## 常用对照

| 任务（macOS）                                   | OpenBSD 工具或文件                 | 用途                |
| ------------------------------------------- | ----------------------------- | ----------------- |
| `brew install nginx` / `port install nginx` | `pkg_add nginx`               | 从仓库安装软件包          |
| `brew upgrade` / `port upgrade outdated`    | `pkg_add -Uu`                 | 在当前发行版内升级全部软件包    |
| `softwareupdate -ia`                        | `syspatch`                    | 应用基本系统安全/缺陷补丁     |
| macOS 大版本升级（安装器 / MDM）                      | `sysupgrade`                  | 升级到下一 OpenBSD 发行版 |
| `launchctl kickstart gui/UID/label`         | `rcctl start svc`             | 启动服务              |
| `launchctl bootout system/label`            | `rcctl stop svc`              | 停止服务              |
| `launchctl enable system/label`             | `rcctl enable svc`            | 让服务开机自启           |
| `scutil --set HostName host.example.com`    | `/etc/myname`                 | 设置系统主机名           |
| `networksetup -setdhcp Wi-Fi`               | `/etc/hostname.em0` 写入 `dhcp` | 将接口配置为 DHCP       |
| 查看 DNS：`scutil --dns`                       | `/etc/resolv.conf`            | DNS 解析器配置         |

更多详情请参阅本站引用的手册页。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/openbsd/miscellaneous/openbsd-for-macos-users.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.