Linux下如何检测应用首个实例并向已运行实例发送IPC消息唤醒

核心采用Unix域套接字+Linux抽象命名空间方案，可直接解决你遇到的两个问题，代码量极小：

• 抽象命名空间的套接字地址生命周期和进程绑定，进程崩溃后内核会自动释放地址，无锁残留问题
• 新实例可通过绑定地址的返回结果直接判断是否为首个运行实例，无需额外校验逻辑

具体实现逻辑 #

1. 首实例运行流程 #

• 创建SOCK_DGRAM类型的Unix域套接字
• 绑定到抽象命名空间地址，地址格式为\0你的应用唯一标识（开头为NULL字符，和普通文件系统路径的Unix套接字做区分）
• 启动异步监听逻辑，收到唤醒消息后调用GUI框架的窗口激活接口即可：
  • X11环境可直接调用XRaiseWindow接口
  • Wayland环境遵循对应合成器的窗口激活规范实现
  • 常见GUI框架（Qt/GTK/Electron等）均内置窗口激活的封装方法，无需直接调用系统API

2. 非首实例运行流程 #

• 创建相同类型的Unix域套接字
• 尝试绑定同一个抽象地址，若返回EADDRINUSE错误，说明已有实例运行
• 向该地址发送自定义唤醒消息，发送完成后当前进程直接退出
• 若绑定成功则按首实例流程继续运行

极简C语言示例代码 #

#include <sys/socket.h>
#include <sys/un.h>
#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
#include <string.h>

// 抽象地址开头必须是\0，后面替换为你应用的唯一标识
#define APP_SOCK_ADDR "\0my_unique_desktop_app"
#define ADDR_LEN (sizeof(APP_SOCK_ADDR) - 1)

// 替换为你自己的窗口前置实现
void raise_app_window() {
    printf("收到唤醒信号，窗口前置\n");
}

int main() {
    int fd = socket(AF_UNIX, SOCK_DGRAM, 0);
    if (fd < 0) {
        perror("创建套接字失败");
        return 1;
    }

    struct sockaddr_un addr = {.sun_family = AF_UNIX};
    memcpy(addr.sun_path, APP_SOCK_ADDR, ADDR_LEN);
    socklen_t addr_full_len = sizeof(addr.sun_family) + ADDR_LEN;

    if (bind(fd, (struct sockaddr*)&addr, addr_full_len) < 0) {
        if (errno == EADDRINUSE) {
            // 已有实例运行，发唤醒消息后退出
            sendto(fd, "wakeup", 6, 0, (struct sockaddr*)&addr, addr_full_len);
            close(fd);
            return 0;
        }
        perror("绑定地址失败");
        close(fd);
        return 1;
    }

    // 首实例监听消息
    char buf[16];
    while (recvfrom(fd, buf, sizeof(buf), 0, NULL, NULL) > 0) {
        if (strcmp(buf, "wakeup") == 0) {
            raise_app_window();
        }
    }

    close(fd);
    return 0;
}

框架内置方案（更简单） #

如果你使用主流GUI框架，可直接用内置的单实例能力，无需手动实现IPC逻辑：

• GTK：使用GApplication，设置G_APPLICATION_DEFAULT_FLAGS标志后，调用g_application_run默认启用单实例逻辑，二次启动会触发activate信号，在信号回调中做窗口前置即可
• Qt：使用QSingleApplication组件，或者Qt 6内置的单实例支持，二次启动会触发instanceStarted信号
• Electron：使用app.requestSingleInstanceLock()接口，二次启动会触发second-instance事件

内容的提问来源于stack exchange，提问作者Eric Stotch