配置说明

Waylay 通过环境变量配置，在 docker-compose.yml 中设置。

环境变量

变量	默认值	说明
BRIDGE_PORT	13000	Bridge WebSocket/HTTP 端口
BRIDGE_HOST	0.0.0.0	Bridge 监听地址
AUTO_LOGIN_QQ	—	快速登录 QQ 号（留空则扫码登录）
QQ_APP_DIR	/opt/QQ/resources/app	QQ 资源目录路径
ONEBOT_WS_PORT	0	OneBot v11 正向 WS 端口（0 = 禁用）
ONEBOT_WS_HOST	0.0.0.0	OneBot v11 监听地址
ONEBOT_WS_REVERSE_URLS	[]	反向 WS URL 列表（JSON 数组）
ONEBOT_TOKEN	—	OneBot v11 鉴权 Token
MILKY_HTTP_PORT	0	Milky 协议 HTTP/WS/SSE 端口（0 = 禁用）
MILKY_HOST	0.0.0.0	Milky 监听地址
MILKY_TOKEN	—	Milky 鉴权 Token
MILKY_WEBHOOK_URLS	[]	Milky Webhook URL 列表（JSON 数组）

配置示例

最小配置（仅正向 WS）

environment:
  - AUTO_LOGIN_QQ=123456789
  - ONEBOT_WS_PORT=3001

反向 WS 连接 Yunzai

environment:
  - AUTO_LOGIN_QQ=123456789
  - ONEBOT_WS_PORT=3001
  - ONEBOT_WS_REVERSE_URLS=["ws://host.docker.internal:2536/OneBotv11"]

Milky 协议

environment:
  - MILKY_HTTP_PORT=8082
  - MILKY_TOKEN=your_secret_token

带鉴权 Token

environment:
  - ONEBOT_WS_PORT=3001
  - ONEBOT_TOKEN=your_secret_token

框架连接时需在 URL 参数或 Authorization 头中携带 Token：

ws://host:3001/?access_token=your_secret_token

或：

Authorization: Bearer your_secret_token

Docker Compose 完整示例

services:
  waylay:
    image: micuks/waylay:latest
    # To build from source instead, comment out 'image' and uncomment 'build':
    # build: .
    container_name: waylay
    hostname: waylay          # 保持设备标识一致，有助于快速登录
    privileged: true
    ports:
      - "13000:13000"
      - "3001:3001"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      - BRIDGE_PORT=13000
      - AUTO_LOGIN_QQ=123456789
      - ONEBOT_WS_PORT=3001
      - ONEBOT_WS_REVERSE_URLS=["ws://host.docker.internal:2536/OneBotv11"]
      - ONEBOT_TOKEN=
    volumes:
      - qq_data:/root/.config/QQ

volumes:
  qq_data:

TIP

host.docker.internal 指向宿主机。如果你的 Bot 框架运行在宿主机上，用这个地址连接。