# Remote GDB Server 配置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> 本地操作系统  ：macOS / Linux / Windows
>
>
>
> 远程操作系统  ：支持 gdbserver、SSH 和 SFTP 的任何系统
>
>
>
> 必需工具  ：目标设备上的 [gdbserver](https://sourceware.org/gdb/onlinedocs/gdb/Server.html)
>
>
>
> 二进制文件同步  ：自动
>
>
>
> 客户端调试器  ：捆绑的 GDB / 工具链的 GDB / 自定义 GDB
>
>
>
> 构建目标  ：CMake / Makefile / 自定义构建目标

远程 GDB 服务器   配置会在本地构建您的目标，将二进制文件上传到远程机器，在  gdbserver  下启动它，并连接到 CLion 调试器。

Procedure: 创建 Remote GDB Server 配置

1. 在主菜单中，转到   运行 | 编辑配置  ，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，并从模板列表中选择   远程 GDB 服务器  。

2. 指定以下设置：

![Remote GDB Server 配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_config.png)

* 目标 和 可执行文件 选择要构建的目标（ [CMake](quick-cmake-tutorial.html)、 [Makefile](makefiles-support.html) 或 [自定义目标](custom-build-targets.html)）以及要远程上传的可执行文件。 点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 按钮，在 `设置 | 构建、执行、部署 | 自定义构建目标` 对话框中 [配置自定义目标](custom-build-targets.html#customtarget-compdb)。

* GDB 选择客户端调试器：捆绑的多架构 GDB（默认）、工具链调试器之一或自定义 GDB 二进制文件。

* 凭据 从下拉列表中选择现有的 SSH 配置之一，或点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 创建一个新配置。 提供访问远程机器的凭据： ![远程凭据](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_credentials.png) > **Tip:** > 您还可以在 `设置 | 工具 | SSH 配置` 中管理 SSH 配置。

* 上传可执行文件 每次启动调试会话时（ 始终 ）或二进制文件发生更改时（ 仅更新 ），都可以上传可执行文件。 您还可以选择跳过上传（ 无 ）。

* 上传路径 指定可执行文件将被放置的远程文件夹。

* 'target remote' 参数 提供用于传输调试数据包的媒介（串行线路或使用 TCP 或 UDP 的 IP 网络）。 有关连接到远程目标的更多详细信息，请参阅 [gdb 文档](https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html#Connecting)。

* GDB Server 设置远程机器上 gdbserver 的位置。 默认路径会自动填充。

* GDB 服务器参数 指定将传递给 gdbserver 的参数：连接端口、可执行文件路径以及必要时的其他参数。 默认情况下，此字段包含您在 'target remote' 参数 中提供的端口和 上传路径 中的路径，后跟二进制文件名。

> **Note:**
> 对于 CMake 项目，默认情况下，此配置使用当前选择的 [CMake 配置文件](cmake-profile.html) 构建您的目标，并从   构建目录   文件夹中获取二进制文件。
>
>
>
> 如果您的设置需要交叉编译工具链，请确保 [创建](how-to-create-toolchain-in-clion.html)它，配置相应的  Debug  配置文件，并在开始会话之前切换到此配置文件。

Procedure: 启动远程调试会话

1. 确保选择   GDB   作为您的工具链调试器。

* 在 macOS 和 Linux 上，转到 `设置 | 构建、执行、部署 | 工具链` ，并在当前工具链的 调试器 字段中选择一个可用的 GDB 选项。

* 请注意，在 Windows 上， 远程 GDB 服务器 配置无法与 [Visual Studio 工具链](quick-tutorial-on-configuring-clion-on-windows.html) 一起使用，因为它使用的 [调试器](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger) 基于 LLDB。

> **Tip:**
> 确保您的系统防火墙允许连接到远程 GDB 服务器。

2. 在代码中设置断点后，选择新创建的 Remote GDB Server 配置，并按 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg)（ `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `⌘ R` (Xcode), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Alt+F5` (ReSharper), `⌥ F5` (ReSharper (macOS)), `F5` (QtCreator), `⌘ Y` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS))）。

* 您可以在 消息 工具窗口中找到构建日志： ![构建日志](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_buildlog.png)

* 要监控上传过程，请切换到 文件传输 窗口： ![文件传输](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_filetransfer.png)

* 控制台 工具窗口的 调试 选项卡显示 GDB/gdbserver 连接的状态： ![远程调试控制台](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_console.png)

3. 您可以像往常一样调试程序：检查变量、逐步执行、评估表达式，并使用所有其他调试功能。

![使用远程 GDB 服务器进行调试](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_gdbserver_debugging.png)

## See also

### 外部链接

[CLion Debugging Beyond the Basics - Part 3 - Beyond Local](https://blog.jetbrains.com/clion/2021/05/clion-debugging-beyond-the-basics-part-3-beyond-local) [Webinar Recording: Remote Development with CLion](https://blog.jetbrains.com/clion/2019/03/webinar-recording-remote-development-with-clion)

### 操作指南

[复杂的远程场景](complicated-remote-scenarios.html)

