笔者日常感觉跨设备传文件，不光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
部署代码如下：
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，创建新的应用程序。
使用一览
按照上文部署，浏览器输入NAS_IP:3000即可访问服务。密码就是环境文档中的123456。
可以发送各式各样的文件。图片类会有预览，但是文本类无法保留格式，大家可以选择写成txt文本格式再进行传输。
右下角的加号，可以启用一些进阶功能，例如AI等。也支持手机快速拍照传输。
支持历史记录搜索。
上传的文件类内容会存储在/share/Container/wxchat/uploads目录下，聊天框内删除消息这里也会同步销毁。
最后
有需求的朋友可以部署用起来。
感谢观看，本文完。
评论区