The Native Safari Multi-Environment Browser for macOS
Run dozens of isolated accounts side-by-side — powered by Apple's real Safari engine, Safari Private Browsing protection, 34 authentic Mac hardware presets, and built-in global proxy routing.
English · 简体中文
Most multi-account or "fingerprint" browsers on the market are built on modified versions of Chrome that try to fake hardware parameters using injected scripts. Modern websites can easily detect those fake scripts.
Safarier takes a fundamentally different approach:
- 100% Real macOS Safari Engine: Every Safarier window runs on Apple's native system
WebKitengine. To any website, your connection signature, rendering engine, and system behavior are genuinely macOS Safari. - Safari Private Browsing Grade Protection: Uses Apple's native anti-fingerprinting shield to protect Canvas, WebGL, and Audio signatures naturally — zero fake scripts, zero browser extensions required.
- Complete Account Isolation: Each environment runs in its own separate process and storage space. Cookies, login sessions, local storage, cache, and proxy routes never cross over between environments.
This repository doubles as a Homebrew tap — tap it by URL and install:
brew tap cd1s/safarier https://github.com/Cd1s/safarier
brew install --cask cd1s/safarier/safarierThe cask picks the Apple Silicon or Intel build automatically and can be upgraded with brew upgrade --cask safarier. Later releases are also picked up by the app's own About → Check for Updates….
Choose the package for your Mac from GitHub Releases (supports macOS 14 Sonoma, macOS 15 Sequoia, and later):
| Edition | Recommended For | Download Package |
|---|---|---|
| Apple Silicon | Mac with Apple Silicon chip | Safarier-v1.5.0-macOS-arm64.zip |
| Intel | Intel-based Mac | Safarier-v1.5.0-macOS-x86_64.zip |
| Universal | Works on both Apple Silicon & Intel Macs | Safarier-v1.5.0-macOS-universal.zip |
- Unzip the downloaded file and drag
Safarier.appinto yourApplicationsfolder. - If macOS prompts that the app cannot be verified on first launch, run this single command in Terminal:
xattr -dr com.apple.quarantine /Applications/Safarier.app
The app is ad-hoc signed rather than signed with an Apple Developer ID and notarized, so it is distributed through this repository as a Homebrew tap (via brew tap with an explicit URL) instead of the official homebrew-cask repository.
| Capability | What It Does for You |
|---|---|
| Independent Account Spaces | Create unlimited Persistent spaces (stay logged in forever) or Temporary Private spaces (auto-wiped when closed). Press ⌘D to clone any environment in one click. |
| 34 Real Mac Models | Simulate MacBook Pro 16" & 14" (Apple Silicon XDR), MacBook Air 15" & 13", iMac 24" 4.5K, Mac Studio (5K Studio Display), Mac mini (4K Retina), and Mac Pro (6K XDR) — complete with matching Retina ratio, P3 wide color, and HDR display traits. |
| Auto Follow-Proxy Region | Safarier detects the proxy exit region and time zone at launch. Automatic languages follow the effective time zone (for example, en-US for US time zones), including manually configured time zones. Custom languages take priority. |
| Real Mac Font Isolation | Enabled by default: blocks third-party fonts and filters built-in and downloaded CJK-specific fonts by the effective language. English profiles hide Songti, Hiragino Sans GB, PingFang and their localized aliases, while keeping common fonts and general character fallback. Restart the profile after language, time zone or font changes. |
| Built-in All-Protocol Proxy | No external proxy client needed. Paste a subscription URL or paste node links (VLESS / Reality, VMess, Trojan, Shadowsocks / SS2022, AnyTLS, SOCKS5, HTTP) directly. |
| Two-Hop Proxy Chains | Add a saved proxy, subscription node, or custom sing-box outbound as the upstream for a SOCKS5 / HTTP exit proxy. Environments and connection tests use the entire chain, with no fallback to a single hop or direct access. |
| Zero-Leak Protection | Every environment routes traffic and DNS strictly through its assigned node. If a proxy disconnects, page loading stops immediately and never falls back to your real local IP. |
Clash YAML subscriptions and local files support HTTP / HTTPS, SOCKS5, Shadowsocks / SS2022, VMess, Trojan, AnyTLS, VLESS / Reality, Mieru, and Hysteria2 (including port hopping). All can be bound to environments or selected as upstreams. Only nodes are imported; Clash DNS, rules, and listeners are not applied.
Adding or refreshing a subscription uses the system network settings and automatically retries once without the system proxy after an HTTP 403 response. This retry applies only to subscription downloads.
If a remote subscription contains Hysteria2 links that would be skipped, Safarier automatically requests Clash format from the same URL. It uses the more complete response when it also preserves the existing usable nodes and their names.
Subscription tables and node pickers offer individual and batch HTTPS latency tests, with concurrent requests, an eight-second per-node deadline, and cancellation support. Both default to ascending latency; click the HTTPS Latency heading to reverse the order. Failed nodes always stay at the bottom, and unfinished tests follow successful nodes. In a picker, Test Listed Nodes tests every search match, or the entire subscription when the search is empty. The upstream editor measures the selected upstream; Test Connection on the saved exit measures the complete chain and reports the final exit IP.
Add or edit the final exit under Proxies, then select an upstream: Saved Proxy, Subscription Node, or Custom. You can add a new upstream proxy from the editor. Custom JSON accepts one sing-box outbound object; full configurations and user-specified detour fields are rejected.
Traffic follows this Mac → upstream → exit proxy → website. Select the saved exit proxy in an environment to use the chain. All environments using that proxy share its upstream settings; restart them after changes. Connection tests and automatic language/time zone detection use the final exit. This version covers TCP browsing and supports exactly two hops: a proxy cannot reference itself or use another chained proxy as its upstream. Referenced proxies and subscriptions cannot be deleted; a missing upstream node prevents connection.
CLI equivalents (replace the IDs with actual values):
safarier proxy update EXIT_PROXY_ID --upstream-proxy ENTRY_PROXY_ID
safarier proxy update EXIT_PROXY_ID --upstream-sub SUBSCRIPTION_ID --upstream-node "Node name"
safarier proxy update EXIT_PROXY_ID --upstream-json-file /path/to/outbound.json
safarier proxy update EXIT_PROXY_ID --upstream-proxy noneSaved proxy passwords remain in Keychain. Custom JSON may contain credentials and is stored in the proxy metadata file with 0600 permissions; remove credentials before sharing it.
Saving any upstream uses proxy document version 2. Older Safarier versions reject that file instead of silently using a single hop. Before downgrading, remove all upstreams and save them in the newer version. Chains saved by earlier development builds must be saved again to gain this protection.
Safarier is designed to feel right at home for every Mac and Safari user:
- Unified Safari Toolbar & Smart Address Bar: Displays the current environment badge, security lock, loading progress, and supports right-click Paste and Go / Paste and Search.
- Complete Safari Right-Click Menu: Open links, images, videos, or frames in a new tab, background tab, or new window; save pages; inspect elements; or highlight text and Search with Google directly inside the current environment's proxy (never jumping out to your system default browser).
- Seamless Multi-Window & Multi-Tab Workflow: Native macOS tabs, tab overview grid, and instant
⌘\`` /⌘·` switching across multiple windows and environments.
| Action | Shortcut | Action | Shortcut |
|---|---|---|---|
| New Tab / New Window | ⌘T / ⌘N |
Switch Windows (EN & CN IME) | ⌘\`` / ⌘·` |
| Reopen Last Closed Tab | ⇧⌘T |
Switch to Tab 1–8 / Last Tab | ⌘1–⌘8 / ⌘9 |
| Close Tab / Close Other Tabs | ⌘W / ⌥⌘W |
Next / Previous Tab | ⇧⌘] / ⇧⌘[ |
| Focus Address Bar | ⌘L |
Show All Tabs Overview | ⇧⌘\ |
| Reload / Force Reload | ⌘R / ⌥⌘R |
Zoom Page / Zoom Text Only | ⌘+ ⌘- / ⌥⌘+ ⌥⌘- |
| Find on Page / Use Selection | ⌘F / ⌘E |
Web Inspector / Page Source | ⌥⌘I / ⌥⌘U |
| Save Page / Export PDF | ⌘S / ⌘P |
Show Downloads | ⌥⌘L |
Control each profile through a local, owner-only CLI bridge: semantic snapshots with element references and viewport coordinates, framework-friendly form filling, character-by-character OTP input, visible-element waits, native coordinate clicks, screenshots, and tab management. Page interactions run in an isolated client world and preserve the page's JavaScript globals.
Opening the manager synchronizes the safarier-browser Skill to ~/.claude/skills, ~/.claude-ifrr/skills, and ~/.agents/skills. Reload Skill discovery in Claude Code or Codex, or use AI Agent → AI Agent 接入… to copy the guide for another client. Cursor and OpenCode may need manual import according to their Skill support.
SF=/Applications/Safarier.app/Contents/MacOS/Safarier
"$SF" agent spaces
"$SF" agent open "Test Space" https://example.com --background
"$SF" agent snapshot "Test Space"
"$SF" agent fill "Test Space" e1 user@example.com
"$SF" agent click "Test Space" e2
"$SF" agent wait "Test Space" 'input[autocomplete="one-time-code"]'
"$SF" agent type "Test Space" 'input[autocomplete="one-time-code"]' 123456
"$SF" agent screenshot "Test Space" /tmp/page.png
"$SF" agent focus "Test Space"Use agent eval to batch asynchronous steps with safarier.fill, safarier.type, safarier.waitFor, and safarier.snapshot; use agent skill for the full guide. Different profiles can run concurrently. The 123456 code above is test data: supply only a code you are authorized to use.
This supports authorized form testing and assisted registration. CAPTCHA challenges, passkey confirmation, and other human verification remain a human handoff through agent focus; no CAPTCHA solver is included. DOM helpers generate synthetic events; native coordinate clicks dispatch through AppKit, which does not guarantee acceptance by a website. A successful command should be followed by a snapshot to verify the result.
Bug reports, feature requests and pull requests are welcome — please use the issue forms and the PR checklist. Before changing code, read the Contributing Guide: the core rules (zero JS injection, runtime-verified Native Engine Bridge capabilities with safe fallback, fail-closed proxies), the project layout, and how to verify changes with swift test and safarier probe.
Safarier is built natively with Swift and Apple WebKit for macOS. Safarier.app bundles an unmodified Universal helper build of SagerNet/sing-box (GPL-3.0-or-later) for multi-protocol proxy routing; full license notices are included inside the application bundle under Contents/Resources/ThirdParty/sing-box/.
- Community & Links: LINUX DO
Mieru uses an unmodified official helper for Apple Silicon and Intel Macs. Its GPL license and source location ship under Contents/Resources/ThirdParty/mieru/. Run scripts/build-mieru.sh before packaging to prepare and verify the helper.