Sign inSign up

qcby/qcby-vxcode

By qcby

•Updated 19 days ago

vx code 获取

Image
API management
3

8.3K

qcby/qcby-vxcode repository overview

⁠Qcby VxCode

Wechat 小程序 Code 可视化管理面板

AMD64架构支持全功能协议(car、iPad等)ARM架构仅支持YYB协议

⁠快速安装

交互式一键安装：

curl -fsSL https://cdn.jsdelivr.net/gh/Qcby/QcbyScript@code/install.sh | bash

非交互一键安装（默认端口 8110，安装 latest 最新版本）：

curl -fsSL https://cdn.jsdelivr.net/gh/Qcby/QcbyScript@code/install.sh | bash -s -- install 8110 latest

⁠镜像地址

qcby/qcby-vxcode:latest 和 qcby/qcby-vxcode:<版本号> 已支持多架构。

  • AMD64 / x86_64 服务器会自动拉取 AMD 版
  • ARM64 / aarch64 服务器会自动拉取 ARM 版

例如发布 1.0.4 时，直接使用 qcby/qcby-vxcode:1.0.4 即可，Docker 会按服务器架构自动选择对应镜像。

最新版本：

docker pull qcby/qcby-vxcode:latest

指定版本：

docker pull qcby/qcby-vxcode:<版本号>

⁠默认端口

服务容器端口推荐映射
后台/API81108110:8110

安装完成后访问：

http://服务器IP:8110/

首次打开会自动进入后台初始化页面，请先设置管理员账号、密码和安全码。

⁠一、全新安装

适合第一次安装，没有旧容器的情况。

⁠1. 拉取镜像

最新版本（自动匹配 AMD / ARM）：

docker pull qcby/qcby-vxcode:latest

指定版本（自动匹配 AMD / ARM）：

docker pull qcby/qcby-vxcode:<版本号>
⁠2. 创建网络和数据卷
docker network create qcby-net 2>/dev/null

docker volume create qcby-vxcode-data
docker volume create qcby-redis-data
⁠3. 启动 Redis
docker run -d \
  --name qcby-redis \
  --network qcby-net \
  -v qcby-redis-data:/data \
  --restart always \
  redis:7-alpine redis-server --appendonly yes
⁠4. 启动 Qcby VxCode
docker run -d \
  --name qcby-vxcode \
  --network qcby-net \
  -p 8110:8110 \
  -v qcby-vxcode-data:/app/data \
  -v /sys:/host-sys:ro \
  -v /etc/machine-id:/host-etc/machine-id:ro \
  -e REDIS_ADDR=qcby-redis:6379 \
  --restart always \
  qcby/qcby-vxcode:latest
⁠5. 打开后台
http://服务器IP:8110/
⁠Docker Compose 安装方法

也可以使用 docker compose 安装，创建 docker-compose.yml：

services:
  redis:
    image: redis:7-alpine
    container_name: qcby-redis
    command: redis-server --appendonly yes
    volumes:
      - qcby-redis-data:/data
    restart: always

  qcby-vxcode:
    # latest 已支持多架构，会自动匹配 AMD / ARM
    image: qcby/qcby-vxcode:latest
    container_name: qcby-vxcode
    depends_on:
      - redis
    ports:
      - "8110:8110"
    volumes:
      - qcby-vxcode-data:/app/data
      - /sys:/host-sys:ro
      - /etc/machine-id:/host-etc/machine-id:ro
    environment:
      REDIS_ADDR: redis:6379
    restart: always

volumes:
  qcby-vxcode-data:
  qcby-redis-data:

启动：

docker compose up -d

⁠二、升级安装

适合已经安装过旧版本，只更新业务容器的情况。

升级不会删除 Redis，也不会删除 qcby-vxcode-data 数据卷，后台配置和已保存数据会保留。

⁠1. 拉取最新镜像

最新版本（自动匹配 AMD / ARM）：

docker pull qcby/qcby-vxcode:latest

指定版本（自动匹配 AMD / ARM）：

docker pull qcby/qcby-vxcode:<版本号>
⁠2. 删除旧业务容器
docker rm -f qcby-vxcode
⁠3. 启动新业务容器
docker run -d \
  --name qcby-vxcode \
  --network qcby-net \
  -p 8110:8110 \
  -v qcby-vxcode-data:/app/data \
  -v /sys:/host-sys:ro \
  -v /etc/machine-id:/host-etc/machine-id:ro \
  -e REDIS_ADDR=qcby-redis:6379 \
  --restart always \
  qcby/qcby-vxcode:latest

⁠三、常用命令

⁠查看容器状态
docker ps
⁠查看业务日志
docker logs -f qcby-vxcode
⁠查看 Redis 日志
docker logs -f qcby-redis
⁠重启业务容器
docker restart qcby-vxcode
⁠重启 Redis
docker restart qcby-redis

