/wechat-server

微信公众号的后端,为其他系统提供微信登录验证功能

Primary LanguageGoMIT LicenseMIT

微信公众号服务器

用以微信公众号的后端,提供登录验证功能

功能

  • Access Token 自动刷新 & 提供外部访问接口
  • 自定义菜单
  • 登录验证
  • 自定义回复

展示

demo1 demo2

部署

手动部署

  1. GitHub Releases 下载可执行文件或者从源码编译:
    git clone https://github.com/songquanpeng/wechat-server.git
    go mod download
    go build -ldflags "-s -w" -o wechat-server
  2. 运行:
    chmod u+x wechat-server
    ./wechat-server --port 3000 --log-dir ./logs
  3. 访问 http://localhost:3000/ 并登录。初始账号用户名为 root,密码为 123456

更加详细的部署教程参见此处

基于 Docker 进行部署

执行:docker run -d --restart always -p 3000:3000 -v /home/ubuntu/data/wechat-server:/data justsong/wechat-server

数据将会保存在宿主机的 /home/ubuntu/data/wechat-server 目录。

配置

  1. GitHub Releases 下载可执行文件。
  2. 系统本身开箱即用,有一些环境变量可供配置:
    1. REDIS_CONN_STRING: 设置之后,将启用 Redis。
      • 例如:REDIS_CONN_STRING=redis://default:redispw@localhost:49153
    2. SESSION_SECRET:设置之后,将使用给定会话密钥。
      • 例如:SESSION_SECRET=random_string
    3. SQL_DSN: 设置之后,将使用目标数据库而非 SQLite。
      • 例如:SQL_DSN=root:123456@tcp(localhost:3306)/gofile
  3. 运行:
    1. chmod u+x wechat-server
    2. ./wechat-server --port 3000
  4. 初始账户用户名为 root,密码为 123456,记得登录后立刻修改密码。
  5. 前往微信公众号配置页面 -> 设置与开发 -> 基本配置获取 AppID 和 AppSecret,并在我们的配置页面填入上述信息,另外还需要配置 IP 白名单,按照页面上的提示完成即可。
  6. 前往微信公众号配置页面 -> 设置与开发 -> 基本配置填写以下配置:
    1. URL 填:https://<your.domain>/api/wechat
    2. Token 首先在我们的配置页面随便填写一个 Token,然后在微信公众号的配置页面填入同一个 Token 即可。
    3. EncodingAESKey 点随机生成,然后在我们的配置页面填入该值。
    4. 消息加解密方式选择明文模式。
  7. 之后保存设置并启用设置。
  8. 当前版本需要重启服务才能应用配置信息,因此请重启服务。

API

获取 Access Token

  1. 请求方法:GET
  2. URL:/api/wechat/access_token
  3. 无参数,但是需要设置 HTTP 头部:Authorization: <token>

通过验证码查询用户 ID

  1. 请求方法:GET
  2. URL:/api/wechat/user?code=<code>
  3. 需要设置 HTTP 头部:Authorization: <token>

注意

需要将 <token><code> 替换为实际的内容。