crosspaste-desktop

环境要求

• 能够访问 GitHub 与 Gradle 依赖仓库的网络环境
• 已安装 Git
• 首次运行需下载 JBR（JetBrains Runtime）与 Gradle 依赖，耗时较长、需要稳定网络
• 若网络受限，需要 VPN 或为 Gradle 配置代理

安装与启动步骤

1. 1下载安装包

   普通用户无需编译源码，可直接从官网下载对应平台的安装包使用。

2. 2克隆仓库

   源码方式部署的第一步，把 crosspaste-desktop 仓库克隆到本地。

   git clone https://github.com/CrossPaste/crosspaste-desktop.git

   复制

3. 3进入项目目录

   切换到刚克隆下来的仓库目录，后续命令都在这里执行。

   cd crosspaste-desktop

   复制

4. 4编译并运行

   使用 Gradle Wrapper 启动桌面应用，首次启动会自动下载 JBR 与依赖，请耐心等待。

   ./gradlew app:run

   复制

5. 5配置 Gradle 代理

   若构建报 Connection reset，可在 gradle.properties 中按 README 示例添加代理参数。

   systemProp.https.proxyHost=localhost
   systemProp.https.proxyPort=8080
   systemProp.https.proxyUser=userid
   systemProp.https.proxyPassword=password
   systemProp.http.nonProxyHosts=*.nonproxyrepos.com|localhost

   复制

关键配置

如何确认成功

执行 ./gradlew app:run 后构建无报错、应用窗口正常弹出并可使用剪贴板功能即成功。

常见问题

注意事项

• README 节选只包含从源码开发运行的说明，未给出 Docker、命令行工具或 MCP 服务器的具体安装命令。
• 多设备同步需处于同一局域网，且各设备均安装并运行 CrossPaste。
• 代理示例中的 host、port、userid、password 需替换为你自己的代理配置。
• 如需了解架构细节，可阅读官网博客系列文章。