WeChat Selkies 本地远程客户端

基于 Electron 的跨平台桌面客户端，用于连接 wechat-selkies 服务，在 Windows、macOS、Linux 上以本地应用形式使用网页版微信/QQ。支持多连接管理、可选账号密码认证、剪贴板与文件说明见 wechat-selkies 侧栏能力。

云端 wechat-selkies 部署可参考：云端微信 - 在服务器持久化存储和运行。

此项目地址：https://github.com/Songxwn/Docker-Wechat-Localclient

PS：完全使用AI编码构建 - 当答案唾手可及，问题就成了新货币

功能特性

特性 说明
多连接管理 保存多个 wechat-selkies 地址，支持添加、编辑、删除、设为默认
应用内/浏览器打开 可在应用内新窗口打开微信页，或按连接配置用系统浏览器打开
账号密码认证（可选） 连接可配置登录用户名与密码，打开网页时自动使用 HTTP Basic 认证
支持语音输入和输出 可接收消息提示音 语音通话
输入法 使用本机输入法
剪贴板与文件 与 Docker 内 wechat-selkies 共享剪贴板（图片+文字）；支持文件拖入上传（依赖 wechat-selkies 侧栏）
SSL 与持久化 每连接可单独设置忽略 SSL 证书错误；配置持久化保存

环境要求

  • 系统：Windows 10/11（x64、ARM64）、macOS 10.15+（Intel / Apple Silicon）、或主流 Linux（x64，AppImage 需 libfuse2）
  • wechat-selkies 服务：已在 Docker 或 Linux 上部署，本机可访问其 HTTPS 地址（通常 https://IP或域名:3001）
  • Node.js：仅从源码运行或本地构建时需要，建议 18+

安装与使用

方式一：安装包（推荐）

从项目 GitHub Release 或自建 CI 产物中下载对应平台的安装包：

  • Windows：WeChat-Selkies-Client-x.x.x-win-x64.exe 或 -win-arm64.exe
  • macOS：WeChat-Selkies-Client-x.x.x-mac-x64.dmg 或 -mac-arm64.dmg
  • Linux：WeChat-Selkies-Client-x.x.x-linux-x64.AppImage

安装后启动，在「已保存的连接」中点击「+ 添加连接」填写 wechat-selkies 服务地址（如 https://192.168.x.x:3001），按需填写登录用户名/密码、勾选忽略 SSL 等，保存后点击「连接」即可。

方式二：从源码运行

1
2
3
4
git clone https://github.com/Songxwn/Docker-Wechat-Localclient
cd Docker-Wechat-Localclient
npm install
npm start

方式三：本地打包安装包

在对应系统上执行：

1
2
3
4
5
6
7
8
9
10
git clone https://github.com/Songxwn/Docker-Wechat-Localclient
cd Docker-Wechat-Localclient

npm install
# Windows
npm run build:win
# macOS（需 Xcode 命令行工具）
npm run build:mac
# Linux（部分发行版需 libfuse2）
npm run build:linux

安装包输出在 dist/ 目录，文件名格式为英文：WeChat-Selkies-Client-版本-系统-架构.扩展名，便于 GitHub Release 上传与下载。

界面说明

主界面包含：

  • 已保存的连接：列表展示名称、服务地址、默认标签；每条可「连接」「编辑」「删除」「设为默认」；右上角「+ 添加连接」
  • 使用说明：部署说明链接（点击在系统浏览器打开）、localhost 改 IP、剪贴板与文件拖入说明
  • 页脚：当前版本号、部署说明与 wechat-selkies 项目链接

添加/编辑连接时可配置：名称、服务地址、登录用户名/密码（可选）、忽略 SSL、是否使用系统浏览器打开。

云端 wechat-selkies Docker部署教程 （支持 Linux AMD64/ARM64）

Docker 国内安装

PS：安装最新版，使用compose V2部署。

https://mirror.nju.edu.cn/mirrorz-help/docker-ce/?mirror=NJU

Docker Hub国内加速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
        "https://docker.1ms.run",
        "https://docker.m.ixdev.cn",
        "https://hub.rat.dev",
        "https://docker.xuanyuan.me"
    ]
}
EOF

systemctl daemon-reload && sudo systemctl restart docker

systemctl enable docker



PS：可去https://status.anye.xyz/ 获取最新可用

Docker Run命令快速部署

1
docker run -it -p 3001:3001 -v ./config:/config --device /dev/dri:/dev/dri nickrunning/wechat-selkies:latest

Docker compose 持久化维护部署

1
2
3
4
5
6
7
8
9
10
cd /opt

mkdir wechat-selkies

cd wechat-selkies

vim docker-compose.yml


## 创建目录和文件

Docker-compose.yml 文件如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
services:
  wechat-selkies:
    image: nickrunning/wechat-selkies:latest    # or ghcr.io/nickrunning/wechat-selkies:latest
    container_name: wechat-selkies
    ports:
      - "3000:3000"       # http port
      - "3001:3001"       # https port
    restart: unless-stopped
    volumes:
      - ./config:/config
    devices:
      - /dev/dri:/dev/dri # optional, for hardware acceleration
    environment:
      - PUID=1000                    # user ID
      - PGID=100                     # group ID
      - TZ=Asia/Shanghai             # timezone
      - LC_ALL=zh_CN.UTF-8           # locale
      - AUTO_START_WECHAT=true       # default is true
      - AUTO_START_QQ=false          # default is false
      # - CUSTOM_USER=<Your Name>      # recommended to set a custom user name
      # - PASSWORD=<Your Password>     # recommended to set a password for selkies web ui

环境变量说明

在 docker-compose.yml 中可以配置以下环境变量：

变量名 默认值 说明
TITLE WeChat Selkies Web UI 标题
PUID 1000 用户 ID
PGID 100 组 ID
TZ Asia/Shanghai 时区设置
LC_ALL zh_CN.UTF-8 语言环境
CUSTOM_USER - 自定义用户名（推荐设置）
PASSWORD - Web UI 访问密码（推荐设置）
AUTO_START_WECHAT true 是否自动启动微信客户端
AUTO_START_QQ false 是否自动启动 QQ 客户端

访问Web

需要通过https访问，示例：https://主机IP:3001

运维技术交流群

发送邮件到 ➡️ [email protected]

或者关注WX公众号：网工格物

微信扫码

博客（最先更新）

https://songxwn.com/