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功能配置 # 聊天功能配置 # URL参照你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

部署代码如下：

services: wxchat: image: yilan666/wxchat:latest container_name: wxchat restart: always ports: - "3000:3000" volumes: - /share/Container/wxchat/data:/app/data # 数据库 - /share/Container/wxchat/uploads:/app/uploads # 上传存档 env_file: - /share/Container/wxchat/.env

打开威联通的Container Station，创建新的应用程序。