Sign inSign up

zp29/panx-wechat-service

By zp29

•Updated 7 months ago

Image
0

2.1K

zp29/panx-wechat-service repository overview

⁠PanX 企业微信服务 - 快速部署指南

⁠🚀 一键部署(推荐)

⁠步骤 1: 准备部署文件

下载以下文件到你的服务器:

  1. docker-compose.prod.yml - Docker 编排文件
  2. .env.prod - 环境变量配置模板
# 创建项目目录
mkdir panx-wechat-service
cd panx-wechat-service

# 下载部署文件
wget https://raw.githubusercontent.com/zp29/panx/refs/heads/master/services/wechat-service/docker-compose.prod.yml
wget https://raw.githubusercontent.com/zp29/panx/refs/heads/master/services/wechat-service/.env.example

# 拉取 Docker 镜像
docker pull zp29/panx-wechat-service:latest
⁠步骤 2: 配置环境变量
# 复制配置模板
cp .env.prod .env

# 编辑配置文件
vim .env

必需配置项:

# 企业微信配置
WECHAT_CORP_ID=你的企业ID
WECHAT_CORP_SECRET=你的应用密钥
WECHAT_AGENT_ID=你的应用ID
WECHAT_TOKEN=你的Token
WECHAT_ENCODING_AES_KEY=你的EncodingAESKey

# FRP 隧道配置
FRP_SERVER_ADDR=你的FRP服务器IP
FRP_TOKEN=你的FRP认证令牌

# 代理服务器配置
PROXY_HOST=你的代理服务器IP
⁠步骤 3: 一键部署
mv docker-compose.prod.yml docker-compose.yml
docker-compose up -d
⁠步骤 4: 验证部署
# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs -f wechat-service

# 测试服务接口
curl http://localhost:3001/

# 发送测试消息
curl -X POST http://localhost:3001/api/v1/wechat/send \
  -H "Content-Type: application/json" \
  -d '{"content":"部署测试消息"}'

⁠🔧 常用操作

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

⁠📊 企业微信配置

在企业微信管理后台配置:

  1. 回调URL: http://你的FRP服务器IP:2211/api/v1/wechat/callback
  2. Token: 与 .env 文件中的 WECHAT_TOKEN 一致
  3. EncodingAESKey: 与 .env 文件中的 WECHAT_ENCODING_AES_KEY 一致

⁠🔍 故障排除

⁠服务无法启动
# 检查配置
cat .env

# 查看详细日志
docker-compose logs wechat-service

# 检查端口占用
netstat -tlnp | grep 3001

# 重启服务
docker-compose restart
⁠FRP 连接失败
# 测试 FRP 服务器连通性
telnet 你的FRP服务器IP 7000

# 检查 FRP 配置
grep FRP .env

# 查看 FRP 相关日志
docker-compose logs wechat-service | grep FRP
⁠消息发送失败
# 测试获取 Token
curl http://localhost:3001/api/v1/wechat/token

# 检查企业微信配置
grep WECHAT .env

# 查看消息发送日志
docker-compose logs wechat-service | grep -i send

⁠📁 目录结构

部署完成后的目录结构:

panx-wechat-service/
├── docker-compose.yml         # Docker 编排文件
├── .env                       # 环境变量配置
├── logs/                      # 应用日志目录
└── mysql_data/               # 数据库数据目录(如果启用)

⁠🔄 更新服务

# 拉取最新镜像
docker-compose pull

# 重启服务
docker-compose up -d

⁠💡 提示

  1. 安全性: 生产环境请修改默认密码
  2. 备份: 定期备份 .env 文件和数据库数据
  3. 监控: 建议配置日志监控和告警
  4. 防火墙: 确保必要端口已开放(3001, 7000, 2211)

⁠📞 支持

如有问题,请查看:

  1. 项目主 README.md 文档
  2. 容器日志:docker-compose logs wechat-service
  3. GitHub Issues

Tag summary

Content type

Image

Digest

sha256:a4cd1ebbd…

Size

82.4 MB

Last updated

7 months ago

docker pull zp29/panx-wechat-service