安装

没有安装程序。一个可执行文件，放哪儿都能跑，界面在浏览器里打开。

先选对文件

下载清单读取中…

文件名里带 bofilex 的才是这个程序。分不清 Mac 是哪种芯片：左上角 → 关于本机，写着「芯片 Apple M…」就是 Apple 芯片，写着「处理器 Intel…」就是 Intel。

Windows

下载 bofilex-wails-windows-amd64.exe，放到一个你自己的目录，比如 D:\BoFileX\。别放在「下载」文件夹里 —— 那里的东西迟早被清理掉。
双击运行。第一次会弹「Windows 已保护你的电脑」，那是因为这个程序没有买代码签名证书。点「更多信息」→「仍要运行」。
它会打开自己的窗口。第一次打开先加入一个圈子，或者用邮箱登录 —— 之后名单里就有人了。

放行防火墙

第一次运行时 Windows 会弹「是否允许此应用通过防火墙」，专用网络和公用网络都勾上。只勾专用网络的话，换到别的网络（酒店、公司访客 Wi-Fi）就只能走中转，慢很多。

开机自动运行（可选）

用控制台版 bofilex-windows-amd64.exe 更合适：它不开窗口，界面在浏览器里。Win+R 输入 shell:startup，把它的快捷方式放进去就行。

校验（可选）

certutil -hashfile bofilex-wails-windows-amd64.exe SHA256

拿这串和上面表里同一个文件的 sha256 对一下，一致就对了。

卸载

删掉这个 exe。配置和身份密钥在 %ProgramData%\bofilex\，一起删掉就彻底干净了 —— 删了等于换了一台新机器，联系人要重新加你。

macOS

Mac 版是命令行程序，没有 .app 图标 —— 界面在浏览器里。三条命令装完。

下载并给执行权限（Apple 芯片用 arm64，Intel 用 amd64）：

curl -fsSLO https://bofile.com/releases/bofilex-darwin-arm64
chmod +x bofilex-darwin-arm64

解除隔离标记。从网上下载的、没有苹果签名的程序会被 Gatekeeper 拦下，报「无法打开，因为无法验证开发者」。这条命令去掉那个标记：
```
xattr -dr com.apple.quarantine ./bofilex-darwin-arm64
```
运行，然后打开它打印出来的那个本机地址（一般是 http://127.0.0.1:34120）：
```
./bofilex-darwin-arm64
```

不想敲第 2 条命令的话，也可以在访达里按住 Control 点这个文件 → 打开，在弹窗里再点一次「打开」，效果一样。之后再运行就不问了。

校验（可选）

shasum -a 256 bofilex-darwin-arm64

后台常驻（可选）

要让它开机就跑、关掉终端也不退出，用 launchd：~/Library/LaunchAgents/ 下放一个 plist，ProgramArguments 写上二进制的绝对路径，然后 launchctl load。临时用的话 nohup ./bofilex-darwin-arm64 & 就够。

卸载

删掉二进制，再删 ~/Library/Application Support/bofilex/。

Linux

下载并给执行权限（uname -m 是 x86_64 就用 amd64，aarch64 用 arm64）：

curl -fsSLO https://bofile.com/releases/bofilex-linux-amd64
chmod +x bofilex-linux-amd64

校验，对着清单里的那一行：

sha256sum bofilex-linux-amd64
curl -s https://bofile.com/api/release | grep -A2 '"bofilex-linux-amd64"'

运行。有桌面的机器上它会自己开浏览器；没有桌面的看下面一节。
```
./bofilex-linux-amd64
```

没有桌面的服务器

界面只开在回环地址 127.0.0.1:34120 上。用 ssh 隧道打开它，端口不用对外开放：

# 在服务器上
./bofilex-linux-amd64

# 在你自己的电脑上，另开一个终端
ssh -N -L 34120:127.0.0.1:34120 你的用户名@服务器地址
# 然后浏览器打开 http://127.0.0.1:34120

卸载

rm -rf ~/.config/bofilex        # 身份密钥、联系人和配置

升级

界面里有更新按钮，点一下自己下载、校验、替换、重启，身份密钥、联系人和授权都保留。手工升级就是把新文件盖掉旧文件 —— 唯一要注意的是正在运行的程序先退出（Windows 上占用中的文件会直接报拒绝访问）。

配置和身份密钥不在程序目录里，所以换文件不会丢东西：Windows 在 %ProgramData%\bofilex\，macOS 在 ~/Library/Application Support/bofilex/，Linux 在 ~/.config/bofilex/。备份这个目录 = 备份这台机器的身份。

装不上时先看这几条

Windows 报「已保护你的电脑」/ 杀软报毒: 没有代码签名证书的程序都会这样。点「更多信息 → 仍要运行」；杀软误报的话把这个文件加进白名单。用 /api/release 里的 sha256 核对一下，能确认你拿到的和我们发布的是同一个文件。
Mac 说「无法打开，因为无法验证开发者」: Gatekeeper 的隔离标记。跑 xattr -dr com.apple.quarantine ./bofilex-darwin-arm64，或者右键（Control+点击）→ 打开。
Mac 说 bad CPU type 或 cannot execute binary file: 下错架构了。Apple 芯片要 bofilex-darwin-arm64，Intel 要 bofilex-darwin-amd64。
Linux 上 Permission denied: 忘了 chmod +x。如果加了还不行，可能是文件在挂了 noexec 的分区上（常见于 /tmp），换个目录。
界面打不开，说端口被占: 不会打不开：34120 被占用时它会自动改用一个空闲端口，并把浏览器开到那个端口上。看它启动时打印的地址。
能连上，但速度一直很慢: 多半是走了中转没走直连。防火墙要放行 UDP，不只是 TCP —— 少一条 UDP 规则的典型症状就是「能用但慢」。会话里点传输记录能看到走的是直连还是中转。