Memos WeChat Proxy

一个将微信公众号消息转发到 Memos 笔记系统的 Node.js 代理服务。

🚀 快速开始

Docker 部署（推荐）

使用 Docker Compose

# 下载 docker-compose 配置
curl -O https://raw.githubusercontent.com/or6521/memos-wechat-proxy/main/docker-compose.yml

# 在docker-compose.yml中增加配置

# 启动服务
docker-compose up -d

PM2 部署

1. 安装依赖：

npm install
npm run build

2. 使用 PM2 启动：

npm install -g pm2
pm2 start dist/index.js --name memos-wechat-proxy

3. 设置开机启动：

pm2 startup
pm2 save

py源码见memos.py，可自行操作。(py中没有微信accesstoken缓存机制，调试容易超额调用。请注意。)

⚙️ 环境变量配置

变量名	必填	默认值	说明
WECHAT_APPID	✅	-	微信公众号 AppID
WECHAT_APPSECRET	✅	-	微信公众号 AppSecret
WECHAT_TOKEN	✅	-	微信公众号 Token
MEMOS_URL	✅	-	Memos 服务地址
MEMOS_ACCESS_TOKEN	✅	-	Memos 访问令牌
WECHAT_OPEN_ID	❌	all	允许的用户 OpenID
MEMOS_DEFAULT_TAGS	❌	微信	默认标签
FILES_DEL	❌	yes	是否删除临时文件
MESSAGES_SUCCESS	❌	已保存到Memos 🎉	成功消息
MESSAGES_FAILED	❌	保存到Memos失败	失败消息

📱 微信公众号配置

1. 登录微信公众平台
2. 进入「开发」→「基本配置」
3. 服务器地址：http://你的服务器IP:5000/wechat
4. Token：与环境变量中的 WECHAT_TOKEN 一致
5. 消息加解密方式选择「明文模式」

🔧 常用命令

Docker 管理

# 查看服务状态
docker ps

# 查看日志
docker logs memos-wechat-proxy

# 停止服务
docker stop memos-wechat-proxy

# 重启服务
docker restart memos-wechat-proxy

PM2 管理

# 查看服务状态
pm2 status

# 查看日志
pm2 logs memos-wechat-proxy

# 重启服务
pm2 restart memos-wechat-proxy

# 停止服务
pm2 stop memos-wechat-proxy

📖 功能特性

• ✅ 微信公众号消息接收和验证
• ✅ 微信access_token本地缓存机制避免超额调用
• ✅ 支持文本、图片、语音、视频、链接消息
• ✅ 自动上传媒体文件到 Memos
• ✅ 权限控制（按微信 OpenID 过滤）
• ✅ 自动标签管理
• ✅ 定时文件清理

🆘 故障排查

1. 检查服务状态：

   docker ps  # 或 pm2 status

2. 查看日志：

   docker logs memos-wechat-proxy  # 或 pm2 logs memos-wechat-proxy

3. 验证配置：确保所有环境变量正确设置

4. 检查网络：确保可以访问 Memos 服务

📄 许可证

MIT License