UTranDub 提供 Windows、macOS、Linux 三大主流操作系统的客户端安装包。本指南将详细介绍如何在不同平台上安装和运行 UTranDub。
概述
系统要求
硬件要求
推荐配置
- CPU：4 核心及以上
- 内存：8GB RAM 及以上
- 存储：5GB 可用空间
操作系统要求
- Windows：Windows 10 及以上版本（64 位）
- macOS：macOS 12 (Monterey) 及以上版本
- Linux：Ubuntu 20.04+、Debian 11+、CentOS 7+ 等主流发行版
端口说明
软件启动后默认占用 52080 端口作为服务端口。首次启动前请确保该端口未被其他程序占用：
Windows（命令提示符）
netstat -ano | findstr :52080macOS / Linux（终端）
lsof -i :52080若端口被占用，可先关闭占用程序后再启动软件。进入软件后，可在「设置 → HTTP API」中修改服务端口，重启软件后生效。
安装前请确保您的操作系统已更新至最新版本，并已关闭可能冲突的安全软件。
Windows 安装
安装步骤
- 1
下载安装包
从「下载」页面获取 Windows 版本安装包（.exe 格式）。
- 2
运行安装程序
双击下载的 .exe 文件启动安装向导。
- 3
按照向导安装
选择安装目录，点击「下一步」继续，等待安装完成。
- 4
启动 UTranDub
安装完成后，桌面会自动创建快捷方式，双击启动即可。
未签名软件警告
为了降低分发成本并保持软件免费，我们暂未进行商业代码签名。因此运行安装程序或启动软件时，Windows 可能会弹出以下安全提示：
- SmartScreen 警告：出现「Windows 已保护你的电脑」蓝色弹窗时，请点击「更多信息」，然后点击「仍要运行」。
- 用户账户控制（UAC）：弹出「你要允许此应用对你的设备进行更改吗？」时，请点击「是」。
- 杀毒软件误报：部分杀毒软件可能会误报威胁，请将 UTranDub 添加至信任列表或白名单。
首次启动可能需要允许防火墙访问权限，请点击「允许」以确保正常运行。
macOS 安装
安装步骤
- 1
下载安装包
从「下载」页面获取 macOS 版本安装包（.dmg 格式）。
- 2
打开 DMG 文件
双击下载的 .dmg 文件，系统会自动挂载安装镜像。
- 3
拖入应用程序
将 UTranDub 图标拖动到「Applications（应用程序）」文件夹中。
- 4
首次启动
在应用程序文件夹中找到 UTranDub，右键点击选择「打开」（首次需要确认安全性）。
未签名软件警告
为了降低分发成本并保持软件免费，我们暂未进行 Apple 公证（Notarization）。首次打开时 macOS Gatekeeper 会阻止运行，请按以下方式处理：
- 方式一（推荐）：在应用程序文件夹中找到 UTranDub，按住 Control 键点击图标，选择「打开」，在弹出的对话框中再次点击「打开」。此操作只需执行一次，之后可正常双击启动。
- 方式二：前往「系统设置 → 隐私与安全性」，在「安全性」区域底部会看到被阻止的 UTranDub 提示，点击「仍要打开」。
Linux 安装
安装步骤
- 1
下载安装包
从「下载」页面获取 Linux 版本安装包（.AppImage 格式）。
- 2
添加执行权限
右键点击文件 → 属性 → 权限，勾选「允许作为程序执行」；或在终端中执行以下命令：
chmod +x UTranDub-*.appImage - 3
运行程序
双击 UTranDub-*.appImage 文件即可启动。若需在终端中运行，请使用非 root 用户执行：
./UTranDub-*.appImage --no-sandbox
重要提示：部分 Linux 发行版可能需要安装 FUSE 库以支持 AppImage 运行。如遇到问题，请执行 sudo apt install libfuse2（Ubuntu / Debian）或 sudo yum install fuse（CentOS）。
常见问题
支持哪些操作系统？
UTranDub 支持 Windows 10 / 11（64 位）、macOS 12+，以及 Ubuntu、Debian、CentOS 等主流 Linux 发行版。
安装后无法启动怎么办？
请检查是否满足系统要求，并确保操作系统已更新至最新版本。Windows 用户请检查防火墙设置；macOS 用户请确认已在「隐私与安全性」中允许运行。
提示端口被占用怎么办？
先执行 netstat -ano | findstr :52080（Windows）或 lsof -i :52080（macOS / Linux）找到占用端口的程序并关闭，然后重新启动软件。也可进入软件后前往「设置 → HTTP API」修改端口号，重启后生效。
Linux 下运行 AppImage 提示权限错误？
请确保已为文件添加执行权限（chmod +x 文件名.appImage）。终端运行时请使用非 root 用户并添加 --no-sandbox 参数。如提示 FUSE 相关错误，请安装 libfuse2 库。