{"id":13545562,"url":"https://github.com/huan/docker-wechat","last_synced_at":"2025-05-15T08:02:32.866Z","repository":{"id":37685945,"uuid":"241002058","full_name":"huan/docker-wechat","owner":"huan","description":"DoChat is a Dockerized WeChat (盒装微信) PC Windows Client for Linux","archived":false,"fork":false,"pushed_at":"2023-12-31T19:51:08.000Z","size":1303,"stargazers_count":2300,"open_issues_count":134,"forks_count":201,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-04-14T13:04:47.962Z","etag":null,"topics":["docker","wechat"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/zixia/wechat","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-02-17T02:16:59.000Z","updated_at":"2025-04-12T06:44:14.000Z","dependencies_parsed_at":"2023-01-19T13:02:21.898Z","dependency_job_id":"6d5a7e86-304b-4904-95ca-581245639660","html_url":"https://github.com/huan/docker-wechat","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huan%2Fdocker-wechat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huan%2Fdocker-wechat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huan%2Fdocker-wechat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huan%2Fdocker-wechat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huan","download_url":"https://codeload.github.com/huan/docker-wechat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254301420,"owners_count":22047901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","wechat"],"created_at":"2024-08-01T11:01:05.741Z","updated_at":"2025-05-15T08:02:32.836Z","avatar_url":"https://github.com/huan.png","language":"Shell","funding_links":[],"categories":["Shell","Shell (473)"],"sub_categories":[],"readme":"# DoChat /dɑɑˈtʃæt/ 盒装微信\n\n[![Docker](https://github.com/huan/docker-wechat/workflows/Docker/badge.svg)](https://github.com/huan/docker-wechat/actions?query=workflow%3ADocker)\n[![Powered By Wine](https://img.shields.io/badge/Powered%20By-Wine-red)](https://www.winehq.org/)\n\n[![dockeri.co](https://dockeri.co/image/zixia/wechat)](https://hub.docker.com/r/zixia/wechat/tags)\n\nDoChat(盒装微信) is a Dockerized WeChat(微信) PC Windows Client for Linux.\n\n![DoChat](https://huan.github.io/docker-wechat/images/dochat.png)\n\n\u003e Image Credit: [Docker 101](https://www.docker.com/blog/docker-101-introduction-docker-webinar-recap/) + [Icon Finder](https://www.iconfinder.com/icons/4539886/application_chat_communication_wechat_wechat_logo_icon), and Ps-ed by Ruoxin Song\n\n## Honors\n\n- [Tweeted](https://twitter.com/newsycombinator/status/1231489594765594625) by Y Combinator [Hacker News](https://news.ycombinator.com/item?id=22395507)\n- [Headlined](https://huan.github.io/docker-wechat/images/oschina-feb-25-2020.png) by [OS China](https://www.oschina.net/)\n\n## Disclaimer\n\nWe have received reports from our user said that their WeChat account has been disabled after using this project, so use it at your own risk:\n\n1. [昨天用了一下最新版的docker镜像立马微信就被封了 #55](https://github.com/huan/docker-wechat/issues/55)\n\n## Usage ![Powered Linux](https://img.shields.io/badge/WeChat-Linux-brightgreen)\n\nWeChat PC will be started on your Linux desktop by running the following one-line command:\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh | bash\n```\n\nIf you’re in China, try the following one-line command if the above one-line command does not work well:\n```sh\ncurl -sL https://gitee.com/mirrors/dochat/raw/main/dochat.sh | bash\n```\n\nJust copy/paste the above one-line command to your terminal and press Enter. Then the WeChat PC should appear in your XWindows desktop shortly.\n\n![DoChat Term Command](https://huan.github.io/docker-wechat/images/term-dochat.png)\n\n### Attention\n\nThe [dochat.sh](https://github.com/huan/docker-wechat/blob/master/dochat.sh) script must not be with uid 0 (root user). Running it with uid 0 will lead to an infinite loop\nthat is hard to kill from the terminal. If your user doesn't have the right to run docker please add the user to the docker group `sudo usermod -aG docker $USER`.\n A reboot might be neccessary for the changes to take place.\n\nThe issue is described in [#60](https://github.com/huan/docker-wechat/issues/60).\n\n## Features\n\nIt just works out-of-the-box with one-line of shell command!\n\n1. Input/Display Chinese characters perfectly.\n1. Paste copied images to WeChat with `Ctrl+V`\n\n![DoChat Screenshot](https://huan.github.io/docker-wechat/images/screenshot-dochat.png)\n\n## Requirements\n\n1. Linux Ubuntu distribution will be recommended (DoChat was developed with the Ubuntu Desktop 19.10)\n    1. Debian support confirmed ([#9](https://github.com/huan/docker-wechat/issues/9))\n    1. OpenSUSE Leap 15.1 support confirmed ([#16](https://github.com/huan/docker-wechat/issues/16))\n    1. OpenSUSE Tumbleweed support confirmed ([#150](https://github.com/huan/docker-wechat/issues/150))\n    1. Arch support confirmed ([#26](https://github.com/huan/docker-wechat/issues/26))\n    1. Ubuntu(19.04/18.10/18.04) should be able to support\n    1. Linux Mint 21.2 Cinnamon support confirmed ([#215](https://github.com/huan/docker-wechat/issues/215))\n    1. Other Linux distributions: might be able to support\n1. Docker (run `sudo apt update \u0026\u0026 apt install docker.io` to install Docker for Ubuntu users)\n1. [`nvidia-container-toolkit`](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) may be installed ([#173](https://github.com/huan/docker-wechat/issues/173))\n\n## Environment Variables\n\n### `DOCHAT_DPI`\n\nDPI Scale Factors for graphic screen resolution.\n\n| DPI  | Scale factor |\n| ---: | :---: |\n|  96 | 100% |\n| 120 | 125% |\n| 144 | 150% |\n| 192 | 200% |\n\nDefault: `120`\n\nTo enlarge the window \u0026 fonts size:\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_DPI=192 bash\n```\n\n### `DOCHAT_SKIP_PULL`\n\nIf you do not want to pull docker image for the latest version at startup everytime, you can set `DOCHAT_SKIP_PULL` environment variable.\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_SKIP_PULL=true bash\n```\n\nIn case you have downloaded `dochat.sh`:\n\n```sh\nDOCHAT_SKIP_PULL=true ./dochat.sh\n```\n\n### `DOCHAT_DEBUG`\n\nShow more debug log messages.\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_DEBUG=true bash\n```\n\n### `DOCHAT_WECHAT_VERSION`\n\nUse a specific version for WeChat.\n\nYou can get a full list of the supported versions from Docker Hub Image Tags at \u003chttps://hub.docker.com/r/zixia/wechat/tags\u003e\n\nFor example:\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_WECHAT_VERSION=3.3.0.115 bash\n```\n\n## For Hackers\n\nIf you want to control everything by yourself, for example, open multiple WeChat PC client on your desktop; then, you might want to inspect the [dochat.sh](https://github.com/huan/docker-wechat/blob/master/dochat.sh) in our repository and try the following docker command:\n\n```sh\ndocker run \\\n  --name DoChat \\\n  --rm \\\n  -i \\\n  \\\n  -v \"$HOME/DoChat/WeChat Files/\":'/home/user/WeChat Files/' \\\n  -v \"$HOME/DoChat/Applcation Data\":'/home/user/.wine/drive_c/users/user/Application Data/' \\\n  -v /tmp/.X11-unix:/tmp/.X11-unix \\\n  -v \"/run/user/$(id -u)/pulse\":\"/run/pulse\" \\\n  \\\n  -e DISPLAY \\\n  \\\n  -e XMODIFIERS=@im=fcitx \\\n  -e GTK_IM_MODULE=fcitx \\\n  -e QT_IM_MODULE=fcitx \\\n  -e GID=\"$(id -g)\" \\\n  -e UID=\"$(id -u)\" \\\n  \\\n  --ipc=host \\\n  --privileged \\\n  \\\n  zixia/wechat\n```\n\nModify it whatever you want to fulfill your needs.\n\n## Versioning\n\nThe docker image has two schema of the versioning:\n\n1. `X.Y.Z.a`: This is for the WeChat PC Windows Client version\n    1. `zixia/wechat:2.7.1.85`: WeChat 2.7.1.85\n    1. `zixia/wechat:2.8.0.112`: WeChat 2.8.0.112\n1. `x.y`: This is for the docker image version.\n    1. `zixia/wechat:0.2`: docker-wechat version 0.2\n\nThe two version schema may overlap with each other.\n\nFor example: the `zixia/wechat:0.2` may be the same image as the `zixia/wechat:2.8.0.112`.\n\n## Known Issues\n\n- [ ] WeChat 2.8.0.x can not send big images/files ([#341](https://github.com/huan/docker-wechat/issues/31))\n  - Work around: use [2.7.1.85](https://hub.docker.com/layers/zixia/wechat/2.7.1.85/images/sha256-e6e9d21c7cd1dfae0484e697f12f5f3c401de2f02e771d061868740e0d26549d) instead. (`DOCHAT_WECHAT_VERSION=2.7.1.85`)\n- [ ] In-WeChat Browser does not work ([#2](https://github.com/huan/docker-wechat/issues/2))\n\n## To-do List\n\n- [x] Permanent Storage for WeChat PC Login Data Information ([#3](https://github.com/huan/docker-wechat/issues/3))\n- [ ] Automatically install WeChat PC from .EXE installer when building the Dockerfile. (Test Automation tools might be needed)\n- [ ] Monitor WeChat PC version publications so that we can publish the same version number of the docker image with it.\n- [ ] Resolve the infinite loop situation when running with uid 0 ([#60](https://github.com/huan/docker-wechat/issues/60))\n- [ ] New feature: wechat_pc_api， \u003chttps://github.com/huan/docker-wechat/issues/125\u003e\n\n## FAQ\n\n### System Tray Icon with Gnome Desktop\n\nInstall Gnome Extension: [Top Icons Plus Git](https://extensions.gnome.org/extension/2311/topicons-plus/) by bijignome\n\n\u003e Note 1: there's almost half dozen of the `TopIcons` extensions with very similar name: TopIcons, TopIcons Redux, TopIcons Plus, **TopIcons Plus Git**, TopIconsFix. Use **TopIcons Plus Git**, it's the right one.  \n\u003e\n\u003e Note 2: The `TopIcons Plus` has the bug that cause the `wine` itself shows a window on your desktop. ([#19](https://github.com/huan/docker-wechat/issues/19))\n\n### Exit with code 5 on openSUSE Leap\n\nWhen you encounter problem that the app exit with code 5  on openSUSE Leap, you need to disable X server access control to allow any user to connect to the X server before you start the app. Use below command to disable it:  \n\n`$ xhost +`\n\n### OpenSUSE Tumbleweed Configurations\n\nTo address the issue ([#150](https://github.com/huan/docker-wechat/issues/150)) do the following: (Thanks [Wu Bo](https://github.com/bo-wu))\n\n`$ xhost +; sudo chown -R $USER $HOME/DoChat/`\n\n### No main window after start up with 2 or more monitor setup\n\nThis could be caused by an old bug in wine with multiple monitor setup. Workaround is to start it up with single monitor and then switch to multiple monitors\n\nThis behavior may cause the view disappear when you use the Join Displays mode, so you need change the mode to mirrors when the app start, this script may help:\n\n```Bash\n#bin/bash\nxrandr --output HDMI-1-2 --same-as eDP-1-1\n\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_SKIP_PULL=true bash \u0026\n\nsleep 5\nxrandr --output HDMI-1-2 --right-of eDP-1-1\n```\n\nChange the HDMI-1-2 to your external display name and eDP-1-1 to your built in display name. Display more than two, link to [this](http://www.mikewootc.com/wiki/linux/usage/set_x_reso.html).\n\n***Notice***: you must drag the login dialog to built in display side when the process sleep 5, otherwise the view may stuck in the external display.\n\n## Links\n\n- [Input Method don't work when using X11Forward](https://ubuntuforums.org/showthread.php?t=913752)\n- [Input method related environment variables](https://fcitx-im.org/wiki/Input_method_related_environment_variables)\n- [Docker GUI最佳实践](https://github.com/zjZSTU/Containerization-Automation/blob/982d54458b05ef75fe6436f4ea72bbb66c4cb931/docs/docker/gui/%5BDocker%5DGUI最佳实践.md)\n- [Linux 下 完美运行 wechat 微信](https://www.kpromise.top/run-wechat-in-linux/)\n- [WeChat Desktop on Linux](https://ferrolho.github.io/blog/2018-12-22/wechat-desktop-on-linux)\n\n## History\n\n### master v0.14\n\n1. Update to WeChat version 3.3.0.115 ([#131](https://github.com/huan/docker-wechat/issues/131))\n1. Upgrade to Wine version 6.0\n1. Upgrade to Debian 11 (bullseye)\n1. Rename default branch from `master` to `main`\n\n### v0.10 (Mar 12, 2020)\n\n1. Upgrade wine from v4.0 to v5.0\n1. Deploy to Docker Hub by GitHub Actions with Automatic WeChat Version Number.\n\n### v0.8 (Mar 3, 2020)\n\n1. Add a new configuration environment variable `DOCHAT_WECHAT_VERSION` to select WeChat version.\n1. Add WeChat v2.8.0.112\n    1. 新增订阅号浏览\n    1. 新增IPv6网络支持\n    1. 新增看一看精选内容\n    1. 新增打开聊天中小程序消息\n    1. 新增在小程序中使用微信支付\n    1. 新增聊天文件面板，可查看和管理所有聊天文件\n\n```sh\ncurl -sL https://raw.githubusercontent.com/huan/docker-wechat/master/dochat.sh \\\n  | DOCHAT_WECHAT_VERSION=2.8.0.112 bash\n```\n\n### v0.5 (Feb 24, 2020)\n\n1. Add environment variable `DOCHAT_DPI` to set DPI scale factors for graphicg screen resolution.\n1. Disable auto-update.\n\n### v0.4 (Feb 21, 2020)\n\nGot a great logo from my art friend Ruoxin SONG.\n\n1. Fix Sound ([#1](https://github.com/huan/docker-wechat/issues/1))\n1. Fix to not exit during the upgrading progress.\n\n### v0.2 (Feb 18, 2020)\n\nThe first working version, cheers!\n\n### v0.1 (Feb 17, 2020)\n\nProject created.\n\n## Thanks\n\n1. [WeChat Desktop on Linux](https://ferrolho.github.io/blog/2018-12-22/wechat-desktop-on-linux) - by [@ferrolho](https://github.com/ferrolho)\n1. [Wine HQ App Database - WeChat](https://appdb.winehq.org/objectManager.php?sClass=application\u0026iId=16931)\n1. [基于深度操作系统的微信 docker 镜像](https://github.com/bestwu/docker-wechat) by [@bestwu](https://github.com/bestwu)\n1. DoChat logo designed by my friend Ruoxin SONG.\n\n## Related Projects\n\n1. [DoWork /dɑɑˈwɜːk/ 盒装企业微信](https://github.com/huan/docker-wxwork): Dockerized WeChat Work (企业微信) PC Windows Client for Linux\n1. Put your WeChat in the box: \u003chttps://github.com/ChisBread/wechat-box\u003e\n\n## Contributors\n\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/0)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/0)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/1)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/1)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/2)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/2)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/3)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/3)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/4)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/4)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/5)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/5)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/6)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/6)\n[![contributor](https://sourcerer.io/fame/huan/huan/docker-wechat/images/7)](https://sourcerer.io/fame/huan/huan/docker-wechat/links/7)\n\n## Author\n\n[Huan Li](https://github.com/huan) ([LinkedIn](http://linkedin.com/in/huan42)) Tencent TVP of Chatbot.\n\n[![Profile of Huan LI (李卓桓) on StackOverflow](https://stackexchange.com/users/flair/265499.png)](https://stackexchange.com/users/265499)\n\n## Copyright \u0026 License\n\n- Code \u0026 Docs © 2020-now Huan Li \\\u003chuan@chatie.io\\\u003e\n- Code released under the Apache-2.0 License\n- Docs released under Creative Commons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuan%2Fdocker-wechat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuan%2Fdocker-wechat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuan%2Fdocker-wechat/lists"}