docker_wechat

About

這是一個在Linux系統下，使用容器來運作微信的方案。

• 容器運作環境：Docker、Wine、LXDE、xRDP
  • LXDE：輕量的桌面環境，微信只能在圖形介面下安裝和運作。
  • xRDP：用於從Windows遠端連接桌面進行設定。
• 基於WeChatFerry部署， thanks to lich0821
• 資源使用：
  • 磁碟:
    • 建造後鏡像大小約4.69G；
    • Wine第一次啟動，自動初始化後容器佔用1.49G；
    • 微信安裝後，初始狀態佔用1.41G。 預設配置已將這部分檔案放到宿主機的掛載目錄；
    • 微信長期使用，磁碟佔用會持續增加；
  • 記憶體：
    • 桌面登入後，總佔用194M；
    • 微信啟動，總佔用約1.7G，微信登入後，總佔用約4.9G 。 宿主機需要預留充足的記憶體空間；

Usage

獲取資源

在WeChatFerry發佈頁下載安裝包WeChatSetup和工具包v??.?.?.zip ，放到工程目錄./package 。

WeChatFerry迭代頻繁，目前最新版本是

建構鏡像

$ sudo ./docker/docker_build.sh

• 預設使用root作為xRDP用戶，預設密碼為123 ，請按需修改。

啟動鏡像

$ sudo ./docker/docker_run.sh

啟動腳本的預設容器存取配置，宿主机=>容器關係如下，請按需調整：

• 連接埠映射：
  • xRDP埠： 13389 => 3389
  • WeChatFerry指令連接埠： 18001 => 8001
  • WeChatFerry訊息連接埠： 18002 => 8002
• 目錄掛載：
  • 安裝資料： ./package => /root/package (僅在第一次安裝微信時使用)
  • 程式檔案： ./wechat/program => /root/.wine/drive_c/Program Files/Tencent/WeChat
  • 圖示檔： ./wechat/share/icons => /root/.local/share/icons
  • 使用者資料： ./wechat/user_dat => /root/.wine/drive_c/users/root/AppData/Roaming/Tencent/WeChat
  • 將程式和使用者資料目錄掛載到宿主機，可避免在容器重設後再次安裝程式。

登入桌面

• Windows啟動远程桌面连接，位址：服务器IP:13389
• 進入xRDP登入窗口， username ： root ， password ： 123

安裝微信

• 如果已設定了掛載目錄，且已安裝過微信，則不需要再次安裝。
• 進入桌面，啟動安裝程式。有2種啟動方式：
  1. 桌面捷徑啟動： 開啟桌面圖示WeChatSetup
  2. 命令列啟動：左下角啟動終端機LXTerminal ，執行：

     $ wine package/WeChatSetup- * .exe

• 開始常規安裝流程，完成安裝後關閉。

啟動微信

• 進入桌面，啟動應用程式。有2種啟動方式：
  1. 桌面捷徑啟動： 開啟桌面圖示WeChatFerry
  2. 命令列啟動：左下角啟動終端機LXTerminal ，執行：

     $ ./res/launch.sh

     啟動後終端機不能關閉或退出。
• 微信常規配置，左下角Settings：
  • Notifications：關閉所有
  • General -> General：不選所有
  • Manage Files -> Auto-Download：不選
• 啟動並登入後，直接關閉遠端桌面，不要Logout 。 因為登出後圖形介面下執行的所有程式都會退出。

測試

在主機執行測試腳本： ./test/test_wcferry.py ，訊息預設傳送給文件传输助手。

FAQ

版本說明

• 版本號碼和WeChatFerry保持基本一致，方便對照
• tag: v39.2 ：支援WeChatFerry的tag: v39.2.x以上版本

運行報錯

• 故障現象：
  • 不同環境現像不同，目前遇到以下幾種
  • 啟動過程中Wine報錯並退出
  • Wine啟動立即報錯並退出
  • xRDP連線報錯
• 故障分析：
  • 目前啟動異常的情況，常見於使用舊發行版系統的伺服器， 如：CentOS 7 (kernel 4.x)。
  • 經驗證，使用較新發行版系統的伺服器，都可以正常運作。 如：Fedora 39/40 (kernel 6.x)
  • 具體原因暫不明確，推測與核心版本有關。
• 解決方案：
  • 建議使用較新的Linux發行版。

閃退或應用黑屏

• 故障現象：
  • 應用程式啟動立即退出
  • 應用程式介面是黑色的，但可以點選可以拖曳，拖曳過程又能看到應用程式介面
• 故障分析：
  • 故障出現之前有正常運作過。
  • 目前僅在調試階段有遇到。
  • 在調試過程中，某些操作可能誤殺了系統服務進程
• 解決方案：
  • 關閉並刪掉容器，重新啟動鏡像