为什么值得关注

它填补了现代 macOS 用户无法运行官方 AirPort Utility 的空缺，提供了一个由 Codex 辅助构建的开源替代品。

适合谁使用

使用旧款 AirPort 硬件的 Mac 用户
对逆向 Apple 协议感兴趣的开发者
管理 AirPort 基站的网络管理员
寻找 Swift/Python 实践项目的开源贡献者

典型使用场景

管理 AirPort 基站设置（如网络、磁盘、固件）
查看连接 AirPort 设备的网络拓扑
配置互联网设置（包括 PPPoE，如有相应硬件）
访问支持型号上的 AirPlay 和 NAS 功能

项目优势

适用于多个 AirPort Express、Extreme 和 Time Capsule 型号
无需任何第三方 Swift 或 Python 包
包含单元测试和实际设备集成测试
积极欢迎贡献和 bug 报告

使用前须知

测试版软件，存在已知 bug 且部分型号未测试
因缺乏必要硬件，无法测试像 PPPoE 这样的功能
需要 macOS 13 或更高版本以及 Python 3.10+ 来构建和运行

README 快速开始

AirPort Utility (beta)

Apple's AirPort Utility is not guaranteed to run on macOS 27 and newer, so I reverse engineered the application and have reimplemented it for macOS 27 and newer with Swift (front-end code) and Python (backend protocol code). I leveraged Codex to accelerate this work.

I have tested the app with the AirPort models below. However, bugs still remain and there are models I have not tested with. Even for devices that I have tested with, I cannot test all features, such as PPPoE, as I lack the necessary hardware. All contributions are welcome! Please open bug reports for any issues you find and pull requests are greatly appreciated!

Compilation

The build and runtime requirements are:

macOS 13 or newer
Swift 6.0 or newer, provided by Xcode 16 or newer or the corresponding Command Line Tools
Python 3.10 or newer available on PATH as python3

The project has no third-party Swift packages or Python packages to install. AppKit, SwiftUI, Security, Bonjour, and CommonCrypto are provided by macOS.

On a new Mac, install the Command Line Tools:

xcode-select --install

If python3 --version reports a version older than 3.10, install a newer Python. For example, with Homebrew:

brew install python

Verify that the required tools are selected:

swift --version
python3 --version

Then compile and run the application from the root of the repository:

./run.sh

Testing

Run the Swift unit tests from the root of the repository:

swift test

The default test run skips slower subprocess integration tests. Include them with:

AIRPORT_UTILITY_SLOW_TESTS=1 swift test

Run the Python backend unit tests separately:

python3 -m unittest Tests/BackendPythonTests/test_backend_modules.py

Live base-station tests are skipped unless their AIRPORT_LIVE_* environment flags are explicitly set. These tests can change network, password, disk, or firmware settings on real hardware and are not required for the normal test suite.

Recovered AirPort models

The app has been tested with these AirPort models. The app is still likely to work with AirPort models not listed, at least partially. The goal is to fully support all features of all models.

Name	Model	ACP Version	Device-Specific Features
AirPort Express	A1088	v1	AirPlay

项目描述

Re-creation of Apple's AirPort Utility for macOS 27 and newer

airport-utility