lsiodev/gmail-order-bot-dev

lsiodev/gmail-order-bot

!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png

Gmail-order-bot - 一个利用Gmail账户作为订单消息服务的机器人，用于接收来自https://github.com/***-checkout%E7%9A%84%E9%82%AE%E4%BB%B6%E8%AE%A2%E5%8D%95%EF%BC%8C%E5%B9%B6%E5%8F%AF%E4%BD%BF%E7%94%A8%E4%BB%BB%E4%BD%95%E8%87%AA%E5%AE%9A%E4%B9%89%E9%80%BB%E8%BE%91%E8%BF%9B%E8%A1%8C%E5%A4%84%E7%90%86%E3%80%82

!gmail-order-bot

镜像概述

LinuxServer.io团队提供的此容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6 overlay的自定义基础镜像
• 每周基础操作系统更新，整个LinuxServer.io生态系统共享公共层，以最小化空间使用、停机时间和带宽
• 定期安全更新

支持的架构

我们利用docker manifest实现多平台支持。只需拉取lscr.io/lsiodev/gmail-order-bot:latest即可获取适合您架构的正确镜像，也可以通过标签拉取特定架构的镜像。

此镜像支持的架构：

核心功能

• 从Gmail账户接收和处理订单邮件
• 支持自定义机器人逻辑处理订单
• 自动归档非订单邮件（来自***且具有有效DKIM签名的邮件除外）
• 可配置的循环时间，定期检查新邮件
• 支持环境变量配置和Docker Secrets

使用场景

• 电子商务订单自动化处理
• 订单通知与集成（如发送到***等平台）
• 作为轻量级消息队列处理订单流程
• 开发自定义订单处理逻辑的中间件

配置说明

应用设置

此容器仅供开发人员使用！需要具备JavaScript基础知识和基本Docker技能。

使用前需执行以下设置步骤：

1. 创建一个专用的Gmail账户用于[***]
2. 通过访问[***]"Enable the Gmail API"来启用Gmail API访问
3. 将获取的credentials.json文件保存到将绑定挂载为/config的文件夹中
4. 运行docker run --rm -it -u $(id -u ${USER}):$(id -g ${USER}) -v /path/to/data:/config --entrypoint /config.sh lsiodev/gmail-order-bot
5. 访问提示的URL并输入获取的密钥
6. 使用本说明中的run/compose示例启动容器

Docker部署示例

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  gmail-order-bot:
    image: lscr.io/lsiodev/gmail-order-bot:latest
    container_name: gmail-order-bot
    environment:
      - PUID=1000
      - PGID=1000
      - BOT_NAME=discord
      - LOOP_TIME=60
    volumes:
      - /path/to/data:/config
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=gmail-order-bot \
  -e PUID=1000 \
  -e PGID=1000 \
  -e BOT_NAME=discord \
  -e LOOP_TIME=60 \
  -v /path/to/data:/config \
  --restart unless-stopped \
  lscr.io/lsiodev/gmail-order-bot:latest

参数说明

用户/组标识符

使用卷（-v标志）时，主机操作系统和容器之间可能会出现权限问题，通过指定用户PUID和组PGID可以避免此问题。

确保主机上的任何卷目录都由您指定的相同用户拥有，权限问题将迎刃而解。

要查找您的PUID和PGID，请使用id user命令：

bash
  $ id username
    uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

示例机器人代码

默认包含的***通知机器人示例：

javascript
const Discord = require('discord.js');
const YAML = require('yaml');
const discordtoken = process.env.DISCORD_TOKEN;
const roomid = process.env.DISCORD_ROOM


exports.orderbot = async function(order) {
  return new Promise(resolve => {
    const client = new Discord.Client();
    client.login(discordtoken);
    client.on('ready', async () => {
      delete order.rawpayload
      await client.channels.cache.get(roomid.toString()).send(YAML.stringify(order));
      client.destroy();
      resolve(true)
    })
  });
}

支持信息

• 容器运行时的Shell访问：docker exec -it gmail-order-bot /bin/bash
• 实时监控容器日志：docker logs -f gmail-order-bot
• 容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' gmail-order-bot
• 镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/lsiodev/gmail-order-bot:latest

更新信息

大多数镜像都是静态的、版本化的，需要更新镜像并重新创建容器来更新内部的应用程序。除了一些例外情况（如nextcloud、plex），我们不建议或支持在容器内更新应用程序。

通过Docker Compose更新

• 更新所有镜像：docker-compose pull
• 或更新单个镜像：docker-compose pull gmail-order-bot
• 让compose更新所有必要的容器：docker-compose up -d
• 或更新单个容器：docker-compose up -d gmail-order-bot
• 还可以删除旧的悬空镜像：docker image prune

通过Docker Run更新

• 更新镜像：docker pull lscr.io/lsiodev/gmail-order-bot:latest
• 停止运行中的容器：docker stop gmail-order-bot
• 删除容器：docker rm gmail-order-bot
• 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的/config文件夹和设置将被保留）
• 还可以删除旧的悬空镜像：docker image prune