安装与设置
面向所有平台的 Netcatty 部署综合指南
Netcatty 是一款真正跨平台的应用程序，基于 Electron 和 React 构建。我们为 macOS（Apple Silicon 和 Intel）、Windows 10/11 以及主流 Linux 发行版提供一流的支持。
本指南涵盖了每个平台的安装过程、安装后配置以及故障排除。
macOS 安装
Mac 用户（尤其是 DevOps 领域的开发者）是我们的核心用户群。我们支持 macOS Catalina (10.15) 及更高版本。
方法 1：DMG（推荐）
.dmg（磁盘映像）是标准的发布格式。
下载
访问 GitHub Releases 页面。 根据你的芯片架构下载对应的 DMG：
- Apple Silicon (M1/M2/M3/M4)：
Netcatty-x.x.x-mac-arm64.dmg - Intel Mac：
Netcatty-x.x.x-mac-x64.dmg
安装
双击下载的 .dmg 文件。
将 Netcatty 图标拖入 Applications 文件夹快捷方式。
Gatekeeper 绕过
未签名二进制文件警告
作为一个开源项目，我们目前没有向 Apple 支付每年 99 美元的开发者费用以进行应用公证。macOS Gatekeeper 默认会阻止该应用，提示“无法检查其是否包含恶意软件”。
解决方法：
- 打开你的终端 (
Cmd+Space，输入 "Terminal")。 - 运行以下命令移除“隔离”属性：
xattr -cr /Applications/Netcatty.app - 现在正常打开 Netcatty。它将无碍启动。
方法 2：Homebrew（非官方）
虽然我们目前尚未维护官方 Cask，但如果你更喜欢命令行管理，可以手动安装。
（注：稍后将在此处添加 brew install --cask 支持的说明）。
Windows 安装
我们支持 Windows 10 (Build 1809+) 和 Windows 11。
方法 1：NSIS 安装程序 (.exe)
这是标准的基于向导的安装程序。
- 下载：
Netcatty-Setup-x.x.x.exe - 权限： 不 需要管理员权限。安装到
%LOCALAPPDATA%\Programs\netcatty。 - 自动更新： 支持后台自动更新。
方法 2：便携模式 (目录)
适用于在公司受限笔记本电脑上无法安装软件的用户。
- 下载：
Netcatty-x.x.x-win-x64.zip（或从 releases 中的win-unpacked目录提取） - 使用方法： 解压到任意文件夹，直接运行
Netcatty.exe。 - 数据存储： 在用户配置文件中创建
data文件夹。你可以将整个文件夹复制到 USB 驱动器上随身携带。
Linux 安装
我们将 Linux 视为一等公民。
方法 1：AppImage (通用)
适用于 Arch, Ubuntu, Fedora, CentOS, OpenSUSE 等。
- x86_64： 下载
Netcatty-x.x.x-linux-x64.AppImage - ARM64 (树莓派等)： 下载
Netcatty-x.x.x-linux-arm64.AppImage
chmod +x Netcatty-*.AppImage
./Netcatty-*.AppImage方法 2：Debian/Ubuntu (.deb)
- x86_64： 下载
Netcatty-x.x.x-linux-x64.deb - ARM64： 下载
Netcatty-x.x.x-linux-arm64.deb
sudo dpkg -i Netcatty_*.deb
# 或者
sudo apt install ./Netcatty_*.deb方法 3：RPM (Fedora/RHEL)
- x86_64： 下载
Netcatty-x.x.x-linux-x64.rpm - ARM64： 下载
Netcatty-x.x.x-linux-arm64.rpm
sudo rpm -i Netcatty-*.rpm
# 或者
sudo dnf localinstall Netcatty-*.rpm应用数据位置
如果你需要手动备份或迁移数据，以下是 Netcatty 存储其数据库和设置的位置：
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/netcatty/ |
| Windows | %APPDATA%\netcatty\ |
| Linux | ~/.config/netcatty/ |
该文件夹内包含：
- 数据库： 本地数据存储在系统的标准应用存储中。
- 同步负载：
netcatty-vault.json（用于云同步的加密包）。 - 日志：
logs/目录包含运行时的调试信息。
安装故障排除
"GPU 进程崩溃" (Linux)
某些旧的 Linux GPU 驱动程序会与 Electron 的硬件加速产生冲突。
解决方法： 使用 --disable-gpu 参数启动。
./Netcatty --disable-gpu"代码签名无效" (macOS)
如果应用在 macOS 上启动后立即崩溃：
- 确保你已将其移动到
/Applications。直接从下载文件夹运行通常会触发“应用易位”安全机制，从而破坏资源加载。 - 重新运行
xattr -cr命令。
"杀毒软件误报" (Windows)
由于我们的安装程序没有使用 EV 证书（每年花费约 400 美元）签名，Windows Defender SmartScreen 可能会显示“Windows 已保护你的电脑”弹出窗口。 解决方法： 点击“更多信息” -> “仍要运行”。这通常只发生在个别新版本的初期用户身上，直到微软的信誉系统识别该版本是安全的。