本镜像将微信 Windows 客户端封装于 Wine 桌面环境，通过 3000/3001 端口提供 noVNC Web 访问。需分配足够内存（建议 ≥2GB）并持久化 config 目录保存登录态。微信官方不鼓励非官方客户端，存在账号风控风险；VNC 端口切勿暴露公网，应经 VPN 或 SSH 隧道访问。与业务 API 服务不同，不适合 Kubernetes 无头调度。

快速启动

docker run -d --name weixin \
  -p 3000:3000 \
  -v weixin_config:/config \
  docker.io/linuxserver/weixin:latest

推荐实践

docker run -d --name weixin \
  --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -v /data/weixin/config:/config \
  docker.io/linuxserver/weixin:3.9.10

核心参数说明

• -p 127.0.0.1:3000:3000 — noVNC Web 入口，限制仅本机或隧道访问
• -v /data/weixin/config:/config — Wine 前缀与微信数据持久化
• -e PUID / -e PGID — 卷文件属主 UID/GID
• --restart unless-stopped — 远程桌面会话持续可用
• 账号风险 — 非官方环境可能导致微信限制登录