NAS 自建微信文件傳輸助手，跨設備文件傳輸方案？wxchat部署指南

筆者日常感覺跨設備傳文件，不光Windows/Mac/Linux、安卓/iOS這種跨平臺限制，更有QQ/微信等這些不同軟件之間的溝溝坎坎。想要快速飛幾個文件，體驗真的是太惡了！

本期來介紹新項目docker-wxchat，一個 Docker 版本的微信文件傳輸助手。其實過去也分享過多個類似應用，但目前來說我比較推薦這一款，大家可以用用看。

在 NAS 上部署後，用瀏覽器打開它，就能像聊天一樣在手機、電腦、平板之間快速互傳文件、圖片、文字和鏈接，數據留在自己設備裏，不依賴微信/網盤等第三方平臺；需要的話還可接入大模型做 AI 聊天/畫圖。

項目特點

本項目基於xiyewuqiu/wxchat開發的微信文件傳輸助手，使用 Docker 容器化部署。完整項目名：DEKVIW/docker-wxchat。

定位明確：基於 xiyewuqiu/wxchat 的微信文件傳輸助手，自託管 + Docker 部署，開箱即用，還擴展了 AI 聊天與 AI 圖像生成。
核心功能完整：跨設備文件傳輸（手機/電腦/平板）、文件上傳下載預覽、JWT 安全認證、PWA 可安裝成桌面/手機應用。
Docker 版體驗優化：長文本不截斷、內容完整顯示；滑動確認清空、一鍵複製；支持單條消息刪除、時間顯示修正；
連接與狀態更穩：智能連接狀態提示與邏輯修復，減少誤判“連接中”。
配置更靈活、性能更好：增加 AI 開關、最大上傳大小等環境變量；上傳/下載速度與進度更直觀；歷史消息加載上限大幅提高（一次最多 10w 條）；自動刷新降頻（1 秒→5 秒），減少無效請求；滾動位置、歷史保留等細節修復。

部署流程

本文以威聯通NAS爲部署演示平臺，通過Docker Compose的方式進行部署。

首先準備一個.env環境變量配置文件，放於Docker目錄下，我的路徑爲/share/Container/wxchat。

文件內容如下，註釋都很清晰，大家自行調整即可，AI部分用不到整塊兒刪除即可：

# 微信文件傳輸助手 - Docker環境配置示例
# 複製此文件爲 .env 並修改相應配置
# 應用基礎配置
# 運行環境：production(生產) | development(開發)
NODE_ENV=production
# 服務端口號，默認3000
PORT=3000
# 數據庫配置
# SQLite數據庫文件路徑（容器內路徑）
DATABASE_PATH=/app/data/wxchat.db
# 文件存儲配置
# 文件上傳存儲路徑（容器內路徑）
UPLOAD_PATH=/app/uploads
# 安全配置（重要：生產環境必須修改）
# 訪問密碼：用於登錄系統，請修改爲強密碼
ACCESS_PASSWORD=123456
# JWT密鑰：用於生成和驗證訪問令牌，請使用隨機字符串 JWT_SECRET=your_jwt_secret_key_here
# 會話配置
# 會話過期時間（小時），默認24小時
SESSION_EXPIRE_HOURS=24
# 最大登錄嘗試次數，超過後需要等待
MAX_LOGIN_ATTEMPTS=5
# 文件上傳配置
# 最大文件上傳大小（MB），默認100MB
MAX_FILE_SIZE_MB=100
# AI功能配置
# 聊天功能配置
AI_CHAT_BASE_URL=https://api.example.com/v1/chat/completions AI_CHAT_API_KEY=your_ai_chat_api_key_here
AI_CHAT_MODEL=gpt-4o-mini
# 圖片生成功能配置 AI_IMAGE_BASE_URL=https://api.example.com/v1/images/generations AI_IMAGE_API_KEY=your_ai_image_api_key_here
AI_IMAGE_MODEL=example-model
# AI功能開關
AI_ENABLED=true
IMAGE_GEN_ENABLED=true
# AI限流配置
# AI聊天請求限制（每分鐘最大請求數）
AI_RATE_LIMIT=10
# 圖片生成請求限制（每分鐘最大請求數）
IMAGE_RATE_LIMIT=5