OrbStack 文件共享指南

OrbStack 提供了 macOS 与 Linux 虚拟机之间无缝、双向的文件共享功能，让您在两个系统间操作文件如同操作本地文件一样简单。无需复杂的配置或手动同步，文件更改会实时反映。

核心功能

双向访问: 可从 Linux 访问 macOS 文件，也可从 macOS 访问 Linux 文件。
实时同步: 文件修改会立即在两端生效。
零配置: 开箱即用，无需任何设置。
高性能: 基于 OrbStack 的高速虚拟网络栈，文件传输速度极快。

详细使用方法

# 1. 从 Linux 访问 macOS 文件

在 Linux 机器中，您可以通过两种方式访问 macOS 的文件系统：

方法一：直接使用 macOS 路径 (推荐)
这是最直观的方式。您可以像在 macOS 终端中一样，直接使用 `/Users/你的用户名/…` 路径。

bash

# 示例：列出 macOS 用户 john 的 Downloads 文件夹内容
ls /Users/john/Downloads

# 示例：在 Linux 中用 VSCode (macOS 版本) 打开一个位于 macOS 桌面上的文件
code /Users/john/Desktop/notes.txt

# 示例：将 Linux 中的一个文件复制到 macOS 的文档目录
cp ./my_script.sh /Users/john/Documents/

方法二：使用 `/mnt/mac` 挂载点
所有 macOS 的文件系统都挂载在 Linux 的 `/mnt/mac` 目录下。这是更明确的访问方式。

bash
# 示例：上述操作等价于

ls /mnt/mac/Users/john/Downloads
code /mnt/mac/Users/john/Desktop/notes.txt
cp ./my_script.sh /mnt/mac/Users/john/Documents/

> 总结: `/Users/john/Downloads` 和 `/mnt/mac/Users/john/Downloads` 在 Linux 中指向的是同一个物理位置。推荐使用第一种方式，因为它更简洁，与 macOS 习惯一致。

2. 从 macOS 访问 Linux 文件

在 macOS 中，您可以通过 Finder 或终端访问所有 Linux 机器中的文件。

方法一：通过 Finder (图形界面)
1. 打开 Finder。
2. 在 Finder 侧边栏中，找到并点击 “OrbStack” 标签页。
3. 您会看到所有已创建的 Linux 机器（如 `ubuntu`, `debian` 等）。
4. 点击任意机器名称，即可像浏览本地文件夹一样浏览和操作该 Linux 机器中的文件。

方法二：通过终端 (命令行)
所有 Linux 机器的根文件系统都映射到 macOS 用户主目录下的 `~/OrbStack/` 文件夹中。

bash

# 示例：列出名为 'ubuntu' 的 Linux 机器中 '/home' 目录的内容
ls ~/OrbStack/ubuntu/home

# 示例：将 macOS 桌面上的一个文件复制到 Linux 机器的用户主目录
cp ~/Desktop/report.pdf ~/OrbStack/ubuntu/home/your_linux_username/

# 示例：用 macOS 的文本编辑器打开 Linux 机器中的一个配置文件
open ~/OrbStack/ubuntu/etc/nginx/nginx.conf

> 路径结构: `~/OrbStack/` 下的每一个子文件夹都对应一台 Linux 机器。例如，`~/OrbStack/ubuntu/` 对应名为 `ubuntu` 的机器，其内容就是该机器的整个根目录 `/`。

性能与注意事项

性能: 文件共享基于 OrbStack 的自定义高速网络栈，在 M1 芯片上，macOS 与 Linux 间的吞吐量可达 45 Gbps，确保流畅的开发体验。
权限: 文件权限会尽可能在两个系统间进行映射，但在某些情况下（如复杂的 Linux 用户/组权限），可能会有细微差别。
符号链接: 支持符号链接，但请注意链接的目标路径必须在共享范围内才有效。

总结

OrbStack 的文件共享功能是其“无缝集成”理念的核心体现。无论您是在 Linux 中处理 macOS 上的项目文件，还是在 macOS 上用熟悉的工具编辑 Linux 配置，都能获得一致且高效的体验，极大地提升了跨平台开发的生产力。