⁠四、忘记后台密码

如果忘记后台管理员账号或密码，可以在服务器终端执行：

docker exec qcby-vxcode sh -c 'rm -f /app/data/admin_auth.json' && docker restart qcby-vxcode

然后重新打开后台：

http://服务器IP:8110/

重新设置管理员账号、密码和安全码即可。

⁠五、数据说明

数据保存位置
后台配置/鉴权数据qcby-vxcode-data:/app/data
Redis 数据qcby-redis-data:/data

请不要随意删除数据卷，否则可能导致配置、登录状态或缓存数据丢失。

⁠六、注意事项

⁠后台 /admin 入口说明

后台带管理员鉴权。首次打开：

http://服务器IP:8110/admin/

第一次进入会要求设置：

  • 管理员账号
  • 管理员密码
  • 安全码

设置完成后，后续请使用带安全码的地址进入后台登录页：

http://服务器IP:8110/admin/你的安全码

例如安全码是 123：

http://服务器IP:8110/admin/123

登录成功后会自动进入：

http://服务器IP:8110/admin/

如果直接访问 /admin/，未登录或登录过期时会返回 404。

⁠/mywc 获取小程序 Code 接口

/mywc 用于通过 wxid 和 appId 获取小程序 Code 方便第三方程序直接调用。

请求格式：

http://服务器IP:8110/mywc?wxid=你的wxid&appId=小程序AppID

示例：

http://服务器IP:8110/mywc?wxid=wxid_xxxxxxxx&appId=wxa28c31d4ffxxxx

成功返回示例：

{
  "err": 0,
  "msg": "success",
  "appId": "wxa28c31d4ffxxxxxx",
  "status": "ok",
  "code": "0e108Xll2S1FWh4csNlxxxxxx",
  "codeType": "short_code",
  "codeLength": 32,
  "timestamp": 1782467484
}
⁠/mybs 修改步数接口

/mybs 用于通过 wxid 修改微信步数，num 最大支持 98000。

请求格式：

http://服务器IP:8110/mybs?wxid=你的wxid&num=步数

示例：

http://服务器IP:8110/mybs?wxid=wxid_xxxxxxxx&num=12345

成功返回示例：

{
  "err": 0,
  "msg": "success",
  "wxid": "wxid_xxxxxxxx",
  "num": 12345,
  "status": "ok",
  "data": {},
  "timestamp": 1782467484
}
⁠/mysjh 获取手机号接口

/mysjh 用于通过应用宝协议账号 openid 和 appId 获取手机号。

请求格式：

http://服务器IP:8110/mysjh?wxid=你的openid&appId=小程序AppID

示例：

http://服务器IP:8110/mysjh?wxid=owNAX6vf***************&appId=wxa28c31d4f*******

成功返回示例：

{
  "err": 0,
  "msg": "success",
  "wxid": "owNAX6vf06tD********",
  "appId": "wxa28c31d4f**********",
  "status": "ok",
  "data": {},
  "timestamp": 1782467484
}
⁠/myyhs 调用云函数接口

/myyhs 用于 POST 调用云函数，统一封装 VX 和应用宝协议。

  • 可传 protocol 指定：vx 或 yyb
  • 不传 protocol 时，wxid/openid 为 28 位默认按 yyb，其他默认按 vx
  • data 不传时会使用默认云函数查询参数

请求地址：

http://服务器IP:8110/myyhs

请求示例：

curl -X POST "http://服务器IP:8110/myyhs" \
  -H "Content-Type: application/json" \
  -d '{
    "wxid": "wxid_xxxxxxxx",
    "appId": "wxa28c31d4f*****",
    "protocol": "vx",
    "data": {
      "api_name": "qbase_commapi",
      "data": {
        "qbase_api_name": "tcbapi_get_cloudbase_info",
        "qbase_req": "{}"
      },
      "operate_directly": false
    }
  }'

成功返回示例：

{
  "err": 0,
  "msg": "success",
  "wxid": "wxid_xxxxxxxx",
  "appId": "wxa28c31d4ff7********",
  "protocol": "vx",
  "status": "ok",
  "data": {},
  "timestamp": 1782467484
}
⁠其它说明
  • 依赖宿主机系统，启动时保留下面两个只读挂载：
-v /sys:/host-sys:ro
-v /etc/machine-id:/host-etc/machine-id:ro
  • 如果服务器有防火墙，请放行端口：
8110

⁠项目地址

https://hub.docker.com/r/qcby/qcby-vxcode⁠

Tag summary

Content type

Image

Digest

sha256:940fefbf7…

Size

138.6 MB

Last updated

19 days ago

docker pull qcby/qcby-vxcode